Skip to content

FieldRename 转换组件使用说明

组件说明

用于对字段名进行重命名。

典型使用场景

1、统一多数据源的字段命名规范

当从多个数据源读取数据(如 MySQL、Hive、Kafka),同含义的字段名不一致时,用 FieldRename 快速统一命名,避免下游处理因字段名差异出错。比如:

  • MySQL 中的字段是 user_id(下划线命名),Hive 中的同含义字段是 userid(无下划线),合并后统一重命名为 user_id;
  • 业务系统 A 的字段是 ord_no,业务系统 B 的同含义字段是 order_no,同步到数仓前统一重命名为 order_no。

2、适配下游系统的字段名要求

不同存储 / 计算系统对字段名有不同限制或规范,用 FieldRename 调整字段名以满足下游要求。比如:

  • Hive 不支持字段名含特殊字符(如 .、-),将 user.name 重命名为 user_name,order-id 重命名为 order_id;
  • ClickHouse 对字段名大小写敏感,下游要求用大写字段名,将 user_id 重命名为 USER_ID;
  • 下游系统有字段名长度限制,将超长字段名 user_registration_time 重命名为简短的 reg_time。

3、清除字段名的冗余前缀 / 后缀

源数据字段名可能带有冗余的前缀或后缀(如 tbl_user_id、order_no_tmp),用 FieldRename 去除冗余部分,简化字段名,比如:

  • 将 tbl_user_id 重命名为 user_id,order_no_tmp 重命名为 order_no。

4、解决字段名冲突问题

当合并多个数据源的数据时,可能出现不同含义的字段同名的情况,用 FieldRename 重命名冲突字段以区分,比如:

  • 用户表和订单表都有 create_time 字段,合并后将用户表的 create_time 重命名为 user_create_time,订单表的重命名为 order_create_time。

配置项说明

配置名称数据类型是否必填默认值描述
节点名称StringFieldRename当前创建的节点名称,由用户自定义且不可为空。命名可包含字母、数字、下划线。确保唯一性。
节点编码String自动生成当前创建的节点编码,以此标识此组件,由用户自定义且不可为空。命名可包含字母、数字、下划线。确保唯一性。
表匹配方式List正则匹配两种匹配方式:正则匹配、精确匹配。
正则匹配:需要输入正则表达式。
精确匹配:需要选择精确匹配的库.表。
两种匹配方式可以同时选择。

FAQ