本场景介绍如何在数据库传输服务 DTS 控制台创建火山引擎版 PostgreSQL 迁移至火山引擎版 PostgreSQL 任务。

前提条件

• 已创建云数据库 PostgreSQL 版实例、数据库和账号。详细操作，请参见创建实例、创建数据库和账号。

• 创建数据迁移任务之前，请确认源库和目标库的网络连通性与服务可用性。

• 您还可以根据预检查项中的说明，来检查源库和目标库中各迁移对象做相应准备。更多详情，请参见预检查项（PostgreSQL）。

注意事项

• 当未勾选增量迁移时，数据迁移期间请勿在源库实例中写入新的数据，以确保数据的一致性。

• 为实时保障数据的一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。

• 迁移对象选择的粒度为库或表。若迁移对象选择的是表，则其他对象例如视图、触发器、函数或存储过程等，不会被迁移至目标库。

• 若暂时不需要启动迁移任务，您可以在完成迁移对象配置后，单击页面右下角的保存。保存后会跳转回迁移任务列表页，此时任务状态为待启动，您可以在合适的时候再配置迁移任务。配置方法，请参见配置迁移任务。

• 在预检查时，如果选择忽略告警并启动迁移任务，可能会导致数据不一致，带来业务风险。关于预检查的具体说明，请参见预检查项（PostgreSQL）。

• 由于全量数据迁移会并发执行 INSERT 操作，导致目标库的集合产生碎片，因此全量迁移完成后目标库的集合存储空间会比源库的集合存储空间大。

• 为保证数据迁移的性能和迁移任务的稳定性，云数据库 PostgreSQL 的 TRIGGER、RULE、FOREIGN KEY、SEQUENCE 等会在增量迁移结束后才进行迁移。

• 在数据迁移的过程中，若遇到目标库中已存在同主键值或唯一键的情况，DTS 不会保留目标端中冲突的数据，即源端的数据将会覆盖掉目标端的数据。当数据进行冲突覆盖时，如果目标库中存在同名表，可能会导致数据不一致等问题，具体如下所示。建议您通过表名映射的方式、删除或重命名目标库中同名表的方式避免数据不一致等问题降低业务风险。

  • 表结构一致时：迁移的数据将覆盖目标表中与源库主键或唯一键的值相同的记录。

  • 表结构不一致时：可能会导致无法初始化数据，只能迁移部分列数据。

• 当您想通过专线实现数据迁移时，您可以提交工单联系技术人员。

• 结构迁移暂不支持自动迁移 Commemts，需要手动迁移，否则会导致 Comments 的丢失。

使用限制

应用限制

操作限制

• 在库表结构迁移和全量迁移阶段，请勿执行库或表结构变更的 DDL 操作，否则数据迁移任务会失败。

• 当仅执行全量数据迁移时，请勿向源库中写入新的数据，否则将导致源和目标数据不一致。为实时保持数据一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。

数据库最小权限策略

用于数据迁移的账号需具备以下账号权限：

• 源库账号需要具有 superuser 权限，以便于创建逻辑复制槽。

• 目标库账号需要具有创建 schema 权限，如果目标库 schema 权限已存在，则迁移账号需要是目标 schema owner。

支持的 SQL 语句

操作步骤

1. 登录 DTS 控制台。

2. 在顶部菜单栏，选择项目和地域。

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

4. 在迁移任务列表页面，单击创建任务。

5. 在创建迁移任务页面的配置源库及目标库配置向导页面，配置以下参数信息。

   类别	参数	说明
   无	任务名称	（可选）自定义迁移任务名称。命名规则如下： 以字母开头。 长度需在 64 个字符内。 只能包含字母、数字、下划线（_）和中划线（-）。
   	链路规格	按需选择迁移任务的链路规格，当前支持 Compact 和 Standard。 说明 成功创建任务后，不支持修改任务的链路规格。关于链路规格的详细信息，请参见产品规格。
   源库配置	选择已有数据源	您可以按需选择是否使用已录入的实例： 使用已录入实例：单击选择已有数据源，在选择数据源控制面板，从地域下拉列表中选择目标地域，然后选择目标数据源。支持通过数据源名称和 ID 选择数据源。关于数据源的创建方法，请参见数据源管理。 不使用已录入实例：如果不使用已录入的实例，那么您需要配置以下数据库实例信息。
   	实例类型	选择 PostgreSQL。
   	接入方式	选择火山引擎版 PostgreSQL。
   	地域	选择目标实例所属地域。
   	是否跨火山引擎账号	按需选择是否跨账号传输数据，取值如下： 本账号：选择本账号时，表示仅在本账号内实现数据传输。 跨账号：选择跨账号时，表示将实现两个账号间的数据传输。 说明 在进行跨账号传输数据时，您需要通过目标端所在的账号登录数据库传输服务 DTS 控制台。 跨账号进行数据传输前，您需要在源端的主账号内创建 IAM 角色并授权。详细操作，请参见如何授权用户实现跨账号传输数据。
   	跨账号 ID	输入源库所属的火山引擎账号 ID。
   	跨账号角色	输入已授权 DTS 访问跨账号资源的 IAM 角色。
   	PostgreSQL 实例	在下拉列表中选择云数据库版 PostgreSQL 的目标实例。 说明 您也可以通过实例 ID 或名称搜索目标实例。
   	数据库名称	输入数据库名称。
   	数据库账号	输入目标实例的数据库账号。
   	数据库密码	输入目标实例数据库账号对应的密码。
   	测试链接	单击测试链接，验证是否成功连接实例。 当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连接，验证是否可以成功连接实例。具体提示信息如下： 连接认证失败，请检查用户名和密码是否正确：当出现该报错提示时，您需要确认用户名和密码的准确性。 连接认证失败，无法正常创建连接， 请联系客服：当出现该报错提示时，请提交工单联系技术支持。
   目标库配置	选择已有数据源	您可以按需选择是否使用已录入的实例： 使用已录入实例：单击选择已有数据源，在选择数据源控制面板，从地域下拉列表中选择目标地域，然后选择目标数据源。支持通过数据源名称和 ID 选择数据源。关于数据源的创建方法，请参见数据源管理。 不使用已录入实例：如果不使用已录入的实例，那么您需要配置以下数据库实例信息。
   	实例类型	选择 PostgreSQL。
   	接入方式	选择火山引擎版 PostgreSQL。
   	地域	选择目标实例所属地域。
   	PostgreSQL 实例	在下拉列表中选择云数据库版 PostgreSQL 的目标实例。 说明 您也可以通过实例 ID 或名称搜索目标实例。
   	数据库名称	输入数据库名称。
   	数据库账号	输入目标实例的数据库账号。
   	数据库密码	输入目标实例数据库账号对应的密码。
   	测试链接	单击测试链接，验证是否成功连接实例。 当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连接，验证是否可以成功连接实例。具体提示信息如下： 连接认证失败，请检查用户名和密码是否正确：当出现该报错提示时，您需要确认用户名和密码的准确性。 连接认证失败，无法正常创建连接， 请联系客服：当出现该报错提示时，请提交工单联系技术支持。
   无	项目	（可选）从下拉列表中选择该任务所属项目，默认在 default(默认项目) 下。您也可以单击创建新项目，创建新的项目。详细操作，请参见新建项目。 说明 关于如何授予子用户访问指定项目下资源的权限操作步骤，请参见修改项目权限。 成功创建任务后，如果需要修改实例的所属项目，例如将任务从当前项目移入至其他项目，您可以将资源移入指定项目。详细操作，请参见资源移入项目。 项目是一个虚拟的概念，包括一组资源、用户和角色。通过项目可以对一组资源进行统一的查看和管理，并且控制项目内用户和角色对这些资源的权限。
   	标签	（可选）单击添加标签，为实例添加标签，标签可帮您实现云资源的分类、云资源的访问控制、账单与成本分摊等。标签由一个键值对（Key-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者等）对具有相同特征的云资源进行分类，便于筛选和聚合，从而轻松管理云上资源。关于标签的详细信息，请参见标签概述。标签的键值对规则如下： 键 支持任何语言、文字、数字、空格或符号（_.:/=+-@）。 大小写敏感，且长度在 1~128 个字符内。 使用 UTF-8 编码的 Unicode 格式。 不支持设置以 volc: 开头的任何形式的 Key，例如 Volc:、VOLC: 等。 （可选）值 支持任何语言、文字、数字、空格或符号（_.:/=+-@）。 大小写敏感，且长度在 0~256 个字符内。 使用 UTF-8 编码的 Unicode 格式。 说明 单次最多可给任务绑定 20 个标签。单个任务最多可绑定 50 个标签。 同一个资源拥有的标签 Key 不可重复，且一个标签 Key 只有一个值 Value。
   	计费方式	当前仅支持按量计费，您无需选择。 说明 关于计费的详细信息，请参见计费说明。

6. 单击下一步:配置迁移对象。

7. 在配置迁移对象配置向导页面，配置相关参数信息，如下表所示。

   说明

   • 若暂时不需要启动迁移任务，您可以在完成迁移对象配置后，单击页面右下角的保存。

   • 保存后会跳转回迁移任务列表页，此时任务状态为待启动，您可以在合适的时候再配置迁移任务。配置方法，请参见配置迁移任务。

   参数	说明
   迁移类型	按需选择迁移类型，当前支持结构迁移、全量迁移和增量迁移。其中： 若仅需要全量迁移，可同时勾选结构迁移和全量迁移。 若需要进行不停机迁移，可以同时勾选结构迁移、全量迁移和增量迁移。 说明 若未勾选增量迁移，数据迁移期间请勿在源库实例中写入新的数据，以确保数据的一致性。 为实时保障数据的一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。
   迁移对象	在迁移对象区域中勾选需要迁移的对象，您可以在已选择对象区域中确认需要迁移的对象。 说明 迁移对象选择的粒度为库或表。若迁移对象选择的是表，则其他对象例如视图、触发器、函数或存储过程等，不会被迁移至目标库。 为保证数据迁移的性能和迁移任务的稳定性，云数据库 PostgreSQL 的 TRIGGER、RULE、FOREIGN KEY、SEQUENCE 等会在增量迁移结束后才进行迁移。 在已选择对象区域的搜索框内支持模糊搜索，批量删除不需要的目标。
   错误重试时间	在迁移任务中，当源库和目标库断连后导致迁移任务失败时，会立即在指定时间内多次重试连接源库和目标库。取值范围：600~86400，单位：秒(s)。默认值为 600 秒。
   全量迁移速率	按需设置全量迁移速率。防止在迁移速率过高时，影响源库的性能，您可以根据源库和目标库的读写压力情况适当调整以下参数： 每秒迁移的行数：按需开启并设置每秒迁移的行数。默认值 100000，取值范围 1~100000。 每秒迁移的数据量：按需开启并设置每秒迁移的数据量。默认值 25000，取值范围 1~25000，单位 KB。 迁移任务并发数：按需设置迁移任务的并发数。默认值 8，取值范围 8~64。 说明 在迁移类型选择全量迁移时，支持配置该参数。

8. 单击预检查。

9. （可选）当创建的任务已有预检查时，您可以根据以下提示确认是否重新发起预检查，当需要重新发起预检查时，请在是否重新发起预检查对话框，单击确定。

   • 若源端和目标端的数据库实例未做修改，则无需再次发起预检查。

   • 如果修改了源端、目标端的数据库实例信息或迁移任务的参数配置，那么建议您重新发起预检查，否则可能会导致任务启动失败或者任务中断。

10. 在预检查配置向导页面，根据检查结果执行以下操作：

    • 单击预检查结果操作列的详情，查看详细的告警和失败信息，并根据告警或失败信息修改库表后，单击重试。

    • 单击操作列的忽略，忽略本次告警继续启动迁移任务。同时，也可以单击忽略全部，一键忽略全部告警信息。

    说明

    • 选择忽略告警并启动迁移任务，可能导致数据不一致，带来业务风险。

    • 关于预检查的具体说明，请参见预检查项。

11. 在预检查页面右下角，单击确认订单。

12. 在确认订单配置向导页面，再次确认配置信息。阅读《数据库产品和服务条款》并勾选我已阅读并同意《数据库产品和服务条款》，然后单击创建并启动任务。

成功创建数据迁移任务后，您可以返回数据库传输服务 DTS 控制台，在数据迁移任务列表查看数据迁移任务的信息。更多信息，请参见查看迁移任务。

相关 API