数据传输服务 DTS：修改实例参数

前提条件

已创建同步或迁移实例，详情请参见同步方案概览或迁移方案概览中的相关配置文档。

注意事项

• 实例参数只能在模块运行期间修改，模块运行状态可以在控制台任务管理页签中的实例进展查看。

• 为保证实例的稳定，仅支持修改控制台可修改参数页签中开放的参数，未在控制台中呈现的参数不支持修改。

• 请参考可修改参数页签中的可选值、参数类型和描述列，修改参数值。

• 控制台上可修改参数页签中的是否重启列为是的参数提交修改后，DTS会立即重启模块，因此建议您在业务低峰期修改实例参数。

选择实例

数据同步和数据迁移实例修改参数的步骤相似，本操作以修改同步实例的参数为例进行介绍。

1. 进入目标地域的同步任务列表页面（二选一）。

   通过DTS控制台进入

   1. 登录数据传输服务DTS控制台。

   2. 在左侧导航栏，单击数据同步。

   3. 在页面左上角，选择同步实例所属地域。

   通过DMS控制台进入

   说明

   实际操作可能会因DMS的模式和布局不同，而有所差异。更多信息，请参见极简模式控制台和自定义DMS界面布局与样式。

   1. 登录DMS数据管理服务。

   2. 在顶部菜单栏中，选择集成与开发 > 数据传输（DTS） > 数据同步。

   3. 在同步任务右侧，选择同步实例所属地域。

2. 定位至目标实例。

   您可以通过任务名、实例ID、数据库实例ID等进行筛选，方便您查找目标实例。

   

3. 单击目标实例的ID。

修改参数值

1. 选择目标实例，详情请参见选择实例。

2. 进入参数值修改界面。

   您可以根据实际情况，选择进入修改界面。

   说明

   分布式实例需要先在任务管理页面点击全量迁移或增量写入模块，并在子任务详情页签单击对应的子任务。

   • 在参数设置页面中修改参数值。

     在左侧导航栏，单击参数设置。

   • 在任务管理页面中修改参数值。

     1. 在左侧导航栏，单击任务管理。

     2. 在实例进展区域，单击目标参数所属的增量或全量同步模块。

        说明

        结构迁移模块不支持修改参数。

     3. 在模块下方，单击参数设置页签。

3. 修改参数值。

   1. 可选：单击可修改参数页签。

   2. 单击目标参数运行参数值列的。

   3. 在修改参数对话框中修改参数值。

      说明

      由于DTS实例的类型、源和目标库实例的类型、配置实例时选择的同步或迁移类型等不同，实例可修改的参数可能会有差异，请以控制台显示为准，常见参数如下表所示。

      表 1. 常见参数说明

      参数名	模块	说明
      sink.ignore.failed.ddl	增量同步 增量迁移	是否忽略执行失败的DDL，取值为： true（默认值）：执行DDL失败时，任务忽略失败并继续执行。 false：执行DDL失败时，任务失败。
      sink.batch.enable	增量同步 增量迁移	是否以batch（批量提交）的方式发送数据，取值为： true：是，以batch的方式发送数据。 false（默认值）：否，不以batch的方式发送数据。
      source.filter.ddl.enable	增量同步 增量迁移	是否过滤DDL，取值为： true：增量任务过滤DDL并继续执行。 false（默认值）：增量任务正常执行DDL。
      trans.hot.merge.enable	增量同步 增量迁移	是否开启热点合并，取值为： true：开启热点合并。 false（默认值）：不开启热点合并。
      sink.bulk.copy.enable	全量同步 全量迁移	数据写入MySQL、PostgreSQ时是否开启bulk copy模式，取值为： true（默认值）：开启bulk copy模式。 false：关闭bulk copy模式。 说明 需要与sink.worker.type参数配合使用。
      sink.worker.type	全量同步 全量迁移	配置MySQL、PostgreSQL的数据写入模式，取值为： stream（默认值）：使用bulk copy写入模式。 batch：使用PreparedStatement executeBatch写入模式，此时sink.bulk.copy.enable需为false。 说明 需要与sink.bulk.copy.enable参数配合使用。
      sink.batch.size.minimum	全量同步 全量迁移	单次批量写入目标库的记录数，取值为：[0,1024]，默认值为128。
      source.mongodb.id.type.unique	全量同步 全量迁移	源库为MongoDB时，同一个集合内主键_id的数据类型是否唯一，取值为： true：唯一。在全量任务阶段，DTS将不会扫描源库待同步或迁移数据中主键的数据类型。 false（默认值）：不唯一。在全量任务阶段，DTS将扫描源库待同步或迁移数据中主键的数据类型。

   4. 单击确定。

   5. 可选：修改其余目标参数值。

      说明

      单击撤销，并单击提示框的确定，可以撤销本次未提交的所有修改操作。

4. 单击提交参数。

5. 在弹出的提示框中单击确定。

   说明

   目前仅支持立刻生效，并且默认已勾选。

查看参数修改记录

1. 选择目标实例，详情请参见选择实例。

2. 在左侧导航栏，单击参数设置。

3. 单击参数修改历史页签。

4. 选择要查询的时间范围。

   说明

   • 默认选择并展示最近七天的参数修改记录。

   • 选择时间时，左侧为起始时间，右侧为结束时间。

5. 单击确定。

   说明

   只记录提交后的修改参数值的操作。