本文为您介绍如何配置ElasticSearch输出组件。
前提条件
已创建ElasticSearch数据源。具体操作,请参见创建Elasticsearch数据源。
进行ElasticSearch输出组件属性配置的账号,需具备该数据源的同步写权限。如果没有权限,则需要申请数据源权限。具体操作,请参见申请数据源权限。
操作步骤
在Dataphin首页顶部菜单栏,选择研发 > 数据集成。
在集成页面顶部菜单栏选择项目(Dev-Prod模式需要选择环境)。
在左侧导航栏中单击离线集成,在离线集成列表中单击需要开发的离线管道,打开该离线管道的配置页面。
单击页面右上角的组件库,打开组件库面板。
在组件库面板左侧导航栏中需选择输出,在右侧的输入组件列表中找到ElasticSearch组件,并拖动该组件至画布。
单击并拖动目标输入组件的图标,将其连接至当前ElasticSearch输出组件上。
单击ElasticSearch输出组件卡片中的图标,打开ElasticSearch输出配置对话框。
在ElasticSearch输出配置对话框,配置参数。
参数
描述
步骤名称
即ElasticSearch输出组件的名称。Dataphin自动生成步骤名称,您也可以根据业务场景修改。命名规则如下:
仅包含中文、英文字母大小写、下划线(_)和数字。
长度不超过64个字符。
数据源
在数据源下拉列表中,展示所有ElasticSearch类型的数据源,包括您已拥有同步写权限的数据源和没有同步写权限的数据源。
对于没有同步写权限的数据源,您可以单击数据源后的申请,申请数据源的同步写权限。具体操作,请参见申请、续期和交还数据源权限。
如果您还没有ElasticSearch类型的数据源,单击新建,创建数据源。具体操作,请参见创建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)字段信息。
批量添加字段。
单击批量添加。
以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)、分号(;)、点(.)。
列分隔符用于分隔字段名与字段类型,默认英文逗号(,)。
单击确定。
新建输出字段。
单击新建输出字段,根据页面提示填写字段及选择类型。
复制上游字段。
引用上游输入字段作为输出字段。
管理输出字段。
您可以对已添加的字段执行如下操作:
单击拖动字段旁的移动图标,可调换字段所处位置。
单击操作列下的编辑图标,编辑已有的字段。
单击操作列下的删除图标,删除已有的字段。
映射关系
映射关系用于将源表的输入字段和目标表的输出字段映射起来,便于后续进行数据同步。映射关系包括同名映射和同行映射。适用场景说明如下:
同名映射:对字段名称相同的字段进行映射。
同行映射:源表和目标表的字段名称不一致,但字段对应行的数据需要映射。只映射同行的字段。
索引结构
说明仅当查询类型选择为索引且加载策略选择为覆盖数据时,才需配置此项。
支持选择系统默认或复用线上。
复用线上:每次重建索引时复用ElasticSearch已有索引结构。
系统默认:每次重建索引时根据ElasticSearch输出组件配置的输出字段自动生成索引结构。
单击确认,完成ElasticSearch输出组件的属性配置。