本文介绍如何在数据库传输服务 DTS 控制台创建公网自建 PostgreSQL 同步至公网自建 PostgreSQL 任务。
华南 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 地址段。
同步时，如果自建 PostgreSQL 进行重启或者主备切换，将会导致同步任务失败。在同步时如果源库执行了重启操作，同步任务会暂时中断并自动尝试修复。如果任务长时间没恢复，请提交工单联系技术支持。
目前仅支持迁移主库的数据，暂不支持从库数据的同步。
为实时保障数据的一致性，建议选择结构初始化、全量初始化和增量同步。
当前仅支持单向同步，不支持双向同步。
同步对象选择的粒度为库或表。若同步对象选择的是表，则其他对象例如视图、触发器、函数或存储过程等，不会被同步至目标库。
若暂时不需要启动同步任务，您可以在完成同步对象配置后，单击页面右下角的保存。保存后会跳转回同步任务列表页，此时任务状态为待启动，您可以在合适的时候再配置同步任务。配置方法，请参见配置同步任务。
在预检查时，如果选择忽略告警并启动同步任务，可能会导致数据不一致，带来业务风险。关于预检查的具体说明，请参见预检查项（PostgreSQL）。
由于全量数据初始化会并发执行 INSERT 操作，导致目标库的集合产生碎片，因此全量初始化完成后目标库的集合存储空间会比源库的集合存储空间大。
为保证数据同步的性能和同步任务的稳定性，云数据库 PostgreSQL 的 TRIGGER、RULE、FOREIGN KEY、SEQUENCE 等会在增量同步结束后才进行同步。
在数据同步的过程中，若遇到目标库中已存在同主键或唯一键的情况，DTS 不会保留目标端中冲突的数据，即源端的数据将会覆盖掉目标端的数据。当数据进行冲突覆盖时，如果目标库中存在同名表，可能会导致数据不一致或任务失败等问题，具体如下所示。建议您通过表名映射的方式、删除或重命名目标库中同名表的方式避免数据不一致等问题降低业务风险。
表结构一致时：全量同步的数据将覆盖目标表中与源库主键或唯一键的值相同的记录。
表结构不一致时：可能会导致无法初始化数据，只能同步部分列数据或同步失败。
当您想通过专线实现数据同步时，您可以提交工单联系技术人员。
结构初始化暂不支持自动同步 Comments，需要手动同步，否则会导致 Comments 的丢失。
| 类型 | 说明 |
|---|---|
源库 |
|
其他 |
|
在库表结构初始化和全量初始化阶段，请勿执行库或表结构变更的 DDL 操作，否则数据同步任务会失败。
当仅执行全量数据初始化时，请勿向源库中写入新的数据，否则将导致源和目标数据不一致。为实时保持数据一致性，建议选择结构初始化、全量数据初始化和增量数据同步。
用于数据同步的账号需具备以下账号权限：
源库账号需要具有 superuser 权限，以便于创建逻辑复制槽。
目标库账号需要具有创建 schema 权限，如果目标库 schema 权限已存在，则同步账号需要是目标 schema owner。
| 操作类型 | SQL操作语句 |
|---|---|
| DML | INSERT、UPDATE、DELETE |
DDL |
|
登录 DTS 控制台。
在顶部菜单栏，选择项目和地域。
在左侧导航栏，单击数据同步。
在同步任务列表页面，单击创建任务。
在创建同步任务页面的配置源库及目标库配置向导页面，配置以下参数信息。
| 类别 | 参数 | 说明 |
|---|---|---|
无 | 任务名称 | （可选）自定义同步任务名称。命名规则如下：
|
链路规格 | 按需选择同步任务的链路规格，当前支持 Compact 和 Standard。 说明 成功创建任务后，不支持修改任务的链路规格。关于链路规格的详细信息，请参见产品规格。 | |
同步拓扑 | 根据业务需要选择同步拓扑，当前仅支持单向同步。 说明 关于同步拓扑的更多信息，请参见数据同步拓扑。 | |
源库配置 | 选择已有数据源 | 您可以按需选择是否使用已录入的实例：
|
| 实例类型 | 选择 PostgreSQL。 | |
接入方式 | 选择公网自建 PostgreSQL。 说明 在同步公网自建 PostgreSQL 实例时，您需要提前在源端的白名单或安全组策略中，添加 DTS IP 段的访问权限。单击查看 DTS IP 段查看和复制 IP 段。 | |
| 地域 | 选择目标实例所属地域。 | |
| 主机地址 | 输入目标自建实例的主机地址。 | |
| 端口 | 输入目标自建实例的端口号。 | |
| 数据库名称 | 输入数据库名称。 | |
| 数据库账号 | 输入目标实例的数据库账号。 | |
| 数据库密码 | 输入目标实例数据库账号对应的密码。 | |
测试链接 | 单击测试链接，验证是否成功连接实例。
| |
目标库配置 | 选择已有数据源 | 您可以按需选择是否使用已录入的实例：
|
实例类型 | 选择 PostgreSQL。 | |
接入方式 | 选择公网自建 PostgreSQL。 说明 在同步公网自建 PostgreSQL 实例时，您需要提前在源端的白名单或安全组策略中，添加 DTS IP 段的访问权限。单击查看 DTS IP 段查看和复制 IP 段。 | |
| 地域 | 选择目标实例所属地域。 | |
| 主机地址 | 输入目标自建实例的主机地址。 | |
| 端口 | 输入目标自建实例的端口号。 | |
| 数据库名称 | 输入数据库名称。 | |
| 数据库账号 | 输入目标实例的数据库账号。 | |
| 数据库密码 | 输入目标实例数据库账号对应的密码。 | |
测试链接 | 单击测试链接，验证是否成功连接实例。
| |
无 | 项目 | （可选）从下拉列表中选择该任务所属项目，默认在 default(默认项目) 下。您也可以单击创建新项目，创建新的项目。详细操作，请参见新建项目。 |
标签 | （可选）单击添加标签，为实例添加标签，标签可帮您实现云资源的分类、云资源的访问控制、账单与成本分摊等。标签由一个键值对（Key-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者等）对具有相同特征的云资源进行分类，便于筛选和聚合，从而轻松管理云上资源。关于标签的详细信息，请参见标签概述。标签的键值对规则如下：
说明
| |
计费方式 | 按需选择计费方式，当前支持按量计费和包年包月两种计费方式。 说明 关于计费的详细信息，请参见计费说明。 | |
购买时长 | 按需选择包年包月的购买时长。 说明 在计费方式选择包年包月时，支持设置购买时长。 |
单击下一步:配置同步对象。
在配置同步对象配置向导页面，配置相关参数信息，如下表所示。
说明
若暂时不需要启动同步任务，您可以在完成同步对象配置后，单击页面右下角的保存。
保存后会跳转回同步任务列表页，此时任务状态为待启动，您可以在合适的时候再配置同步任务。配置方法，请参见配置同步任务。
| 参数 | 说明 |
|---|---|
同步类型 | 按需选择同步类型，当前支持结构初始化、全量初始化和增量同步。其中：
说明
|
同步对象 | 在同步对象区域中勾选需要同步的对象，您可以在已选择对象区域中确认需要同步的对象。 说明
|
| 错误重试时间 | 在同步任务中，当源库和目标库断连后导致同步任务失败时，会立即在指定时间内多次重试连接源库和目标库。取值范围：600~86400，单位：秒(s)。默认值为 600 秒。 |
全量同步速率 | 按需设置全量同步速率。防止在同步速率过高时，影响源库的性能，您可以根据源库和目标库的读写压力情况适当调整以下参数：
说明 在同步类型选择全量初始化时，支持配置该参数。 |
单击预检查。
（可选）当创建的任务已有预检查时，您可以根据以下提示确认是否重新发起预检查，当需要重新发起预检查时，请在是否重新发起预检查对话框，单击确定。
若源端和目标端的数据库实例未做修改，则无需再次发起预检查。
如果修改了源端、目标端的数据库实例信息或同步任务的参数配置，那么建议您重新发起预检查，否则可能会导致任务启动失败或者任务中断。
在预检查配置向导页面，根据检查结果执行以下操作：
单击预检查结果操作列的详情，查看详细的告警和失败信息，并根据告警或失败信息修改库表后，单击重试。
单击操作列的忽略，忽略本次告警继续启动同步任务。同时，也可以单击忽略全部，一键忽略全部告警信息。
说明
选择忽略告警并启动同步任务，可能导致数据不一致，带来业务风险。
关于预检查的具体说明，请参见预检查项。
在预检查页面右下角，单击确认订单。
根据创建任务的计费类型，选择配置方式：
按量付费
在确认订单配置向导页面，再次确认配置信息。阅读《数据库产品和服务条款》并勾选我已阅读并同意《数据库产品和服务条款》，然后单击创建并启动任务。
包年包月
在确认订单配置向导页面，再次确认配置信息。阅读《数据库产品和服务条款》并勾选我已阅读并同意《数据库产品和服务条款》，然后单击创建并启动任务。
在确认订单信息配置向导页面，确认任务的计费信息。
（可选）单击代金券兑换，在代金券兑换对话框，输入代金券兑换码后单击兑换。
（可选）在代金券区域，按需勾选可用代金券，单次仅支持选中一张，即可抵扣部分费用。也可不使用代金券。
单击下一步。
说明
在支付完成配置向导页面，显示支付成功则任务创建成功。
成功创建数据同步任务后，您可以返回 DTS 控制台，在数据同步任务列表查看数据同步任务的信息。
| API | 描述 |
|---|---|
| CreateTransmissionTask | 调用 CreateTransmissionTask 接口创建数据库传输服务任务。 |
| ModifyTransmissionTask | 调用 ModifyTransmissionTask 接口修改传输任务。 |