⌘CtrlK
Appearance
Replace 转换组件使用说明
组件说明
用于检查指定字段中的字符串值，并将该字段值替换成给定的字符串或与正则表达式匹配的字符串值。
支持按指定的字符串、正则表达式替换目标字段的内容，是处理字符串清洗、格式标准化的常用组件。
典型使用场景
1、字符串内容清洗与标准化
用于修正字段值中的异常字符、统一格式、剔除冗余内容。
- 清除字符串中的特殊符号：用户昵称、商品名称中可能包含 *、#、@ 等无关特殊符号，通过 Replace 剔除；将 user_name 字段中的所有 * 替换为空字符串。
- 统一文本格式：地址字段中存在 省/市/区 和 省-市-区 两种分隔符，统一替换为 省,市,区；将 address 字段中的 / 和 - 全部替换为 ,。
- 修正错误字符：数据录入时的错别字（如 公试 写成 公式）、编码乱码（如 é 对应 é），通过精准替换修正。
2、正则表达式批量替换（复杂匹配）
支持正则表达式替换，可处理更复杂的字符串匹配场景，适合批量清洗有规律的异常内容。
- 脱敏手机号 / 身份证号：将手机号的中间 4 位替换为 （正则匹配 (\d{3})\d{4}(\d{4})，替换为 $1$2）；将身份证号的中间 8 位替换为 ********。
- 提取关键信息并替换：日志字段 log_content 中包含 [INFO] [2025-01-01] xxx 格式，将日期部分替换为 [DATE]，便于后续分类统计。
3、配合其他组件做数据预处理
在数据清洗流程中，Replace 可作为前置步骤，先标准化字段值，再交给 Filter 等组件处理。
- 处理用户反馈内容时，先通过 Replace 将所有换行符 \n、制表符 \t 替换为空格，再过滤掉内容长度小于 5 的无效反馈。
4、全字段值匹配替换（精准修正）
通过配置“替换全部匹配值”，即：is_full_match = true，可实现仅当字段值完全等于旧值时才替换，适合精准修正特定值。
- 订单状态字段 order_status 中，将完全等于 0 的值替换为 UNPAID，避免将 10、20 中的 0 误替换。
配置项说明
| 配置名称 | 数据类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
| 节点名称 | String | 是 | Replace | 当前创建的节点名称，由用户自定义且不可为空。命名可包含字母、数字、下划线。确保唯一性。 |
| 节点编码 | String | 是 | 自动生成 | 当前创建的节点编码，以此标识此组件，由用户自定义且不可为空。命名可包含字母、数字、下划线。确保唯一性。 |
| 表匹配方式 | List | 是 | 正则匹配 | 两种匹配方式：正则匹配、精确匹配。 正则匹配：需要输入正则表达式。 精确匹配：需要选择精确匹配的库.表。 两种匹配方式可以同时选择。 |
| 替换字段 | String | 是 | - | 要替换的字段 |
| 被替换字段值 | String | 是 | - | 将被替换的旧字符串 |
| 替换后的值 | String | 是 | - | 用于替换的新字符串 |
| 使用正则匹配 | String | 否 | 否 | 使用正则表达式进行字符串匹配（可选项：true、false，默认false） |
| 替换第一个匹配值 | String | 否 | - | 是否替换第一个匹配字符串。 仅当使用正则匹配为"是" 时使用。 |