1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.1.9.3 |
|
| 4.2.2.1 | 该功能支持集群环境 SelectDB 数据库支持该功能 |
1.2 应用场景
在管道任务、定时任务的同步任务配置过程中，用户可能会出现期望的字段映射关系与产品中提供的默认映射关系不符的情况。
虽然能在「自动建表」时对目标表单个字段类型进行修改，但是对于定时任务，如果这个映射修改，需要针对此数据源下的多个任务或者是多个节点生效，则需要多次重复配置；对于管道任务，用户一次性会同步几十张几百张表，不可能手动逐个表逐个字段的进行字段的查找和修改。
因此用户希望通过 FDL 能够统一对多个使用同一数据连接的定时任务、管道任务自定义字段类型映射规则。
1.3 功能说明
支持用户自定义字段类型映射规则，并配置生效的数据连接。
「自动建表字段类型映射」、「管道DDL」、「定时任务来源字段变化感知」时，数据连接的自定义映射规则将优先于默认映射规则生效。
1.4 约束限制
1）当前字段映射规则支持的数据源类型为：MySQL、Oracle、SQLServer、PostgreSQL、Greenplum、StarRocks、Doris、SelectDB。
2）「通用配置」仅初始化配置时设置的管理员账号支持设置，不支持分配其他用户使用和管理权限。
3）4.2.2.1 之前版本，该功能不支持集群环境；4.2.2.1 及之后版本，该功能支持集群环境。
2. 功能说明
| 配置项 | 说明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 规则名称 | 定义自定义映射的名称 | ||||||||
| 数据源映射 | 选择来源数据库类型和目标数据库类型 | ||||||||
| 适用数据连接 | 选择满足条件的已经创建的数据连接 | ||||||||
| 字段映射规则 | 可以自由选择来源、目标端字段类型，可以定义源-目标的多个「字段类型映射关系」，可以新增和删除
|
3. 操作步骤
示例用户使用定时任务和管道任务时，源表 MySQL 数据库有部分 char 类型字段。StarRocks 作为目标库时，不支持将 char 字段类型定义为主键，建表时会报错。
用户希望能 StarRocks 中，char 字段默认映射到 varchar 类型，以顺利完成配置并同步数据。
在进行「字段映射规则」配置前需要首先新建数据连接，详情参见：创建并管理数据源
3.1 进行字段映射规则设置
1）点击「管理系统>通用配置」，添加「字段映射规则」。如下图所示：
2）输入规则名称，「数据源映射」中选择来源数据库类型和目标数据库类型，选择之前在平台中创建的有权限的数据连接，并选择需要调整映射的来源端字段类型和目标端字段类型。
「长度或精度」设置项中，可选择设置为「固定值」还是「n的倍数」；若选择「固定值」，需要填入1-65533的整数，若选择「n的倍数」，「n*倍数」需要在1-65533之间。
本文示例中，「长度或精度」设置项中，n 的值范围调整为 1-255，n 的倍数设置为 3。如下图所示：
3.2 效果查看
在数据管道中即可看到同步的数据「表字段映射」中 char 类型字段改为 varchar 类型字段，同时字段长度和精度也按照字段映射规则修改。如下图所示：
在数据开发中即可看到同步的数据「表字段映射」中 char 类型字段改为 varchar 类型字段，同时字段长度和精度也按照字段映射规则修改。如下图所示：
