数据加工

添加同步时间戳

1. 在实时同步任务的“数据加工”的“附加列”页面，单击“选择对象”。
2. 在弹出的对话框中选择需要加工的表对象，单击“确定”。
   图1 对象选择
   

3. 在“数据加工区”区域，填写需要添加的列名、类型、操作类型等信息。
   图2 添加信息
   
   

   • 需要添加规则的列为表中已有列，且不能为主键。
   • 仅支持使用数据类型为时间戳类型（TIMESTAMP）的列作为规则列。

4. 检查无误后，单击“下一步”，进入下一步操作。

添加附加列

1. 在实时同步任务的“数据加工”页面选择“附加列”，对于需要加工的表对象，单击“操作”列的添加。
   图3 附加列
   

2. 在弹出的“添加”对话框中，填选列名、操作类型、字段类型等信息，选择的操作类型不同，需要填写的信息也不同。完成后单击“确定”。
   图4 操作类型
   
   

   • 多对一映射场景下，需要使用数据加工的附加列操作来避免数据冲突。
   • 支持的操作类型有以下几种
     • “默认值”：使用输入的默认值填充新加的列。
     • “以create_time为列”和“以update_time为列”操作会分别使用数据产生时间和修改时间填充新加的列。
     • “表达式”：选择使用concat(_current_database, '@',_current_table) 表达式填充新加的列，暂不支持手动输入表达式。
     • “以serverName@database@table为列”：使用@符号分别拼接serverName、源库的库名、表名填充新加的列，其中serverName为手动输入。
     • “填充值”：选择填充值为新加的列，比如同步时间戳。
   • 支持“批量设置”，将第一个可编辑表的附加列信息应用到此任务中所有可编辑的表。
   • MySQL->GaussDB(for MySQL)同步，单表的列数超过500时， 对该表添加附加列可能会超过列数上限，会导致任务失败。
   • 如果使用serverName@database@table作为附加列，后续在进行数据对比时，目标端将默认使用该附加列作为行比对、内容比对的隐含过滤条件。

3. 检查无误后，单击“下一步”，进入下一步操作。

数据过滤

1. 在“数据加工”页面选择“数据过滤”。
   图5 数据过滤
   

2. 在“对象选择”区域选择需要加工的表对象。
3. 在过滤条件区域，填写过滤条件（只需填写SQL语句的WHERE之后部分，例如id=1）后，单击“校验规则”。
   

   • 每张表仅支持添加一个校验规则。
   • 数据过滤每次最多支持500张表。
   • 过滤表达式不支持使用某种数据库引擎特有的package、函数、变量、常量等写法，须使用通用SQL标准。请直接输入SQL语句中WHERE之后的部分（不包含WHERE和分号，例如：sid > 3 and sname like "G %"），最多支持输入512个字符。
   • 过滤条件填写的SQL语句中，关键字需要用反引号，datatime类型（包含日期和时间）和字符串类型需要用单引号，例如：`update` > '2022-07-13 00:00:00' and age >10、`update` ='abc' 。
   • 过滤条件不支持使用隐式转换规则，请填写正确的数据类型条件。例如Oracle的c列是字符类型varchar2，过滤条件应该设置为 c ＞ '10'，而不是c > 10。
   • 不支持对LOB字段设置过滤条件，如CLOB、BLOB、BYTEA等大字段类型。
   • 不支持库名、表名带有换行符的对象设置过滤规则。
   • 不支持for update等行级锁的语法做过滤条件。
   • 不支持对列名做函数操作，如果使用函数操作可能导致数据不一致。
   • 建议不要对非精确类型字段设置过滤条件，如FLOAT、DECIMAL、DOUBLE等。
   • 建议不要对带有特殊字符的字段设置过滤条件。
   • 不建议使用非幂等表达式或函数作为数据加工条件，如SYSTIMESTAMP，SYSDATE等，因其每次调用返回的结果可能会有差异，导致达不到预期。
   • 任务再编辑时，已经同步的表不支持修改过滤规则。

4. 校验通过后，单击“生成加工规则”，即可在加工规则表格中看到该规则。
5. 检查无误后，单击“下一步”，进入下一步操作。

数据过滤高级设置

如果需要使用关联表查询，可以使用数据加工的高级设置功能。

1. 在实时同步任务的“数据加工”页面选择“数据过滤”。
2. 在“对象选择”区域选择需要加工的表对象。
3. 在过滤条件区域，填写联表查询过滤条件，例如：id1 in (select id from db1.tab1 where id >=3 and id <10)，单击“校验”。
   

   • 每张表仅支持添加一个校验规则。
   • 数据过滤每次最多支持500张表。
   • 过滤表达式不支持使用某种数据库引擎特有的package、函数、变量、常量等写法，须使用通用SQL标准。请直接输入SQL语句中WHERE之后的部分（不包含WHERE和分号，例如：sid > 3 and sname like "G %"），最多支持输入512个字符。
   • 过滤条件不支持使用隐式转换规则，请填写正确的数据类型条件。例如Oracle的c列是字符类型varchar2，过滤条件应该设置为 c ＞ '10'，而不是c > 10。
   • 不支持对LOB字段设置过滤条件，如CLOB、BLOB、BYTEA等大字段类型。
   • 不支持库名、表名带有换行符的对象设置过滤规则。
   • 不支持for update等行级锁的语法做过滤条件。
   • 建议不要对非精确类型字段设置过滤条件，如FLOAT、DECIMAL、DOUBLE等。
   • 建议不要对带有特殊字符的字段设置过滤条件。
   • 不建议使用非幂等表达式或函数作为数据加工条件，如SYSTIMESTAMP，SYSDATE等，因其每次调用返回的结果可能会有差异，导致达不到预期。

4. 校验通过后，单击“生成加工规则”，即可在加工规则表格中看到该规则。
5. 在“高级设置”中设置关联表的“配置条件”和“配置规则”，辅助您进行数据过滤。
   图6 高级设置
   
   1. 在“配置条件”中，根据在3输入的过滤条件，填写关联表的相关信息。

      “库名”、“表名”、“列名”、“主键”、“索引”和“过滤条件”均为必填项。如果该表没有索引，则填写主键。

      “过滤条件”即在3输入的该关联表的过滤条件。

   2. 填写完成，单击“校验规则”。
   3. 校验成功后，单击“生成配置规则”。即可在配置规则表格中看到该规则。

      如果需要进行多张关联表的数据过滤，重复执行5即可。

      

      配置规则支持删除操作。

6. 检查无误后，单击“下一步”，进入下一步操作。

列加工

1. 在实时同步任务的“数据加工”页面选择“列加工”。
2. 在“对象选择”区域选择需要加工的对象。
   图7 列加工
   

3. 单击右侧已选对象的“编辑”。
4. 在“编辑列”中，勾选需要映射的列，填写映射后的“新列名”。
   图8 编辑列
   
   

   • 列加工提供列级的查询、映射和过滤能力。
   • 编辑列名后，目标数据库的列名为修改后的名称。
   • 列映射名不能和原列名或已存在的映射名相同。
   • 不支持库名、表名带有换行符的列进行映射。
   • 任务再编辑时，已经同步的表不支持修改列信息。
   • 只有勾选的列才会被同步。
   • MySQL->MySQL、MySQL->GaussDB(for MySQL)不支持分区表的分区字段进行列映射。
   • GaussDB分区键不可以被过滤。
   • 进行列过滤、列映射的表，增量阶段不支持对表中已过滤或映射的列进行DDL操作。

5. 填写完成后单击“确定”。
6. 检查无误后，单击“下一步”，进入下一步操作。

查看数据过滤

1. 在“实时同步管理”页面任务列表中，选择需要查看数据加工的任务，单击任务名称。
2. 选择“数据加工”页签，查看数据过滤记录。单击右上角的，可刷新数据。

查看列加工

1. 在“实时同步管理”页面任务列表中，选择需要查看的任务，单击任务名称。
2. 选择“同步映射”页签，单击右上角选择列映射，查看列映射记录。单击右上角的，可刷新数据。
   图9 查看列映射