文档中心

数据库传输服务

源为火山引擎版 PostgreSQL

同步至专有网络 PostgreSQL

本文介绍如何在数据库传输服务 DTS 控制台创建火山引擎版 PostgreSQL 同步至专有网络 PostgreSQL 任务。

前提条件

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

按需设置目标端信息，具体如下所示：

在使用 VPN 实现数据同步时，自建数据库所属的本地网络已通过 VPN 网关接入火山引擎。详细操作，请参见搭建云上VPC与云下多数据中心网络互通。

在需要使用专线实现数据同步时，您需要搭建云上单私有网络和云下单数据中心网络连通的专线连接。详细操作，请参见配置专线连接。

当您的实例是通过专有网络连接时，专有网络的子网需要和源端或目标端的数据库有连通，同时为了能让 DTS 可以正常访问专有网络的实例，您需要将该子网网段加入到源端或目标端数据库的白名单或安全组规则中。更多信息，请参见添加 DTS 服务器的 IP 地址段。

已确认源端和目标端的网络连通性与服务可用性。

注意事项

为实时保障数据的一致性，建议选择结构初始化、全量初始化和增量同步。

若您创建的任务为双向同步任务，那么不建议使用序列作为自增 ID，否则可能会导致数据不一致。

同步对象选择的粒度为库或表。若同步对象选择的是表，则其他对象例如视图、触发器、函数或存储过程等，不会被同步至目标库，如需同步其他对象，请创建新的同步任务。

目前仅支持同步主库的数据，暂不支持从库数据的同步。

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

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

在同步过程中，如果源端有 CREATE TABLE、RENAME TABLE 操作，请在配置阶段选择同步对象时，勾选该表所在的整库或该表 RENAME 到的整库，否则新建的表或 RENAME 后的表不会同步到目标端。

在进行 PostgreSQL 同步任务时，PostgreSQL 的源端数据库账号需在源库创建触发器、函数等对象。因此，在同步过程中，请勿修改该账号在源库所创建的触发器、函数、内部表等对象的访问权限。

在数据同步的过程中，若遇到目标库中已存在同主键或唯一键的情况，DTS 不会保留目标端中冲突的数据，即源端的数据将会覆盖掉目标端的数据。当数据进行冲突覆盖时，如果目标库中存在同名表，可能会导致数据不一致或任务失败等问题，具体如下所示。

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

表结构不一致时：可能会导致无法初始化数据，只能同步部分列数据或同步失败。

在创建专有网络数据同步任务的过程中，系统会默认在您选择的私有网络内创建数张网卡，网卡会默认挂载到您选择的子网上。网卡的名称格式为 dts_shuttle_********。

您需确保目标实例在切主后逻辑复制槽的可用性，若不可用，切主后任务将中断且无法恢复，需重新创建一个新的任务。

如果使用火山引擎版 PostgreSQL 数据库的大版本升级功能，升级后可能会导致已有的 PostgreSQL 同步任务中的逻辑复制槽丢失，从而导致 PostgreSQL 同步任务执行失败。如果发生这种情况，需要您重新创建 PostgreSQL 同步任务。

使用限制

应用限制

类型	说明
源端	带宽要求：源端所属的服务器需具备足够出口带宽，否则将影响数据同步的速率。待同步的表需具备主键或唯一非空约束，且字段具有唯一性，否则可能会导致数据不一致。单任务中表的数量建议不超过 2 万，Schema 的数量不超过 50 个。当有大量库表需要同步时，建议拆分为多个任务。待同步对象的数据库或表名不可包含问号（?），否则会导致同步任务失败。如需进行增量同步，WAL 日志的参数要求：需开启 WAL 日志功能，并设置参数 wal_level 为 logical。 WAL 日志至少要保留 24 小时，建议保留 7 天以上的日志，否则 DTS 可能因无法获取日志从而导致任务失败，某些情况下也可能导致数据丢失。
其他	单个同步任务只能同步一个数据库，当有多个数据库需要同步时，您可以为每个数据库配置都配置一个同步任务。在增量数据同步过程中，如果同步对象的粒度是模式（schema），那么需要确保待同步表的表级复制标识 REPLICA IDENTITY 设置为 FULL。如果在待同步的模式中创建了新表或使用了 RENAME 命令重建了待同步的表，那么您需要在向该表写入数据之前执行 ALTER TABLE schema.table REPLICA IDENTITY FULL; 命令。说明执行 ALTER TABLE schema.table REPLICA IDENTITY FULL; 命令时，需将命令中的 schema 和 table 替换成真实的 schema 名和表名。增量数据同步期间，数据库传输服务 DTS 会在源库中创建前缀为 dts_sync_ 的 replication slot 用于复制数据。DTS 会每隔 5~10 分钟自动清理一次历史 replication slot，避免其持续累积占用磁盘空间。说明当释放同步任务或同步任务失败时，DTS 会主动清理 replication slot。如果 RDS PostgreSQL 发生了主备切换，则您需要登录备库手动清理 replication slot。执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据同步。否则全量数据同步时数据库传输服务 DTS 会占用源库和目标库一定读写资源，可能会导致数据库的负载上升。由于全量数据同步会并发执行 INSERT 操作，导致目标库的表产生碎片，因此全量同步完成后目标库的表存储空间会比源库的表存储空间大。同步前请确认源库和目标库字符串的一致性，否则可能会导致预检查失败。

操作限制

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

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

数据库最小权限策略

用于数据同步的账号需具备以下账号权限：

源库账号需要具有 superuser 权限，以便于创建逻辑复制槽。同时，需要心跳表的 SELECT、INSERT、UPDATE 权限。

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

支持的 SQL 语句

操作类型	SQL操作语句
DML	INSERT、UPDATE、DELETE
DDL	CREATE TABLE、ALTER TABLE、DROP TABLE、TRUNCATE TABLE CREATE INDEX、DROP INDEX CREATE SEQUENCE、ALTER SEQUENCE、DROP SEQUENCE DROP RULE CREATE TYPE 说明 TYPE 支持 SHELL、ENUM、RANGE 或 COMPOSITE 类型。

操作步骤

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

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

在同步任务列表页面，单击创建任务。

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

类别	参数	说明
基本信息	任务名称	（可选）自定义同步任务名称。长度需在 256 个字符内。说明若未进行设置，系统将按照命名规则，默认生成一个以 dts- 开头命名的任务。
		链路规格	按需选择同步任务的链路规格，当前支持 Compact、Medium 和 Standard。说明成功创建任务后，不支持修改任务的链路规格。关于链路规格的详细信息，请参见产品规格。
		同步拓扑	根据业务需要选择同步拓扑，支持选择单向同步和双向同步。说明关于同步拓扑的更多信息，请参见数据同步拓扑。当同步拓扑选择双向同步时，不建议使用序列作为自增 ID。
源库配置	选择已有数据源	您可以按需选择是否使用已录入的实例：使用已录入实例：单击选择已有数据源，在选择数据源控制面板，从地域下拉列表中选择目标地域，然后选择目标数据源。支持通过数据源名称和 ID 选择数据源。关于数据源的创建方法，请参见数据源管理。不使用已录入实例：如果不使用已录入的实例，那么您需要配置以下数据库实例信息。
		实例类型	选择 PostgreSQL。
		接入方式	选择火山引擎版 PostgreSQL。
		地域	选择目标实例所属地域。
		是否跨火山引擎账号	按需选择是否跨账号传输数据，取值如下：本账号：选择本账号时，表示仅在本账号内实现数据传输。跨账号：选择跨账号时，表示将实现两个账号间的数据传输。说明在进行跨账号传输数据时，您需要通过目标端所在的账号登录数据库传输服务 DTS 控制台。跨账号进行数据传输前，您需要在源端的主账号内创建 IAM 角色并授权。详细操作，请参见如何授权用户实现跨账号传输数据。
		跨账号 ID	输入源库所属的火山引擎账号 ID。
		跨账号角色	输入已授权 DTS 访问跨账号资源的 IAM 角色。
		PostgreSQL 实例	在下拉列表中选择云数据库版 PostgreSQL 的目标实例。说明您也可以通过实例 ID 或名称搜索目标实例。
		数据库名称	输入数据库名称。
		数据库账号	输入目标实例的数据库账号。
		数据库密码	输入目标实例数据库账号对应的密码。
		测试连接	单击测试连接，验证是否成功连接实例。当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连接，验证是否可以成功连接实例。具体提示信息如下：连接认证失败，请检查用户名和密码是否正确：当出现该报错提示时，您需要确认用户名和密码的准确性。连接认证失败，无法正常创建连接，请联系客服：当出现该报错提示时，请提交工单联系技术支持。
目标库配置	选择已有数据源	您可以按需选择是否使用已录入的实例：使用已录入实例：单击选择已有数据源，在选择数据源控制面板，从地域下拉列表中选择目标地域，然后选择目标数据源。支持通过数据源名称和 ID 选择数据源。关于数据源的创建方法，请参见数据源管理。不使用已录入实例：如果不使用已录入的实例，那么您需要配置以下数据库实例信息。
		实例类型	选择 PostgreSQL。
		接入方式	选择专有网络 PostgreSQL。
		地域	选择私有网络所属地域。
		主机地址	输入目标自建实例的主机地址。说明当前仅支持接入 IPV4 地址，暂不支持接入 IPv 6 地址。
		端口	输入目标自建实例的端口号。
		数据库名称	输入目标自建实例的数据库名称。
		私有网络	从下拉列表中选择目标私有网络，具体如下所示：专线连接：通过专线 CEN 实现数据连通时，选择 CEN 下所属的任意私有网络。 VPN 连接：通过 VPN 实现数据连通时，选择 VPN 网关绑定的私有网络。
		子网	从下拉列表中选择私有网络中的子网。说明在同步专有网络 PostgreSQL 实例时，您需要提前在源端的白名单或安全组策略中，添加子网 IP 段的访问权限。单击查看子网 IP 段查看和复制 IP 段。
		数据库账号	输入目标实例的数据库账号。
		数据库密码	输入目标实例数据库账号对应的密码。
		连接方式	按需选择是否启用加密通信协议，以在客户端与数据库实例之间建立安全连接，防止数据在传输过程中被窃听、篡改或伪造。选项如下：非加密连接：适用于已部署在专有网络环境中的自建 PostgreSQL 实例。此方式存在安全风险，建议仅用于测试环境或受控网络。 SSL 安全连接：推荐用于生产环境，支持连接在 AI 原生数据库管理平台（AIDAP）托管的 PostgreSQL 实例，也可用于已配置 SSL 的自建实例。
		测试连接	单击测试连接，验证是否成功连接实例。当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连接，验证是否可以成功连接实例。具体提示信息如下：连接认证失败，请检查网络是否正常：当出现该报错提示时，请确认网络的连通性。连接认证失败，请检查用户名和密码是否正确：当出现该报错提示时，您需要确认用户名和密码的准确性。连接认证失败，无法正常创建连接，请联系客服：当出现该报错提示时，请提交工单联系技术人员。无效的 IP 地址：当出现该报错提示时，请确认 IP 地址的正确性。专有网络需要子网有 * 个可用 IP，当前私有网络内子网可用 IP 数不足，无法创建任务，请检查私有网络内子网资源：当出现该报错提示时，您需要调整私有网络子网内可用的 IP 数量，以保证目标私有网络内子网内有足够的 IP。
Project 与计费	项目	（可选）从下拉列表中选择该任务所属项目，默认在 default(默认项目) 下。您也可以单击创建新项目，创建新的项目。详细操作，请参见新建项目。说明关于如何授予子用户访问指定项目下资源的权限操作步骤，请参见修改项目权限。成功创建任务后，如果需要修改实例的所属项目，例如将任务从当前项目移入至其他项目，您可以将资源移入指定项目。详细操作，请参见资源移入项目。项目是一个虚拟的概念，包括一组资源、用户和角色。通过项目可以对一组资源进行统一的查看和管理，并且控制项目内用户和角色对这些资源的权限。
		标签	（可选）单击添加标签，为实例添加标签，标签可帮您实现云资源的分类、云资源的访问控制、账单与成本分摊等。标签由一个键值对（Key-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者等）对具有相同特征的云资源进行分类，便于筛选和聚合，从而轻松管理云上资源。关于标签的详细信息，请参见标签概述。标签的键值对规则如下：键支持任何语言、文字、数字、空格或符号（_.:/=+-@）。大小写敏感，且长度在 1~128 个字符内。使用 UTF-8 编码的 Unicode 格式。不支持设置以 volc: 开头的任何形式的 Key，例如 Volc:、VOLC: 等。（可选）值支持任何语言、文字、数字、空格或符号（_.:/=+-@）。大小写敏感，且长度在 0~256 个字符内。使用 UTF-8 编码的 Unicode 格式。说明支持模糊搜索选择已有标签键和标签值。单次最多可给任务绑定 20 个标签。单个任务最多可绑定 50 个标签。同一个资源拥有的标签 Key 不可重复，且一个标签 Key 只有一个值 Value。
		计费方式	按需选择计费方式，当前支持按量计费和包年包月两种计费方式。说明关于计费的详细信息，请参见计费说明。
		购买时长	按需选择包年包月的购买时长。说明在计费方式选择包年包月时，支持设置购买时长，同时您还可以勾选到期自动续费，系统会在任务到期前自动续费。

单击下一步:配置同步对象。

在配置同步对象配置向导页面，配置相关参数信息，如下表所示。

说明

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

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

参数	说明
同步类型	按需选择同步类型，当前支持结构初始化、全量初始化和增量同步。其中：若仅需要全量初始化，可同时勾选结构初始化和全量初始化。若需要进行不停机同步，可以同时勾选结构初始化、全量初始化和增量同步。说明若未勾选增量同步，数据同步期间请勿在源库实例中写入新的数据，以确保数据的一致性。为实时保障数据的一致性，建议选择结构初始化、全量数据初始化和增量数据同步。
同步对象	在同步对象区域中勾选需要同步的对象，您可以在已选择对象区域中确认需要同步的对象。说明若同步对象选择的是表，则相依赖的其他对象例如视图、触发器、函数或存储过程等，需手动勾选同步至目标库，否则在预检查时会有警告提示。为保证数据同步的性能和同步任务的稳定性，云数据库 PostgreSQL 的 TRIGGER、RULE、FOREIGN KEY、SEQUENCE 等会在增量同步结束后才进行同步。筛选删除不需要的目标：在已选择对象区域的搜索框内支持模糊搜索，批量删除不需要的数据库、表等目标。
开启毫秒级延迟监控	按需设置是否开启毫秒级延迟监控。开启后，可实现高精度、全链路、主动式的端到端延迟度量，有效提升监控的稳定性和对网络中断、空闲断流等异常场景的感知能力。说明开启后，DTS 会向源库写入心跳，需要源端账号具备 REPLICATION SLAVE、REPLICATION CLIENT、SELECT、INSERT 和 UPDATE 权限。您也可以在源端手动创建心跳表以开启毫秒级延迟监控功能，操作步骤，请参见手动创建心跳表。源端数据库必须为读写节点，否则预检查不通过。
跳过后置结构同步	当同步类型中选择结构初始化时，DTS 会自动在增量同步结束后同步后置结构，您也可以选择跳过后置结构同步，即 DTS 不同步后置结构。 PostgreSQL 数据库后置结构同步对象包括普通触发器、事件触发器、RULE、互斥约束、外键约束、检查约束、Domain 约束、设置 Sequence 值。是：表示跳过后置结构同步，即 DTS 不同步后置结构对象。否：表示不跳过后置结构同步，即 DTS 同步后置结构对象。说明仅当同步拓扑为单向同步，且迁移类型中包含结构初始化时，才支持配置是否跳过后置结构同步。
错误重试时间	在同步任务中，当源库和目标库断连后导致同步任务失败时，会立即在指定时间内多次重试连接源库和目标库。取值范围：600~86400，单位：秒(s)。默认值为 600 秒。
全量同步速率	按需设置全量同步速率。防止在同步速率过高时，影响源库的性能，您可以根据源库和目标库的读写压力情况适当调整以下参数：每秒同步的行数：按需开启并设置每秒同步的行数。默认值 100000，取值范围 1~100000。每秒同步的数据量：按需开启并设置每秒同步的数据量。默认值 25000，取值范围 1~100000，单位 KB。同步任务并发数：按需设置同步任务的并发数。默认值 8，取值范围 1~64。说明在同步类型选择全量初始化时，支持配置该参数。当同步速率过高时，可能会影响源库性能，请根据源和目标库的读写压力情况适当调整。
自动跳过无权限表	按需选择是否自动跳过超长消息。当消息超出限制时，系统会自动跳过，不会中断任务，但可能会因数据丢失导致业务异常，建议同时配置事件告警规则。详细操作，请参见配置创建事件规则。

单击数据校验配置。

在创建同步任务页面的配置数据校验配置向导页面，配置以下参数信息。

参数	说明
数据校验	选择是否在创建同步任务时直接配置（内置）数据校验功能。开启：（默认）在创建数据同步任务中直接配置数据校验任务。关闭：不在创建数据同步任务中配置数据校验任务。
校验类型	DTS 根据数据库类型和同步类型，自动生成校验类型，且不支持修改。关于校验类型的更多信息，请参见背景信息。
校验对象	选择需要校验的对象，您可以在已选择对象区域中实现以下操作：与同步任务保持一致：需要校验的对象与待同步的对象一致，即校验所有的同步对象。自定义：按需选择需要校验的对象。说明数据校验对象只能在同步对象中选择，即只有 DTS 同步对象才支持数据校验。如果新增了同步对象，数据校验默认不会自动增加对新增对象的校验，如有需要可以手动增加校验对象；如果删除了同步对象，数据校验默认不会自动删除，此时修改校验对象时，则不再支持该对象的校验。
启动设置	配置在同步任务中进行数据校验的时机。自动启动：数据校验任务随同步任务的进度，自动启动数据校验。当全量同步（如有）完成，并且增量同步的延迟时间为 0 时，自动启动数据校验任务。手动启动：数据校验任务不会随同步任务的进度，自动启动数据校验；需要您在合适的时机手动开启数据校验任务。建议您在全量同步（如有）完成，并且增量同步的延迟时间为 0 时，再手动启动数据校验任务，否则数据校验结果可能不准确。
计费类型	目前仅支持按量计费，且不可修改。

单击预检查。

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

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

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

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

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

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

说明

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

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

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

根据创建任务的计费类型，选择配置方式：

按量付费

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

包年包月

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

在确认订单信息配置向导页面，确认任务的计费信息。

（可选）单击代金券兑换，在代金券兑换对话框，输入代金券兑换码后单击兑换。

（可选）在代金券区域，按需勾选可用代金券，单次仅支持选中一张，即可抵扣部分费用。也可不使用代金券。

单击下一步。

说明

在支付完成配置向导页面，显示支付成功则任务创建成功。

成功创建数据同步任务后，您可以返回 DTS 控制台，在数据同步任务列表查看数据同步任务的信息。

API	描述
CreateTransmissionTask	调用 CreateTransmissionTask 接口创建数据库传输服务任务。
ModifyTransmissionTask	调用 ModifyTransmissionTask 接口修改传输任务。