本场景介绍如何在数据库传输服务 DTS 控制台创建公网自建 PostgreSQL 迁移至专有网络 PostgreSQL 任务。
已在公网环境中自行搭建 PostgreSQL 实例和数据库。
按需设置目标端信息，具体如下所示：
在使用 VPN 实现数据迁移时，自建数据库所属的本地网络已通过 VPN 网关接入火山引擎。详细操作，请参见搭建云上VPC与云下多数据中心网络互通。
在需要使用专线实现数据迁移时，您需要搭建云上单私有网络和云下单数据中心网络连通的专线连接。详细操作，请参见配置专线连接。
华南 1（广州）、华北 2（上海）和华北 2（北京）的 DTS 服务器 IP 地址是 221.194.189.0/27,157.148.90.32/27,180.184.132.64/27,61.129.54.64/27,220.196.172.32/27,117.135.143.32/27,220.196.168.32/27,116.132.250.32/27,111.45.13.32/27,125.88.248.32/27,180.153.35.32/27,220.181.65.32/27,220.181.65.64/27。
亚太东南（柔佛）的 DTS 服务器 IP 地址是 101.47.0.32/27,220.181.65.32/27,220.181.65.64/27。
中国香港的 DTS 服务器 IP 地址是 101.47.65.32/28,101.47.65.48/28。
关于 DTS 服务器 IP 地址段的详细信息，请参见添加 DTS 服务器的 IP 地址段。
172.31.0.0/20，华北2（上海）和华北2（北京）子网网段是 192.168.3.0/24，亚太东南（柔佛）子网网段是 192.168.0.0/24，中国香港的子网网段是 192.168.0.0/24。更多信息，请参见添加 DTS 服务器的 IP 地址段。已确认源端和目标端的网络连通性与服务可用性。
（可选）根据预检查项中的说明，检查源端和目标端中各迁移对象。更多详情，请参见预检查项（PostgreSQL）。
当源端为自建 PostgreSQL 时，您需要关注以下信息：
迁移时，如果源端进行主备切换，会导致迁移任务失败。
在迁移时如果源端执行了重启操作，迁移任务会暂时中断并自动尝试修复。如果任务长时间没恢复，请提交工单联系技术支持。
为实时保障数据的一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。
目前仅支持迁移主库的数据，暂不支持从库数据的迁移。
迁移对象选择的粒度为库或表。若迁移对象选择的是表，则其他对象例如视图、触发器、函数或存储过程等，不会被迁移至目标库。
由于全量数据迁移会并发执行 INSERT 操作，导致目标库的集合产生碎片，因此全量迁移完成后目标库的集合存储空间会比源库的集合存储空间大。
为保证数据迁移的性能和迁移任务的稳定性，源库的 TRIGGER、RULE、FOREIGN KEY、SEQUENCE 等会在增量迁移结束后才进行迁移。
在预检查时，如果选择忽略告警并启动迁移任务，可能会导致数据不一致，带来业务风险。
结构迁移暂不支持自动迁移 Commemts，需要手动迁移，否则会导致 Comments 的丢失。
在创建专有网络数据迁移任务的过程中，系统会默认在您选择的私有网络内创建数张网卡，网卡会默认挂载到您选择的子网上。网卡的名称格式为 dts_shuttle_********。
在数据迁移的过程中，若遇到目标库中已存在同主键值或唯一键的情况，DTS 不会保留目标端中冲突的数据，即源端的数据将会覆盖掉目标端的数据。当数据进行冲突覆盖时，如果目标库中存在同名表，可能会导致数据不一致等问题，具体如下所示。建议您通过表名映射的方式、删除或重命名目标库中同名表的方式避免数据不一致等问题降低业务风险。
表结构一致时：迁移的数据将覆盖目标表中与源库主键或唯一键的值相同的记录。
表结构不一致时：可能会导致无法初始化数据，只能迁移部分列数据。
| 类型 | 说明 |
|---|---|
源端 |
|
其他 |
|
在库表结构迁移和全量迁移阶段，请勿执行库或表结构变更的 DDL 操作，否则数据迁移任务会失败。
当仅执行全量数据迁移时，请勿向源库中写入新的数据，否则将导致源和目标数据不一致。为实时保持数据一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。
用于数据迁移的账号需具备以下账号权限：
源库账号需要具有 superuser 权限，以便于创建逻辑复制槽。
目标库账号需要具有创建 schema 权限，如果目标库 schema 权限已存在，则迁移账号需要是目标 schema owner。
登录 DTS 控制台。
在顶部菜单栏，选择项目和地域。
在左侧导航栏，单击数据迁移。
在迁移任务列表页面，单击创建任务。
在创建迁移任务页面的配置源库及目标库配置向导页面，配置以下参数信息。
| 类别 | 参数 | 说明 |
|---|---|---|
无 | 任务名称 | （可选）自定义迁移任务名称。命名规则如下：
|
链路规格 | 按需选择迁移任务的链路规格，当前支持 Compact 和 Standard。 说明 成功创建任务后，不支持修改任务的链路规格。关于链路规格的详细信息，请参见产品规格。 | |
源库配置 | 选择已有数据源 | 您可以按需选择是否使用已录入的实例：
|
| 实例类型 | 选择 PostgreSQL。 | |
接入方式 | 选择公网自建 PostgreSQL。 说明 在迁移公网自建 PostgreSQL 实例时，您需要提前在源端的白名单或安全组策略中，添加 DTS IP 段的访问权限。单击查看 DTS IP 段查看和复制 IP 段。 | |
| 地域 | 选择目标实例所属地域。 | |
| 主机地址 | 输入目标自建实例的主机地址。 | |
| 端口 | 输入目标自建实例的端口号。 | |
| 数据库名称 | 输入数据库名称。 | |
| 数据库账号 | 输入目标实例的数据库账号。 | |
| 数据库密码 | 输入目标实例数据库账号对应的密码。 | |
测试链接 | 单击测试链接，验证是否成功连接实例。
| |
目标库配置 | 选择已有数据源 | 您可以按需选择是否使用已录入的实例：
|
实例类型 | 选择 PostgreSQL。 | |
| 接入方式 | 选择专有网络 PostgreSQL。 | |
| 地域 | 选择私有网络所属地域。 | |
| 主机地址 | 输入目标自建实例的主机地址。 | |
| 端口 | 输入目标自建实例的端口号。 | |
| 数据库名称 | 输入目标自建实例的数据库名称。 | |
私有网络 | 从下拉列表中选择目标私有网络，具体如下所示：
| |
子网 | 从下拉列表中选择私有网络中的子网。 说明 在迁移专有网络 PostgreSQL 实例时，您需要提前在源端的白名单或安全组策略中，添加子网 IP 段的访问权限。单击查看子网 IP 段查看和复制 IP 段。 | |
| 数据库账号 | 输入目标实例的数据库账号。 | |
| 数据库密码 | 输入目标实例数据库账号对应的密码。 | |
测试链接 | 单击测试链接，验证是否成功连接实例。
| |
无 | 项目 | （可选）从下拉列表中选择该任务所属项目，默认在 default(默认项目) 下。您也可以单击创建新项目，创建新的项目。详细操作，请参见新建项目。 |
标签 | （可选）单击添加标签，为实例添加标签，标签可帮您实现云资源的分类、云资源的访问控制、账单与成本分摊等。标签由一个键值对（Key-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者等）对具有相同特征的云资源进行分类，便于筛选和聚合，从而轻松管理云上资源。关于标签的详细信息，请参见标签概述。标签的键值对规则如下：
说明
| |
计费方式 | 当前仅支持按量计费，您无需选择。 说明 关于计费的详细信息，请参见计费说明。 |
单击下一步:配置迁移对象。
在配置迁移对象配置向导页面，配置相关参数信息，如下表所示。
说明
| 参数 | 说明 |
|---|---|
迁移类型 | 按需选择迁移类型，当前支持结构迁移、全量迁移和增量迁移。其中：
说明
|
迁移对象 | 在迁移对象区域中勾选需要迁移的对象，您可以在已选择对象区域中确认需要迁移的对象。 说明
说明 在迁移类型选择全量迁移时，支持配置该参数。 ::: |
| 错误重试时间 | 在迁移任务中，当源端和目标端断连后导致迁移任务失败时，会立即在指定时间内多次重试连接源端和目标端。取值范围：600~86400，单位：秒(s)。默认值为 600 秒。 |
单击预检查。
（可选）当创建的任务已有预检查时，您可以根据以下提示确认是否重新发起预检查，当需要重新发起预检查时，请在是否重新发起预检查对话框，单击确定。
若源端和目标端的数据库实例未做修改，则无需再次发起预检查。
如果修改了源端、目标端的数据库实例信息或迁移任务的参数配置，那么建议您重新发起预检查，否则可能会导致任务启动失败或者任务中断。
在预检查配置向导页面，根据检查结果执行以下操作：
单击预检查结果操作列的详情，查看详细的告警和失败信息，并根据告警或失败信息修改库表后，单击重试。
单击操作列的忽略，忽略本次告警继续启动迁移任务。同时，也可以单击忽略全部，一键忽略全部告警信息。
说明
选择忽略告警并启动迁移任务，可能导致数据不一致，带来业务风险。
关于预检查的具体说明，请参见预检查项。
在预检查页面右下角，单击确认订单。
在确认订单配置向导页面，再次确认配置信息。阅读《数据库产品和服务条款》并勾选我已阅读并同意《数据库产品和服务条款》，然后单击创建并启动任务。
成功创建数据迁移任务后，您可以返回数据库传输服务 DTS 控制台，在数据迁移任务列表查看数据迁移任务的信息。更多信息，请参见查看迁移任务。
| API | 描述 |
|---|---|
| CreateTransmissionTask | 调用 CreateTransmissionTask 接口创建数据库传输服务任务。 |
| ModifyTransmissionTask | 调用 ModifyTransmissionTask 接口修改传输任务。 |