如何跳过 DDL

本文为您介绍如何跳过 DDL。

背景信息

对于导致增量同步项目报错的 DDL 语句，您可以通过更新组件配置进行跳过。操作流程如下：

1. 在 error.log 中定位报错的 DDL 语句。

2. 在 ddl_msg.log 中复制 receive ddl 关键字冒号后面的 DDL 语句。

3. 新增或更新参数。

   说明

   • OMS V3.2.2-BP 及之后版本至 V3.3.1 之前版本，需要在 root 下新增或更新 JDBCWriter.coordinatorFile.skipDdl 参数。

   • OMS V3.3.1 及之后版本，需要在 coordinator 下新增或更新 skipDdl 参数。

OMS V3.2.2-BP 及之后版本至 V3.3.1 之前版本

1. 找到源端接收的 DDL 语句。

   1. 登录 OMS 控制台。

   2. 在左侧导航栏，单击 数据迁移。

   3. 在 数据迁移 页面，单击目标数据迁移项目的名称，进入详情页面。

   4. 单击页面右上角的 查看组件监控。

   5. 在 查看组件监控 对话框，单击 组件 后的 查看日志。

   6. 单击 msg/ddl_msg.log 页签，复制 receive ddl 关键字冒号后面的 DDL 语句，该语句是从源端接收到的。

      

2. 更新 JDBCWriter 组件的配置。

   1. 进入 查看组件监控 对话框。

   2. 单击 JDBCWriter 组件后的 更新。

   3. 在 更新配置 对话框，鼠标悬停至 root 参数旁边的空白处，单击添加图标。

   4. 输入需要新增的 Key Name 为 JDBCWriter.coordinatorFile.skipDdl，单击对号。

   5. 在 更新配置 对话框，找到新增的 Key Name，其默认值为 NULL。

   6. 鼠标悬停至新增参数，单击显示的编辑图标，修改参数值为复制的 receive ddl 关键字冒号后面的 DDL 语句。

      OMS 支持参数值中包含换行符，并在 JDBCWriter 组件将 skipDdl 和接收的 DDL 语句中的空格、回车、Tab 和分号去除后进行匹配过滤。

      例如，接收的 DDL 语句为：

      CREATE TABLE my_table (
      id INT,
      name VARCHAR(50)
      );
      

      JDBCWriter.coordinatorFile.skipDdl 参数值匹配为 "CREATE TABLE my_table(id INT,name VARCHAR(50))"。

      如果有多个 DDL 语句想跳过，请使用 & 符号分隔。例如，"CREATE TABLE my_table(id INT,name VARCHAR(50))&create table test(id int not null)"。

   7. 在文本框中输入修改后的参数值后，单击确认图标。

   8. 在 更新配置 对话框，单击 更新。

OMS V3.3.1 及之后版本

1. 找到源端接收的 DDL 语句。

   1. 登录 OMS 控制台。

   2. 在左侧导航栏，单击 数据迁移。

   3. 在 数据迁移 页面，单击目标数据迁移项目的名称，进入详情页面。

   4. 单击页面右上角的 查看组件监控。

   5. 在 查看组件监控 对话框，单击 Incr-Sync 增量同步组件 后的 查看日志。

   6. 单击 msg/ddl_msg.log 页签，复制 receive ddl 关键字冒号后面的 DDL 语句，该语句是从源端接收到的。

      

2. 更新 Incr-Sync 组件的配置。

   注意

   从 OMS 4.0.1 版本开始，JDBCWriter 组件的名称更改为 Incr-Sync，其它操作不变。本文以 Incr-Sync 组件作为示例。

   1. 进入 查看组件监控 对话框。

   2. 单击 Incr-Sync 组件后的 更新。

   3. 在 更新配置 对话框，鼠标悬停至 coordinator 参数旁边的空白处，单击添加图标。

   4. 输入需要新增的 Key Name 为 skipDdl，单击对号。

   5. 在 更新配置 对话框，找到新增的 Key Name，其默认值为 NULL。

   6. 鼠标悬停至新增参数，单击显示的编辑图标，修改参数值为复制的 receive ddl 关键字冒号后面的 DDL 语句。

      OMS 支持关键字匹配，即配置的关键字存在于接收的 DDL 语句中，即可进行匹配过滤。同时，跳过 DDL 语句的配置为 JSON 格式。

      例如，接收的 DDL 语句为：

      CREATE TABLE my_table (
      id INT,
      name VARCHAR(50)
      );
      

      skipDdl 参数值匹配为 ["CREATE TABLE my_table"]。

      如果您需要跳过多个 DDL 语句，请使用 JSON 格式并通过英文逗号（,）分隔。例如，["CREATE TABLE my_table","create table test"]。

      注意

      • 如果 DDL 中包含双引号，请务必添加转义符，否则会报 JSON 解析错误。
        例如，您需要跳过的 DDL 语句为 create table "student" xxx，请配置 skipDdl 参数的值为 ["create table \"student\" xxx"]。

      • 配置参数时，请确保大小写和需要跳过的 DDL 语句一致。

   7. 在文本框中输入修改后的参数值后，单击确认图标。

   8. 在 更新配置 对话框，单击 确定。