---
title: "自定义配置 DML/DDL - OB Cloud 云数据库 master | OceanBase 文档中心"
description: 自定义配置 DML/DDL 本文为您介绍配置数据迁移任务时，如何自定义配置增量同步中的 DDL 和 DML 同步。 背景信息 您在配置数据迁移任务时，如果在 选择类型和对象 步骤选择了 增量同步 ，则会默认支持 DML 同步，您可以自定义配置 DML 或 DDL。 DML 同步：配置数据迁移任务时，您可以对需要同步的…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*qbZXRo_94ZEAAAAAAAAAAAAADiGDAQ/original) OB Cloud 云数据库

# 自定义配置 DML/DDL

更新时间：2026-06-18 11:21:11

本文为您介绍配置数据迁移任务时，如何自定义配置增量同步中的 DDL 和 DML 同步。

## 背景信息

您在配置数据迁移任务时，如果在 **选择类型和对象** 步骤选择了 **增量同步**，则会默认支持 DML 同步，您可以自定义配置 DML 或 DDL。

- DML 同步：配置数据迁移任务时，您可以对需要同步的 DML SQL 语句设置同步策略，只有符合设置条件的 SQL 语句才会被同步至目标端。该功能常用于历史表和交易明细表场景。
 - DDL 同步：配置数据迁移任务时，您可以设置是否同步 DDL。只有设置同步 DDL 后，`CREATE`、`ALTER`、`DROP` 或 `TRUNCATE TABLE` 等 DDL 语句才会被同步至目标端。该功能常用于长期的数据迁移任务，可以显著降低任务运维的成本。

## 使用限制

- DML 同步

     - DML 过滤的作用范围为整个数据迁移任务。
     - 不支持对选择 DML 过滤的数据迁移任务进行全量数据校验。
 - DDL 同步

     - 除支持的增量 DDL 类型外，其它类型均不支持。

      #### 注意

      对于 DDL 语句 `CREATE TABLE`，数据迁移服务仅支持在 `DROP TABLE` 后，使用 `CREATE TABLE` 再创建一个同名的表。目前不支持使用 `CREATE TABLE` 创建新表。
     - 如果需要同步的表涉及不支持的 DDL 类型，数据迁移任务可能会中断并造成数据问题，且无法恢复。
     - 请勿在结构迁移、全量迁移阶段执行库或者表结构变更的 DDL 操作，否则可能导致数据迁移任务中断。

## 操作步骤

1. 将数据迁移任务配置至 **选择类型和对象** 步骤。

   详情请参见 [数据迁移](https://www.oceanbase.com/docs/common-oceanbase-cloud-0000000002418239) 模块相应类型的新建数据迁移任务文档。

   ![migration177-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oceanbase-cloud/migration177-zh.png)
 2. 在 **选择类型和对象** 页面，勾选 **增量同步**，DML 同步处于默认勾选状态。

   ![oms-domestic-128](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oceanbase-cloud/oms-domestic-128.png)
 3. 自定义配置 DML/DDL 同步。

      - 自定义配置 DML 同步

       单击 **增量同步** > **DML 同步** 区域的 **编辑** 图标，在 **DML 同步配置** 对话框，选择需要同步的 DML，单击 **保存**。

            - 通常 DML 同步支持 `insert`、`delete` 和 `update`，您可以根据需要进行过滤。
            - 迁移 Lindorm 和 HBase 数据库的数据至 OceanBase 数据库 HBase API 兼容模式时，DML 同步支持 `put` 和 `delete`。
      - 自定义配置 DDL 同步

       勾选 **DDL 同步** 后，单击显示的 **编辑** 图标。在 **DDL 同步配置** 对话框，选择需要同步的 DDL，单击 **保存**。

       不同类型的数据迁移任务 DDL 同步支持的范围请参见 [DDL 同步范围](https://www.oceanbase.com/docs/common-oceanbase-cloud-0000000002418245)，您可以根据支持的 DDL 同步范围来自定义配置 DDL。

       ![oms-domestic-130](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oceanbase-cloud/oms-domestic-130.png)
 4. 根据提示完成后续的任务配置。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线