文档

配置ElasticSearch输出组件

更新时间:

本文为您介绍如何配置ElasticSearch输出组件。

前提条件

  • 已创建ElasticSearch数据源。具体操作,请参见创建Elasticsearch数据源

  • 进行ElasticSearch输出组件属性配置的账号,需具备该数据源的同步写权限。如果没有权限,则需要申请数据源权限。具体操作,请参见申请数据源权限

操作步骤

  1. 请参见离线管道组件开发入口进入离线单条管道脚本的开发页面。

  2. 按照以下操作指引,进入ElasticSearch输出配置对话框。

    单击组件库->单击输出->拖动ElasticSearch输出组件至画布->连接image图标->单击配置image图标。

    image

  3. ElasticSearch输出配置对话框,配置参数。

    参数

    说明

    步骤名称

    即ElasticSearch输出组件的名称。Dataphin自动生成步骤名称,您也可以根据业务场景修改。命名规则如下:

    • 只能包含汉字、字母、下划线(_)、数字。

    • 不能超过64个字符。

    数据源

    在数据源下拉列表中,展示所有ElasticSearch类型的数据源,包括您已拥有同步写权限的数据源和没有同步写权限的数据源。

    查询类型

    可根据索引(Index)索引别名(Alias)选择写入的索引文档。不同查询类型,需要配置不同配置信息。

    重要

    选择索引别名(Alias),仅支持写入仅指向一个索引的别名,以及设置了is_write_index的别名,否则会导致写入失败。

    • 索引(Index)。

      • 索引文档:Elasticsearch中的index名。

      • 索引文档类型:Elasticsearch中index的type名。

        说明

        索引文档索引文档类型,Elasticsearch6.x 、Elasticsearch7.x版本为必填,Elasticsearch8.x版本为非必填。

    • 索引别名(Alias)。

      • 索引别名:Elasticsearch中的index的别名Alias

      • 索引文档类型:Elasticsearch中index的type名。

    字段分隔符

    非必填项,填写字段之间分隔符。如果您没有填写,则系统自动添加英文逗号(,)作为分隔符。

    加载策略

    选择数据写入目标表的策略。加载策略包括:

    • 覆盖数据即以当前来源表为准,覆盖目标表中的历史数据。

    • 追加数据即在目标表的已有的数据基础上追加数据,且不修改历史数据。

    输入字段

    根据上游的输出,为您展示输入字段。

    输出字段

    为您展示输出字段。

    • 获取字段信息。

      查询类型为索引(Index)时,支持单击获取字段信息,获取所选的索引(Index)字段信息。

    • 批量添加字段。

      1. 单击批量添加

        • 以JSON格式批量配置。示例如下:

          [{"name":"col_integer","type":"integer"},
           {"name":"col_long","type":"long"},
           {"name":"col_double","type":"double"}]
          说明

          name表示引入的字段名称,type表示引入后的字段类型。 例如:"name":"user_id","type":"String" 表示把字段名为user_id的字段引入,设置字段类型为String。

        • 以TEXT格式批量配置,示例如下:

          col_long,long
          col_double,double
          • 行分隔符用于分隔每个字段的信息,默认为换行符(\n),可支持换行符(\n)、分号(;)、点(.)。

          • 列分隔符用于分隔字段名与字段类型,默认英文逗号(,)。

      2. 单击确定

    • 新建输出字段

      单击新建输出字段,根据页面提示填写字段及选择类型

    • 复制上游字段

      引用上游输入字段作为输出字段。

    • 管理输出字段。

      您可以对已添加的字段执行如下操作:

      • 单击拖动字段旁的image移动图标,可调换字段所处位置。

      • 单击操作列下的agag编辑图标,编辑已有的字段。

      • 单击操作列下的agfag删除图标,删除已有的字段。

    映射关系

    映射关系用于将源表的输入字段和目标表的输出字段映射起来,便于后续进行数据同步。映射关系包括同名映射和同行映射。适用场景说明如下:

    • 同名映射:对字段名称相同的字段进行映射。

    • 同行映射:源表和目标表的字段名称不一致,但字段对应行的数据需要映射。只映射同行的字段。

  4. 单击确认,完成ElasticSearch输出组件的属性配置。

  • 本页导读