华为云用户手册

数据库用户权限要求 在使用DRS进行同步时，连接源库和目标库的数据库用户需要满足以下权限要求，才能启动实时同步任务。不同类型的同步任务，需要的用户权限也不同，详细可参考表3进行赋权。DRS会在“预检查”阶段对数据库用户权限进行自动检查，并给出处理建议。 建议创建单独用于DRS任务连接的数据库用户，避免因为数据库用户密码修改，导致的任务连接失败。 连接源或目标数据库的用户密码修改后，请尽快修改DRS任务中的连接信息，避免任务连接失败后自动重试，导致数据库用户被锁定影响使用。 由于 分布式数据库 为源链路需要检查每个DN的连通性，建议使用非root数据库用户进行同步，避免因为密码填写错误在连接DN过程中导致用户被锁定。 表3 数据库用户权限 类型名称 全量同步 增量同步 全量+增量同步 源数据库连接用户 用户具备sysadmin角色或以下最小权限： DATABASE的CONNECT权限、SCHEMA的USAGE权限、表的SELECT或UPDATE权限（无主键表锁表需要UPDATE权限）、SEQUENCE的SELECT权限。 需要具备远程连接权限，添加方法可参考 GaussDB 远程连接配置方法。 用户具备sysadmin角色或以下最小权限： REPLICATION权限或继承了内置角色gs_role_replication的权限、DATABASE的CONNECT权限、SCHEMA的USAGE权限、表的SELECT权限。 需要具备远程连接权限，添加方法可参考GaussDB远程连接配置方法。 需要保证安全组和防火墙策略放开对应连接端口，详细说明可参考GaussDB为源链路增量同步连接及端口说明。 用户具备sysadmin角色或以下最小权限： REPLICATION权限或继承了内置角色gs_role_replication的权限、DATABASE的CONNECT权限、SCHEMA的USAGE权限、表的SELECT或UPDATE权限（无主键表锁表需要UPDATE权限）、SEQUENCE的SELECT权限。 需要具备远程连接权限，添加方法可参考GaussDB远程连接配置方法。 需要保证安全组和防火墙策略放开对应连接端口，详细说明可参考GaussDB为源链路增量同步连接及端口说明。 目标数据库连接用户 用户需要具备DBA角色或者以下最小权限： CREATE SESSION权限，表的SELECT、INSERT权限，或者具备RESOURCE角色。 用户需要具备DBA角色或者以下最小权限： CREATE SESSION权限，表的SELECT、INSERT、UPDATE、DELETE权限，或者具备RESOURCE角色 用户需要具备DBA角色或者以下最小权限： CREATE SESSION权限，表的SELECT、INSERT、UPDATE、DELETE权限，或者具备RESOURCE角色。

数据库账号权限要求 在使用DRS进行同步时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时同步任务。不同类型的同步任务，需要的账号权限也不同，详细可参考表3进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请参考修改连接信息章节修改DRS任务的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。 表3 数据库账号权限 类型名称 全量+增量同步 源数据库连接账号 SELECT、SHOW VIEW、EVENT、LOCK TABLES、RELOAD、REPLICATION SLAVE、REPLICATION CLIENT（或BIN LOG MONIOTOR，MariaDB 10.5及以上版本更改为此权限）。 目标数据库连接账号 SELECT、CREATE、DROP、DELETE、INSERT、UPDATE、ALTER、CREATE VIEW、CREATE ROUTINE、REFEREN CES 、INDEX。

支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考表2。DRS会根据用户选择，在“预检查”阶段对同步对象进行自动检查。 表2 支持的同步对象 类型名称 使用须知 同步对象范围 支持表、主键索引、唯一索引、普通索引、存储过程、视图、函数的同步。 仅支持MyISAM和InnoDB表的同步。 不支持事件、触发器的同步。 相互关联的数据对象要确保同时同步，避免因关联对象缺失，导致同步失败。常见的关联关系：视图引用表、视图引用视图、存储过程/函数/触发器引用视图/表、主外键关联表等。 视图、存储过程、函数依赖的表不支持做表名映射。 任务做表名映射时，不支持该表的外键约束同步。 使用非字母、非数字、非下划线等字符作为库表名称，或库表映射后名称包含中划线、井号时，名称的长度请不要超过42个字符。 已选择的表与未选择的表之间互相rename的DDL操作，在任务同步中会被过滤掉，可能会导致任务失败或数据不一致。 对于一个DDL中存在一个rename的情况（例如：rename A TO B），只支持rename前后库表都在已选择库表中的rename操作（A和B都在已选择库表中），其他情况的rename DDL会被过滤； 对于一个DDL中存在多个rename的情况（例如：rename A TO B, B TO C），只支持rename前后库表都在已选择库表中的部分rename操作 ，其他情况的rename DDL会被过滤（A和B在已选择库表中，C不在，仅执行rename A TO B）。 不建议在多对一同步场景下的进行rename操作，可能会导致任务失败或数据不一致。 同步对象中如果存在包含longtext、longblob类型字段的表，建议创建大规格及以上规格的DRS任务进行同步，否则可能会导致capture OOM。

数据库账号权限要求 在使用DRS进行同步时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时同步任务。不同类型的同步任务，需要的账号权限也不同，详细可参考表2进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请参考修改连接信息章节修改DRS任务的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。 表2 数据库账号权限 类型名称 全量+增量同步 源数据库连接账号 SELECT、SHOW VIEW、EVENT、LOCK TABLES、RELOAD、REPLICATION SLAVE、REPLICATION CLIENT（或BINLOG MONIOTOR，MariaDB 10.5及以上版本更改为此权限）。 目标数据库连接账号 SELECT、CREATE、DROP、DELETE、INSERT、UPDATE、ALTER、CREATE VIEW、CREATE ROUTINE、REFERENCES、INDEX，RDS for MariaDB实例的root账户默认已具备上述权限。

支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考表3。DRS会根据用户选择，在“预检查”阶段对同步对象进行自动检查。 表3 支持的同步对象 类型名称 使用须知 同步对象范围 支持表、主键索引、唯一索引、普通索引、存储过程、视图、函数的同步。 仅支持MyISAM和InnoDB表的同步。 不支持事件、触发器的同步。 视图、存储过程、函数依赖的表不支持做表名映射。 任务做表名映射时，不支持该表的外键约束同步。

数据库账号权限要求 在使用DRS进行同步时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时同步任务。不同类型的同步任务，需要的账号权限也不同，详细可参考表2进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请参考修改连接信息章节修改DRS任务的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。 表2 数据库账号权限 类型名称 全量+增量同步 源数据库连接账号 最少需要具备sysadmin权限，或者view server state权限以及待同步数据库的db_datareader或db_owner权限。 目标数据库连接账号 如果库不存在，需要对库级别开启create any database权限； 如果库存在需要库级别开启connect，create table，alter any schema 和select权限。

支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考表3。DRS会根据用户选择，在“预检查”阶段对同步对象进行自动检查。 表3 支持的同步对象 类型名称 使用须知 同步对象范围 支持的字段类型： TINYINT、SMALLINT、INT、BIGINT、DECIMAL、NUMERIC、FLOAT、REAL、SMALLMONEY、MONEY、BIT、DATE、SMALLDATETIME、DATETIME、DATETIME2、DATETIMEOFFSET、TIME、TIMESTAMP、XML、CHAR、VARCHAR、NCHAR、NVARCHAR、BINARY、VARBINARY、IMAGE、HIERARCHYID、NTEXT、TEXT、UNIQUEIDENTIFIER。 不支持的字段类型：SQL_VARIANT、GEOMETRY、GEOGRAPHY。 全量同步的范围： 支持选中表的表结构、数据和索引。 同步表结构时支持以下函数作为默认值：now、newid、getutcdate、getdate。将这些函数作为default值时，需要目标库也有相同功能的函数。对于目标库不存在对应函数的情况，可能会出现以下结果： 1. 默认值函数可能会被置空。 2. 创建表失败，导致对象对比不一致或者任务失败。 同步对象的库名、表名只能包含如下字符：字母、数字、下划线和中划线，库名长度不能超过64个字符。 同步对象选择的表个数不能超过1000。对于超过1000个表的情况，建议分批次同步（待上一个同步任务结束后，再重新创建任务）。 不支持同步源数据库中开启TDE（Transparent Data Encryption）加密的数据库。若不需要同步TDE加密的库，请在对象选择中去掉；若需要同步TDE加密的库，请先将TDE关闭。 不支持列加密。 针对源数据库自增列场景，全量阶段同步表结构时，源数据库自增列同步到目标端为普通列，同步数据正常; 全量阶段不同步表结构且目标端自建表结构为自增列时，同步数据异常(自增列不允许插入)。 单全量支持同步源端计算列到目标端普通列。 增量同步的范围： 支持DML（Data Manipulation Language）：包括INSERT、UPDATE、DELETE。 不支持DDL（Data Definition Language）。 增量不支持同步源端计算列。

支持的源和目标数据库 表1 支持的数据库 源数据库 目标数据库 本地自建Microsoft SQL Server（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） E CS 自建Microsoft SQL Server数据库（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） 其他云上完全兼容Microsoft SQL Server的数据库（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） RDS for SQL Server（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） RDS for SQL Server（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） 说明： 仅支持目标库大版本等于或高于源库大版本。

注意事项 为保证任务的正常运行，DRS提供了自动化的检查方法，在您启动DRS任务前，会针对源数据库和目标数据库的相关配置、条件进行检查。主要的检查项和对应的处理建议请参考预检查项。除了预检查项目之外，您还需要注意的事情参见表4。 表4 注意事项 类型名称 使用和操作限制 源数据库限制 源数据库如果开启客户端配置中的“强制协议加密（Force Protocol Encrypton）”，必须同时开启“信任服务器证书（trust server certificate）”，如下图1所示： 图1 查看客户端属性 使用限制 通用： 请勿修改源库和目标库的端口号，请勿修改、删除源库和目标库连接用户的密码、权限，否则可能导致任务失败。 请勿在目标库做写入操作，否则可能导致数据不一致。 为保证同步任务正常和数据的一致性，如有以上诉求，建议在业务低峰期时重新创建DRS任务。 全量同步阶段： 请勿在源库执行任何DDL，否则可能导致数据不一致或任务失败。 增量同步阶段： 支持DML（Data Manipulation Language）：包括INSERT、UPDATE、DELETE。 不支持DDL操作，源数据库进行的DDL操作不会同步到目标数据库。 因cdc不记录DDL相关记录，可能会造成数据不一致或任务失败（如源端新增列，cdc不记录新增列相关记录，同步到目标端缺失新增列信息），恢复任务需通过再编辑去掉该表后，目标端清空该表数据后，重新通过再编辑加入该表继续同步。 不支持同步到目标端且会造成任务异常的DDL类型： ALTER TABLE ADD COLUMN ALTER TABLE DROP COLUMN ALTER TABLE ALTER COLUMN DROP TABLE 不支持同步到目标端但不会造成任务异常的DDL类型： CREATE TABLE CREATE INDEX DROP INDEX ALTER INDEX 不支持大数据类型IMAGE、TEXT、NTEXT的删除操作。 不支持DELETE和UPDATE目标端主键类型为BLOB、TEXT、CLOB、NCLOB、BYTEA的表。 单增量任务再编辑增加同步对象时，在子任务变更结束前，不建议对新增同步的表进行DML操作，否则可能导致部分数据无法同步到目标数据库。 同步对比阶段： 建议在源库的业务低峰期进行数据比对，防止误报不一致数据，以及减少对源库和DRS任务的冲击。 在增量同步过程中做对比时，源库如果存在写入，则对比结果可能不一致。 不支持在全量同步过程中做对比。 不支持数据对比过程中做限速。 常见故障排查： 在任务创建、启动、全量同步、增量同步、结束等过程中，如有遇到问题，可先参考“故障排查”章节进行排查。 其他限制 同步表结构时支持以下函数作为默认值：now、newid、getutcdate、getdate。将这些函数作为default值时，需要目标数据库也有相同功能的函数。对于目标数据库不存在对应函数的情况，可能会出现以下结果： 默认值函数可能会被置空。 创建表失败，导致对象对比不一致或者任务失败。 不支持源数据库主备切换，源数据库主备切换会导致同步任务失败。 SQL Server仅支持SQL Server的身份认证模式，不支持Windows身份认证方式。 不支持源数据库Microsoft SQL Server为TLS 1.0、TLS 1.1协议的同步，如果需要同步，建议源库升级到TLS 1.2及以上版本。 不建议在数据库中使用日期类型做主键，因存在精度损失，该特性影响DRS增量场景下对 UPDATE、DELETE语句的同步。 目标数据库为Oracle兼容模式时，会将写入的空字符串作为NULL处理，源数据库存在空字符串且具有非空约束时，会导致写入失败。 DRS全量同步表结构时，目标库存在与某用户名称同名的schema，用其他用户进行同步表结构到schema时，需要使用grant [role] to [role]的方式为此用户赋权，否则可能因为无法创建表结构而导致同步失败。 对象名同步到目标库后会转换成小写，因此选择的源库表中不能存在表名称字母相同但大小写不同的表，否则会导致同步失败。 因为部分SQL Server（例如Azure SQL）不支持use语法，不支持同步多库，所以如果需要同步多库时请创建多个同步任务。 源库中的空字符串写入目标库的结果是空字符串或者null取决于目标库的兼容性处理，例如GaussDB A兼容模式会将空字符串自动转换为null。 Azure SQL数据库，连接策略暂不支持Redirect，如果是Redirect请修改成默认值或者Proxy选项。

数据库账号权限要求 在使用DRS进行同步时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时同步任务。不同类型的同步任务，需要的账号权限也不同，详细可参考表2进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请参考修改连接信息章节修改DRS任务的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。 表2 数据库账号权限 类型名称 全量同步 增量、全量+增量同步 源数据库连接账号 需要具备sysadmin权限，或者待同步数据库的db_datareader或db_owner权限。 需要具备sysadmin权限，或者view server state权限以及待同步数据库的db_datareader或db_owner权限。 目标数据库连接账号 库级权限：需要使用root或其他有sysadmin角色的DATABASE用户登录postgres基库，赋予用户DATABASE的CREATE、CONNECT权限。 SCHEMA级权限：需要使用 root、或其他有sysadmin角色的DATABASE用户、或使用数据库的OWNER用户登录数据库，赋予用户SCHEMA的CREATE、USAGE权限。 表级权限：需要使用 root、或其他有sysadmin角色的DATABASE用户、或使用数据库的OWNER用户登录数据库 ，赋予用户SCHEMA下所有表的SELECT，UPDATE，INSERT和DELETE权限。 目标库使用gsloader等工具创建相关系统表（如 public.pgxc_copy_error_log，public.gs_copy_summary）时，DRS访问相关系统表需要有系统表的all privilege权限，详细信息可参考《GaussDB工具参考》。

支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考表3。DRS会根据用户选择，在“预检查”阶段对同步对象进行自动检查。 表3 支持的同步对象 类型名称 使用须知 同步对象范围 支持的字段类型： TINYINT、SMALLINT、INT、BIGINT、DECIMAL、NUMERIC、FLOAT、REAL、SMALLMONEY、MONEY、BIT、DATE、SMALLDATETIME、DATETIME、DATETIME2、DATETIMEOFFSET、TIME、TIMESTAMP、XML、CHAR、VARCHAR、NCHAR、NVARCHAR、BINARY、VARBINARY、IMAGE、HIERARCHYID、NTEXT、TEXT、UNIQUEIDENTIFIER。 不支持的字段类型：SQL_VARIANT、GEOMETRY、GEOGRAPHY。 全量同步的范围： 支持选中表的表结构、数据和索引。 同步表结构时支持以下函数作为默认值：now、newid、getutcdate、getdate。将这些函数作为default值时，需要目标库也有相同功能的函数。对于目标库不存在对应函数的情况，可能会出现以下结果： 1. 默认值函数可能会被置空。 2. 创建表失败，导致对象对比不一致或者任务失败。 同步对象的库名、表名只能包含如下字符：字母、数字、下划线和中划线，库名长度不能超过64个字符。 同步对象选择的表个数不能超过1000。对于超过1000个表的情况，建议分批次同步（待上一个同步任务结束后，再重新创建任务）。 不支持同步源数据库中开启TDE（Transparent Data Encryption）加密的数据库。若不需要同步TDE加密的库，请在对象选择中去掉；若需要同步TDE加密的库，请先将TDE关闭。 不支持列加密。 全量阶段同步表结构时，源数据库自增列同步到目标端为普通列，不同步自增属性。 单全量支持同步源端计算列到目标端普通列。 增量同步的范围： 支持DML（Data Manipulation Language）：包括INSERT、UPDATE、DELETE。 不支持DDL（Data Definition Language）。 不支持GaussDB的无主键复制表，如果需要同步的表在GaussDB为无主键复制表，会导致任务失败。 增量不支持同步源端计算列。

支持的源和目标数据库 表1 支持的数据库 源数据库 目标数据库 本地自建Microsoft SQL Server（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） ECS自建Microsoft SQL Server数据库（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） 其他云上完全兼容Microsoft SQL Server的数据库（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） RDS for SQL Server（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） GaussDB分布式版（ORA、MYSQL兼容模式。版本数据库内核版本为505.2及以下版本，内核版本与数据库引擎版本的关系请参考云数据库GaussDB的数据库引擎版本说明。）

数据库账号权限要求 在使用DRS进行同步时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时同步任务。不同类型的同步任务，需要的账号权限也不同，详细可参考表2进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请参考修改连接信息章节修改DRS任务的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。 表2 数据库账号权限 类型名称 全量同步 增量、全量+增量同步 源数据库连接账号 需要具备sysadmin权限，或者待同步数据库的db_datareader或db_owner权限。 需要具备sysadmin权限，或者view server state权限以及待同步数据库的db_datareader或db_owner权限。 目标数据库连接账号 库级权限：需要使用root或其他有sysadmin角色的DATABASE用户登录postgres基库，赋予用户DATABASE的CREATE、CONNECT权限。 SCHEMA级权限：需要使用 root、或其他有sysadmin角色的DATABASE用户、或使用数据库的OWNER用户登录数据库，赋予用户SCHEMA的CREATE、USAGE权限。 表级权限：需要使用 root、或其他有sysadmin角色的DATABASE用户、或使用数据库的OWNER用户登录数据库 ，赋予用户SCHEMA下所有表的SELECT，UPDATE，INSERT和DELETE权限。 目标库使用gsloader等工具创建相关系统表（如 public.pgxc_copy_error_log，public.gs_copy_summary）时，DRS访问相关系统表需要有系统表的all privilege权限，详细信息可参考《GaussDB工具参考》。

支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考表3。DRS会根据用户选择，在“预检查”阶段对同步对象进行自动检查。 表3 支持的同步对象 类型名称 使用须知 同步对象范围 支持的字段类型： TINYINT、SMALLINT、INT、BIGINT、DECIMAL、NUMERIC、FLOAT、REAL、SMALLMONEY、MONEY、BIT、DATE、SMALLDATETIME、DATETIME、DATETIME2、DATETIMEOFFSET、TIME、TIMESTAMP、XML、CHAR、VARCHAR、NCHAR、NVARCHAR、BINARY、VARBINARY、IMAGE、HIERARCHYID、NTEXT、TEXT、UNIQUEIDENTIFIER。 不支持的字段类型：SQL_VARIANT、GEOMETRY、GEOGRAPHY。 全量同步的范围： 支持选中表的表结构、数据和索引。 同步表结构时支持以下函数作为默认值：now、newid、getutcdate、getdate。将这些函数作为default值时，需要目标库也有相同功能的函数。对于目标库不存在对应函数的情况，可能会出现以下结果： 1. 默认值函数可能会被置空。 2. 创建表失败，导致对象对比不一致或者任务失败。 同步对象的库名、表名只能包含如下字符：字母、数字、下划线和中划线，库名长度不能超过64个字符。 同步对象选择的表个数不能超过1000。对于超过1000个表的情况，建议分批次同步（待上一个同步任务结束后，再重新创建任务）。 不支持同步源数据库中开启TDE（Transparent Data Encryption）加密的数据库。若不需要同步TDE加密的库，请在对象选择中去掉；若需要同步TDE加密的库，请先将TDE关闭。 不支持列加密。 全量阶段同步表结构时，源数据库自增列同步到目标端为普通列，不同步自增属性。 单全量支持同步源端计算列到目标端普通列。 增量同步的范围： 支持DML（Data Manipulation Language）：包括INSERT、UPDATE、DELETE。 不支持DDL（Data Definition Language）。 增量不支持同步源端计算列。

注意事项 为保证任务的正常运行，DRS提供了自动化的检查方法，在您启动DRS任务前，会针对源数据库和目标数据库的相关配置、条件进行检查。主要的检查项和对应的处理建议请参考预检查项。除了预检查项目之外，您还需要注意的事情参见表4。 表4 注意事项 类型名称 使用和操作限制 源数据库限制 源数据库如果开启客户端配置中的“强制协议加密（Force Protocol Encrypton）”，必须同时开启“信任服务器证书（trust server certificate）”，如下图1所示： 图1 查看客户端属性 使用限制 通用： 请勿修改源库和目标库的端口号，请勿修改、删除源库和目标库连接用户的密码、权限，否则可能导致任务失败。 请勿在目标库做写入操作，否则可能导致数据不一致。 为保证同步任务正常和数据的一致性，如有以上诉求，建议在业务低峰期时重新创建DRS任务。 全量同步阶段： 请勿在源库执行任何DDL，否则可能导致数据不一致或任务失败。 增量同步阶段： 支持DML（Data Manipulation Language）：包括INSERT、UPDATE、DELETE。 不支持DDL操作，源数据库进行的DDL操作不会同步到目标数据库。 因cdc不记录DDL相关记录，可能会造成数据不一致或任务失败(如源端新增列，cdc不记录新增列相关记录，同步到目标端缺失新增列信息)，恢复任务需通过再编辑去掉该表后，目标端清空该表数据后，重新通过再编辑加入该表继续同步。 不支持同步到目标端且会造成任务异常的DDL类型： ALTER TABLE ADD COLUMN ALTER TABLE DROP COLUMN ALTER TABLE ALTER COLUMN DROP TABLE 不支持同步到目标端但不会造成任务异常的DDL类型： CREATE TABLE CREATE INDEX DROP INDEX ALTER INDEX 不支持大数据类型IMAGE、TEXT、NTEXT的删除操作。 不支持DELETE和UPDATE目标端主键类型为BLOB、TEXT、CLOB、NCLOB、BYTEA的表。 单增量任务再编辑增加同步对象时，在子任务变更结束前，不建议对新增同步的表进行DML操作，否则可能导致部分数据无法同步到目标数据库。 同步对比阶段： 建议在源库的业务低峰期进行数据比对，防止误报不一致数据，以及减少对源库和DRS任务的冲击。 在增量同步过程中做对比时，源库如果存在写入，则对比结果可能不一致。 不支持在全量同步过程中做对比。 不支持数据对比过程中做限速。 常见故障排查： 在任务创建、启动、全量同步、增量同步、结束等过程中，如有遇到问题，可先参考“故障排查”章节进行排查。 其他限制 同步表结构时支持以下函数作为默认值：now、newid、getutcdate、getdate。将这些函数作为default值时，需要目标数据库也有相同功能的函数。对于目标数据库不存在对应函数的情况，可能会出现以下结果： 默认值函数可能会被置空。 创建表失败，导致对象对比不一致或者任务失败。 不支持源数据库主备切换，源数据库主备切换会导致同步任务失败。 SQL Server仅支持SQL Server的身份认证模式，不支持Windows身份认证方式。 不支持源数据库Microsoft SQL Server为TLS 1.0、TLS 1.1协议的同步，如果需要同步，建议源库升级到TLS 1.2及以上版本。 不建议在数据库中使用日期类型做主键，因存在精度损失，该特性影响DRS增量场景下对 UPDATE、DELETE语句的同步。 目标数据库为Oracle兼容模式时，会将写入的空字符串作为NULL处理，源数据库存在空字符串且具有非空约束时，会导致写入失败。 DRS全量同步表结构时，目标库存在与某用户名称同名的schema，用其他用户进行同步表结构到schema时，需要使用grant [role] to [role]的方式为此用户赋权，否则可能因为无法创建表结构而导致同步失败。 对象名同步到目标库后会转换成小写，因此选择的源库表中不能存在表名称字母相同但大小写不同的表，否则会导致同步失败。 因为部分SQL Server（例如Azure SQL）不支持use语法，不支持同步多库，所以如果需要同步多库时请创建多个同步任务。 源库中的空字符串写入目标库的结果是空字符串或者null取决于目标库的兼容性处理，例如GaussDB A兼容模式会将空字符串自动转换为null。 Azure SQL数据库，连接策略暂不支持Redirect，如果是Redirect请修改成默认值或者Proxy选项。

支持的源和目标数据库 表1 支持的数据库 源数据库 目标数据库 本地自建Microsoft SQL Server（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） ECS自建Microsoft SQL Server数据库（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） 其他云上完全兼容Microsoft SQL Server的数据库（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） RDS for SQL Server（企业版2012、2014、2016、2017、2019、2022版本，标准版2016 SP2及以上版本、2017、2019、2022版本） GaussDB集中式版（A、B兼容模式。版本数据库内核版本为505.2及以下版本，内核版本与数据库引擎版本的关系请参考云数据库GaussDB的数据库引擎版本说明。）

使用须知 DRS全量+增量同步过程一般包含四个阶段：任务启动阶段、全量阶段、增量阶段、结束任务阶段（单全量任务则包含三个阶段）。为了确保同步各个阶段的平顺，在创建同步任务前，请务必阅读以下使用须知。 表4 使用须知 类型名称 使用和操作约定 任务启动前须知 源数据库参数要求： 源数据库的分区表触发器不可以设置为disable。 全量同步支持源库备机状态，但需要设置hot_standby_feedback为on；增量同步不支持源库备机状态。 若要做增量同步： 源数据库的“pg_hba.conf” 文件中包含如下的配置： host replication all 0.0.0.0/0 md5 源数据库参数wal_level必须配置为logical。 源数据库需提前安装test_decoding插件。 源数据库中无主键表的replica identity属性必须为full。 源数据库的max_replication_slots参数值必须大于当前已使用的复制槽数量。 源数据库的max_wal_senders参数值必须等于或大于max_replication_slots参数值。 源数据库中表的主键列toast属性为main、external、extended时，其replica identity属性必须为full。 源数据库对象要求： 同步对象依赖和关联的对象也须一起同步，否则可能导致同步失败。 说明： 常见的关联关系：主外键关联表、表继承子表引用父表、表分区子分区表引用分区表、表自增列引用序列等。 目标数据库参数要求： 目标数据库参数max_prepared_transactions须大于源数据库。 目标数据库参数max_worker_processes须大于源数据库。 目标数据库参数max_locks_per_transaction须大于源数据库。 目标数据库参数max_connections须大于源数据库。 目标数据库和源数据库的lc_monetary参数值必须一致。 目标数据库对象要求： 目标数据库的字符集必须与源数据库一致。 目标数据库的时区设置必须与源数据库一致。 同步的表要禁用外键，因为DRS并行回放会使得不同表之间的写入顺序和源库不一致，可能会触发外键约束限制，造成同步失败。 支持目标数据库中的表比源数据库多列场景，但是需要避免以下场景可能导致的任务失败。 目标端多的列要求非空且没有默认值，源端insert数据，同步到目标端后多的列为null，不符合目标端要求。 目标端多的列设置固定默认值，且有唯一约束。源端insert多条数据后，同步到目标端后多的列为固定默认值，不符合目标端要求。 其他使用须知： 若专属计算集群不支持4vCPU/8G或以上规格实例，则无法创建同步任务。 暂不支持级联单向同步，例如从实例A同步到实例B，再从实例B同步到实例C。 分区表只同步主表，转为普通表同步到目标库，分区表的数据将集中写入主表。 模式名或表名映射时，为防止索引和约束名冲突，同步后表上的原索引名称将变为此格式：i_+哈希值+原索引名（可能被截断）+_key。其中哈希值由“原模式名_原表名_原索引名”计算得到。同理，表上的原约束名将变为：c_+哈希值+原约束名（可能被截断）+_key。 对于全量+增量和增量任务，启动任务前，请确保源库中未启动长事务，源库启动长事务会阻塞逻辑复制槽的创建，进而引发任务失败。 对于全量+增量和增量任务，任务启动后，仅支持以下版本的源库发生主备倒换：源库为RDS for PostgreSQL 12.6及以上的小版本、RDS for PostgreSQL 13及以上版本的所有小版本。 DRS全量同步表结构时，源库中的character、character varying类型长度在目标库会按照字节长自动扩大（因为目标库为字节长），默认扩大4倍，最大长度为10485760。 DRS全量同步表结构时，目标库存在与某用户名称同名的schema，用其他用户进行同步表结构到schema时，需要使用grant [role] to [role]的方式为此用户赋权，否则可能因为无法创建表结构而导致同步失败。 对象名同步到目标库后不进行大小写转换。 如果表结构中存在通过默认值等形式依赖其他对象（包括但不限于列的默认值引用序列、使用函数间接引用其他对象等场景），不支持对表进行schema或表名映射，且同步前要保证被依赖对象在目标库存在。 源数据库的唯一索引是表达式索引时，全量同步阶段目标数据库GaussDB分布式可能会因为无法创建该索引而导致任务失败。 全量同步过程须知 请勿修改源库和目标库的端口号，请勿修改、删除源库和目标库连接用户的密码、权限，否则可能导致任务失败。 请勿在源库执行任何DDL，否则可能导致数据不一致或任务失败。 请勿在目标库做写入操作，否则可能导致数据不一致。 为保证同步任务正常和数据的一致性，如有以上诉求，建议在业务低峰期时重新创建DRS任务。 增量同步过程须知 请勿修改源库和目标库的端口号，请勿修改、删除源库和目标库连接用户的密码、权限，否则可能导致任务失败。 请勿修改源数据库表的主键或者唯一键（主键不存在时），否则可能导致增量数据不一致或任务失败。 请勿修改源数据库中表的replica identity属性，否则可能导致增量数据不一致或任务失败。 请勿在目标库做写入操作，否则可能导致数据不一致。 为保证同步任务正常和数据的一致性，如有以上诉求，建议在业务低峰期时重新创建DRS任务。 库级同步时，源库新增无主键表时，请务必同时将该无主键表的replica identity属性设置为full，然后再写入数据，否则可能导致数据不一致或任务失败。 库级同步时，源库新增主键表时，如果主键列toast属性为main、external、extended时，请务必同时将该表的replica identity属性设置为full，然后再写入数据，否则可能导致数据不一致或任务失败。 同步对比使用须知 建议在源库的业务低峰期进行数据比对，防止误报不一致数据，以及减少对源库和DRS任务的冲击。 在增量同步过程中做对比时，源库如果存在写入，则对比结果可能不一致。 不支持在全量同步过程中做对比。 不支持数据对比过程中做限速。 结束任务须知 正常结束任务： 全量+增量实时同步任务正常结束时，将自动删除任务在源库创建的流复制槽。 强制结束任务： 强制结束全量+增量实时同步任务，需要手动删除源库可能残留的复制槽，可参考PostgreSQL为源强制结束任务章节的指导进行操作。 逻辑复制槽命名规则为“drs_唯一性标识”，其中唯一性标识需要将任务node id中的“-”替换为“_”获取。node id可在DRS任务同步日志页面查看task node id is ***日志找到。

支持的源和目标数据库 表1 支持的数据库 源数据库 目标数据库 本地自建数据库（PostgreSQL 9.4、9.5、9.6、10、11、12、13、14、15、16版本） ECS自建数据库（PostgreSQL 9.4、9.5、9.6、10、11、12、13、14、15、16版本） GaussDB分布式版（版本数据库内核版本为505.2及以下版本，内核版本与数据库引擎版本的关系请参考云数据库GaussDB的数据库引擎版本说明。） 目前仅支持白名单用户使用。

使用须知 DRS全量+增量同步过程一般包含四个阶段：任务启动阶段、全量阶段、增量阶段、结束任务阶段（单全量任务则包含三个阶段）。为了确保同步各个阶段的平顺，在创建同步任务前，请务必阅读以下使用须知。 表4 使用须知 类型名称 使用和操作约定 任务启动前须知 源数据库参数要求： 源数据库的分区表触发器不可以设置为disable。 全量同步支持源库备机状态，但需要设置hot_standby_feedback为on；增量同步不支持源库备机状态。 若要做增量同步： 源数据库的“pg_hba.conf” 文件中包含如下的配置： host replication all 0.0.0.0/0 md5 源数据库参数wal_level必须配置为logical。 源数据库需提前安装test_decoding插件。 源数据库中无主键表的replica identity属性必须为full。 源数据库的max_replication_slots参数值必须大于当前已使用的复制槽数量。 源数据库的max_wal_senders参数值必须等于或大于max_replication_slots参数值。 源数据库中表的主键列toast属性为main、external、extended时，其replica identity属性必须为full。 源数据库对象要求： 同步对象依赖和关联的对象也须一起同步，否则可能导致同步失败。 说明： 常见的关联关系：视图引用表、视图引用视图、主外键关联表、表继承子表引用父表、表分区子分区表引用分区表、表自增列引用序列等。 目标数据库参数要求： 目标数据库参数max_prepared_transactions须大于源数据库。 目标数据库参数max_worker_processes须大于源数据库。 目标数据库参数max_locks_per_transaction须大于源数据库。 目标数据库参数max_connections须大于源数据库。 目标数据库和源数据库的lc_monetary参数值必须一致。 目标数据库对象要求： 目标数据库的字符集必须与源数据库一致。 目标数据库的时区设置必须与源数据库一致。 同步的表要禁用外键，因为DRS并行回放会使得不同表之间的写入顺序和源库不一致，可能会触发外键约束限制，造成同步失败。 支持目标数据库中的表比源数据库多列场景，但是需要避免以下场景可能导致的任务失败。 目标端多的列要求非空且没有默认值，源端insert数据，同步到目标端后多的列为null，不符合目标端要求。 目标端多的列设置固定默认值，且有唯一约束。源端insert多条数据后，同步到目标端后多的列为固定默认值，不符合目标端要求。 其他使用须知： 若专属计算集群不支持4vCPU/8G或以上规格实例，则无法创建同步任务。 暂不支持级联单向同步，例如从实例A同步到实例B，再从实例B同步到实例C。 分区表只同步主表，转为普通表同步到目标库，分区表的数据将集中写入主表。 模式名或表名映射时，为防止索引和约束名冲突，同步后表上的原索引名称将变为此格式：i_+哈希值+原索引名（可能被截断）+_key。其中哈希值由“原模式名_原表名_原索引名”计算得到。同理，表上的原约束名将变为：c_+哈希值+原约束名（可能被截断）+_key。 对于全量+增量和增量任务，启动任务前，请确保源库中未启动长事务，源库启动长事务会阻塞逻辑复制槽的创建，进而引发任务失败。 对于全量+增量和增量任务，任务启动后，仅支持以下版本的源库发生主备倒换：源库为RDS for PostgreSQL 12.6及以上的小版本、RDS for PostgreSQL 13及以上版本的所有小版本。 DRS全量同步表结构时，源库中的character、character varying类型长度在目标库会按照字节长自动扩大（因为目标库为字节长），默认扩大4倍，最大长度为10485760。 DRS全量同步表结构时，目标库存在与某用户名称同名的schema，用其他用户进行同步表结构到schema时，需要使用grant [role] to [role]的方式为此用户赋权，否则可能因为无法创建表结构而导致同步失败。 对象名同步到目标库后不进行大小写转换。 如果表结构中存在通过默认值等形式依赖其他对象（包括但不限于列的默认值引用序列、使用函数间接引用其他对象等场景），不支持对表进行schema或表名映射，且同步前要保证被依赖对象在目标库存在。 全量同步过程须知 请勿修改源库和目标库的端口号，请勿修改、删除源库和目标库连接用户的密码、权限，否则可能导致任务失败。 请勿在源库执行任何DDL，否则可能导致数据不一致或任务失败。 请勿在目标库做写入操作，否则可能导致数据不一致。 为保证同步任务正常和数据的一致性，如有以上诉求，建议在业务低峰期时重新创建DRS任务。 增量同步过程须知 请勿修改源库和目标库的端口号，请勿修改、删除源库和目标库连接用户的密码、权限，否则可能导致任务失败。 请勿修改源数据库表的主键或者唯一键（主键不存在时），否则可能导致增量数据不一致或任务失败。 请勿修改源数据库中表的replica identity属性，否则可能导致增量数据不一致或任务失败。 请勿在目标库做写入操作，否则可能导致数据不一致。 为保证同步任务正常和数据的一致性，如有以上诉求，建议在业务低峰期时重新创建DRS任务。 库级同步时，源库新增无主键表时，请务必同时将该无主键表的replica identity属性设置为full，然后再写入数据，否则可能导致数据不一致或任务失败。 库级同步时，源库新增主键表时，如果主键列toast属性为main、external、extended时，请务必同时将该表的replica identity属性设置为full，然后再写入数据，否则可能导致数据不一致或任务失败。 同步对比使用须知 建议在源库的业务低峰期进行数据比对，防止误报不一致数据，以及减少对源库和DRS任务的冲击。 在增量同步过程中做对比时，源库如果存在写入，则对比结果可能不一致。 不支持在全量同步过程中做对比。 不支持数据对比过程中做限速。 结束任务须知 正常结束任务： 全量+增量实时同步任务正常结束时，将自动删除任务在源库创建的流复制槽。 强制结束任务： 强制结束全量+增量实时同步任务，需要手动删除源库可能残留的复制槽，可参考PostgreSQL为源强制结束任务章节的指导进行操作。 逻辑复制槽命名规则为“drs_唯一性标识”，其中唯一性标识需要将任务node id中的“-”替换为“_”获取。node id可在DRS任务同步日志页面查看task node id is ***日志找到。

支持的源和目标数据库 表1 支持的数据 源数据库 目标数据库 本地自建数据库（PostgreSQL 9.4、9.5、9.6、10、11、12、13、14、15、16版本） ECS自建数据库（PostgreSQL 9.4、9.5、9.6、10、11、12、13、14、15、16版本） GaussDB集中式版（版本数据库内核版本为505.2及以下版本，内核版本与数据库引擎版本的关系请参考云数据库GaussDB的数据库引擎版本说明。） 目前仅支持白名单用户使用。

支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考表3。DRS会根据用户选择，在“预检查”阶段对同步对象进行自动检查。 表3 支持的同步对象 类型名称 使用须知 同步对象范围 全量同步时支持表、普通索引、主键与唯一约束、数据的同步。增量同步时支持表的实时同步。 全量阶段不支持bfile、sdo_geometry、urowid和自定义类型。增量阶段不支持bfile、sdo_geometry、urowid、interval year to month、interval day to second和自定义类型。 timestamp和interval day to second类型支持的最大精度是6。 全量同步结构不支持位图索引、倒排索引、函数索引。 增量同步LOB类型仅支持BasicFiles属性，不支持SecureFiles属性，全量和增量支持的LOB类型大小限10M以内。 对于TIMESTAMP WITH TIME ZONE类型，根据目标库时区做转换后不得大于“9999-12-31 23:59:59.999999”。 不支持默认值含有表达式的函数的表的同步。 不支持同步源库中的临时表。 不支持同步源库中有虚拟列的表。 不支持同步既是无主键表，又是分区表的自建表，可能会导致任务失败。 不支持GaussDB的无主键复制表，如果需要同步的表在GaussDB为无主键复制表，会导致任务失败。

支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考表3。DRS会根据用户选择，在“预检查”阶段对同步对象进行自动检查。 表3 支持的同步对象 类型名称 使用须知 同步对象范围 全量同步时支持表、普通索引、主键与唯一约束、数据的同步。增量同步时支持表的实时同步。 全量阶段不支持bfile、sdo_geometry、urowid和自定义类型。增量阶段不支持bfile、sdo_geometry、urowid、interval和自定义类型。 timestamp和interval day to second类型支持的最大精度是6。 全量同步结构不支持位图索引、倒排索引、函数索引。 增量同步LOB类型仅支持BasicFiles属性，不支持SecureFiles属性，全量和增量支持的LOB类型大小限10M以内。 对于TIMESTAMP WITH TIME ZONE类型，根据目标库时区做转换后不得大于“9999-12-31 23:59:59.999999”。 不支持默认值含有表达式的函数的表的同步。 不支持同步源库中的临时表。 不支持同步源库中有虚拟列的表。 不支持同步既是无主键表，又是分区表的自建表，可能会导致任务失败。

支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考表3。DRS会根据用户选择，在“预检查”阶段对同步对象进行自动检查。 表3 支持的同步对象 类型名称 使用须知 同步对象范围 全量同步时支持表、普通索引、主键与唯一约束、数据的同步。 增量同步时支持表的实时同步。 TIMESTAMP类型支持的最大精度是6。 增量同步支持的LOB类型大小限制10M以内。 不支持自定义类型。 全量同步结构不支持位图索引、倒排索引、函数索引、XML索引。 增量同步不支持长度大于3998的VARCHAR、VARGRAPHIC类型。 不支持默认值含有表达式的函数的表的同步。 不支持同步源库中的临时表。 不支持同步源库中执行的DDL语句。 不支持GaussDB(DWS)的无主键复制表，如果需要同步的表在GaussDB(DWS)为无主键复制表，会导致任务失败。 全量+增量任务不支持带XML字段的无主键表。 浮点数类型作为主键时，增量同步可能会导致数据不一致。 源库单个schema的同步对象数量不能超过32766。 源库索引名超过63个字符时，目标数据库回放时将自动命名该索引。 增量同步的表Datacapture属性需要为Y。

注意事项 为保证任务的正常运行，DRS提供了自动化的检查方法，在您启动DRS任务前，会针对源数据库和目标数据库的相关配置、条件进行检查。主要的检查项和对应的处理建议请参考预检查项。除了预检查项目之外，您还需要注意的事情参见表4。 表4 注意事项 类型名称 使用和操作限制 使用限制 通用： 不允许修改、删除连接源和目标数据库的用户的用户名、密码、权限，或修改源和目标数据库的端口号。 源库不允许有未提交的DDL事务。 全量同步阶段： 对于全量同步中的目标数据库表对象，不能进行写入操作，否则会导致数据不一致。 全量同步分为表结构同步（含索引）、数据同步两个阶段，任务中只要有一个表的结构在目标库中创建成功即进入数据同步阶段。如果同步完成产生失败表，再启动时将只同步数据，不同步表结构信息，用户必须手动在目标库中建表。 全量同步分区表的结构时会将该对象转为非分区的普通表。 全量同步表结构时只支持字符串或数字类型的普通默认值约束，不支持函数、序列等类型的默认值约束，如有需要，用户必须手动在目标库创建对应表的默认值约束。 增量同步阶段： 增量同步时，BLOB末尾的0x00、CLOB末尾的空格会被截断。 增量同步时阶段，支持任务再编辑追加同步对象。 常见故障排查： 在任务创建、启动、全量同步、增量同步、结束等过程中，如有遇到问题，可先参考“故障排查”章节进行排查。 其他限制 确保目标库已创建以小写字母命名的数据库。 支持目标数据库中的表比源数据库多列场景，但是需要避免以下场景可能导致的任务失败。 目标端多的列要求非空且没有默认值，源端insert数据，同步到目标端后多的列为null，不符合目标端要求。 目标端多的列设置固定默认值，且有唯一约束。源端insert多条数据后，同步到目标端后多的列为固定默认值，不符合目标端要求。 不建议在数据库中使用非精确数值类型做主键，该特性影响DRS增量场景下对UPDATE、DELETE语句的同步，同时也会导致内容比对不可用。 不支持ARM虚拟机环境。 如果无主键表中包含LOB、LONG等大字段，增量同步阶段存在大字段数据不一致的可能性。 如果表结构存在DB2SECURITYLABEL字段类型，读取全量阶段数据可能会受DB2 LBAC（基于标签的访问控制）影响，导致源库和目标库数据不一致。 如果源库和目标库字符集不一致，如源库是GBK，目标库是UTF8，由于GBK字符集单个中文字符占用2个字节，而UTF8字符集单个中文字符占用3个字节，可能会导致CHAR或VARCHAR类型数据同步到目标库后超出字段定义长度，所以客户需要根据实际情况对目标库CHAR和VARCHAR类型字段长度进行扩充（如扩大为源库的1.5倍）。 源数据库的DECFLOAT类型为十进制浮点数。对于DECFLOAT(16)，最小指数为-383，最大指数为384。对于DECFLOAT(34)，最小指数为-6143，最大指数为6144。考虑通用性使用，使用DRS迁移表结构时，DECFLOAT类型会转换为GaussDB(DWS)的NUMERIC(65,10)类型，在数据同步过程中可能会出现精度不足无法写入的报错，需要手动去目标库修改对应列的精度。 全量+增量任务启动前，请确保源数据库没有未提交事务。建议先暂停源数据库业务写入，再启动任务。 任务启动后，对于分区表的detach操作可能导致数据不一致。

数据库账号权限要求 在使用DRS进行同步时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时同步任务。不同类型的同步任务，需要的账号权限也不同，详细可参考表2进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。 表2 数据库账号权限 类型名称 全量同步 全量+增量同步 源数据库连接账号 需要用户具有CONNECT、DATAACCESS权限。 需要用户具有DBADM权限。 如果源数据库表结构存在DB2SECURITYLABEL字段类型，需要确保该用户具有该表全部数据的读权限。 目标数据库连接账号 必须同时拥有以下权限： 目标数据库不存在DATABASE时需要有建库的权限；不存在SCHEMA时需要有在database中创建schema的权限；不存在表时需要有在对应schema中创建表的权限。 对于每张表需要有INSERT、SELECT、UPDATE、DELETE权限。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请参考修改连接信息章节修改DRS任务的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。

注意事项 为保证任务的正常运行，DRS提供了自动化的检查方法，在您启动DRS任务前，会针对源数据库和目标数据库的相关配置、条件进行检查。主要的检查项和对应的处理建议请参考预检查项。除了预检查项目之外，您还需要注意的事情参见表4。 表4 注意事项 类型名称 使用和操作限制 源数据库限制 源数据库的库名不能包含/\."$和空格，集合名和视图名中不能包含$字符或以system.开头。 单节点类型实例的增量同步目前仅支持源库为文档数据库单节点实例。 增量同步时，源数据库的Oplog日志必须打开。 在磁盘空间允许的情况下，建议源数据库Oplog保存时间越长越好，建议为3天。 使用限制 通用： 为了保持数据一致性，在整个同步过程中，不允许对正在同步中的目标数据库进行修改操作（包括但不限于DDL、DML操作）。 在整个同步过程中，不允许修改、删除连接源和目标数据库的用户的用户名、密码、权限，或修改源和目标数据库的端口号。 在任务启动、任务全量同步阶段，不建议对源数据库做删除类型的DDL操作，例如删除数据库、集合、索引、文档、视图等，这样可能会引起任务同步失败。 在整个同步过程中，不支持源数据库主备切换导致数据回滚的情况。 在整个同步过程中，不支持insert、update源库大于16MB的文档。 整个同步过程中，源数据库不允许手动执行sh.moveChunk()操作，否则将导致迁移数据不一致。 全量同步阶段： 任务启动和全量数据同步阶段，请不要在源数据库执行DDL操作，否则可能导致任务异常。 增量同步阶段： 源数据库为副本集实例时，增量同步阶段支持如下操作： 支持文档（document）新增、删除、更新。 支持集合（collection）新建、删除。 支持索引（index）新建、删除。 支持视图（view）新建，删除。 支持convertToCapped、collMod、renameCollection命令。 任务增量阶段，为保证同步的性能，会集合级的进行并发回放。特殊的情况只支持单线程写入，不支持并发回放： 集合的索引中有unique key时。 集合属性的capped为true时。 这种情况可能会导致任务时延增高。 常见故障排查： 在任务创建、启动、全量同步、增量同步、结束等过程中，如有遇到问题，可先参考“故障排查”章节进行排查。 其他限制 副本集：MongoDB数据库的副本集实例状态必须正常，要存在主节点。 压缩参数block_compressor的取值，根据源库对应集合的stats().wiredTiger.creationString.block_compressor来决定，如果目标库已经存在对应的空集合，则不同步压缩参数；特殊的，对于不支持的压缩参数，按照目标库实例的net.compression.compressors参数决定。当目标库为DDS 4.2版本时，由于目标库不支持压缩参数的设置，DRS不同步压缩参数。 如果源数据库的MongoDB服务不是单独部署的，而是和其他的服务部署在同一台机器，则必须要给源数据库的wiredTiger引擎加上cacheSizeGB的参数配置，建议值设为最小空闲内存的一半。 选择集合同步时，增量同步过程中不建议对集合进行重命名操作。 建议填写副本集所有的主节点和备节点信息，以防主备切换影响同步任务。如果填写的是主备多个节点的信息，注意所有的节点信息必须属于同一个副本集实例。 为了提高同步的速度，在开始同步之前，建议在源数据库删掉不需要的索引，只保留必须的索引。在同步过程中不建议对源库创建索引，如果必须要创建索引，请使用后台的方式创建索引。 为了防止回环，不支持在相同的源和目标库同时启动入云和出云任务。 说明： 同步任务支持源和目标为同一个数据库，为了避免回环，必须使用对象名映射功能进行重命名。

支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考表3。DRS会根据用户选择，在“预检查”阶段对同步对象进行自动检查。 表3 支持的同步对象 类型名称 使用须知 同步对象范围 支持选择表级、库级。 副本集：目前只支持集合（包括验证器，是否是固定集合），索引和视图的同步。 集群：目前只支持集合（包括验证器，是否是固定集合），分片键，索引和视图的同步。 单节点：目前只支持集合（包括验证器，是否是固定集合），索引和视图的同步。 不支持同步系统库（如local、admin、config等）和系统集合，如果业务数据在系统库下，则需要先将业务数据移动到用户数据库下，可以使用renameCollection命令进行移出。 不支持视图的创建语句中有正则表达式。 不支持_id字段没有索引的集合。 不支持BinData()的第一个参数为2。 源库为4.4或更高版本副本集时，如果目标库低于5.0版本，不支持复合哈希索引。 源库为4.4或更高版本副本集时，如果目标库低于5.0版本，不支持复合哈希索引。 全量和增量阶段都不支持时序集合。 请勿在源库集合的String类型字段中存储非UTF-8类型字符串，否则会导致同步前后数据不一致。

支持的源和目标数据库 表1 支持的数据库 源数据库 目标数据库 本地自建Mongo数据库（3.2、3.4、3.6、4.0、4.2、4.4、5.0版本） ECS自建Mongo数据库（3.2、3.4、3.6、4.0、4.2、4.4、5.0版本） 其他云上Mongo数据库（3.2、3.4、3.6、4.0、4.2、4.4、5.0版本） DDS实例（3.2、3.4、4.0、4.2、4.4、5.0版本） 说明： 源数据库不支持GeminiDB Mongo实例。 DDS 5.0版本当前仅支持副本集，不支持集群。 如果源库选择DDS实例，则此链路的数据库引擎是“DDS”，否则，此链路的数据库引擎是“MongoDB（数据库种类）-DDS”。 DDS实例（3.4、4.0、4.2、4.4、5.0版本） 说明： 仅支持目标库版本等于或高于源库版本。 DDS 5.0版本当前仅支持副本集，不支持集群。

数据库账号权限要求 在使用DRS进行同步时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时同步任务。不同类型的同步任务，需要的账号权限也不同，详细可参考表2进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。 表2 数据库账号权限 类型名称 全量+增量同步 源数据库连接账号 副本集：连接源数据库的用户需要有admin库的readAnyDatabase权限，有local库的read权限。 单节点：连接源数据库的用户需要有admin库的readAnyDatabase权限，有local库的read权限。 集群：连接源数据库mongos节点的用户需要对待迁移库有read权限，对config数据库有read权限， 连接源数据库分片节点的用户需要对admin数据库有readAnyDatabase权限，对local数据库有read权限。 目标数据库连接账号 连接目标数据库的用户需要有admin库的dbAdminAnyDatabase权限，有目标数据库的readWrite权限。对于目标数据库是集群的实例，连接mnogos节点的用户还要有admin库的clusterManager权限。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请参考修改连接信息章节修改DRS任务的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。

注意事项 为保证任务的正常运行，DRS提供了自动化的检查方法，在您启动DRS任务前，会针对源数据库和目标数据库的相关配置、条件进行检查。主要的检查项和对应的处理建议请参考预检查项。除了预检查项目之外，您还需要注意的事情参见表4。 表4 注意事项 类型名称 使用和操作限制 源数据库限制 源数据库如果开启客户端配置中的“强制协议加密（Force Protocol Encrypton）”，必须同时开启“信任服务器证书（trust server certificate）”，如下图1所示： 图1 查看客户端属性 使用限制 通用： 请勿修改源库和目标库的端口号，请勿修改、删除源库和目标库连接用户的密码、权限，否则可能导致任务失败。 请勿在目标库做写入操作，否则可能导致数据不一致。 为保证同步任务正常和数据的一致性，如有以上诉求，建议在业务低峰期时重新创建DRS任务。 全量同步阶段： 请勿在源库执行任何DDL，否则可能导致数据不一致或任务失败。 增量同步阶段： 支持DML（Data Manipulation Language）：包括INSERT、UPDATE、DELETE。 不支持DDL操作，源数据库进行的DDL操作不会同步到目标数据库。因cdc不记录DDL相关记录，可能会造成数据不一致或任务失败（如源端新增列，cdc不记录新增列相关记录，同步到目标端缺失新增列信息），恢复任务需通过再编辑去掉该表后，目标端清空该表数据后，重新通过再编辑加入该表继续同步。 不支持同步到目标端且会造成任务异常的DDL类型： ALTER TABLE ADD COLUMN ALTER TABLE DROP COLUMN ALTER TABLE ALTER COLUMN DROP TABLE 不支持同步到目标端但不会造成任务异常的DDL类型： CREATE TABLE CREATE INDEX DROP INDEX ALTER INDEX 不支持大数据类型IMAGE、TEXT、NTEXT的删除操作。 支持任务再编辑追加同步对象。 若开启CDC的表需要写入的单字段数据超过64 KB，则必须提前使用exec sp_configure 'max text repl size', -1;命令调整源库的配置。 （CDC作业默认最大能处理的单字段长度为64 KB） 同步对比阶段： 建议在源库的业务低峰期进行数据比对，防止误报不一致数据，以及减少对源库和DRS任务的冲击。 在增量同步过程中做对比时，源库如果存在写入，则对比结果可能不一致。 不支持在全量同步过程中做对比。 不支持数据对比过程中做限速。 常见故障排查： 在任务创建、启动、全量同步、增量同步、结束等过程中，如有遇到问题，可先参考“故障排查”章节进行排查。 其他限制 同步表结构时支持以下函数作为默认值：now、newid、getutcdate、getdate。将这些函数作为default值时，需要目标数据库也有相同功能的函数。对于目标数据库不存在对应函数的情况，可能会出现以下结果： 默认值函数可能会被置空。 创建表失败，导致对象对比不一致或者任务失败。 支持目标数据库中的表比源数据库多列场景，但是需要避免以下场景可能导致的任务失败。 目标数据库多的列要求非空且没有默认值，源库insert数据，同步到目标数据库后多的列为null，不符合目标数据库要求。 目标数据库多的列设置固定默认值，且有唯一约束。源库insert多条数据后，同步到目标数据库后多的列为固定默认值，不符合目标数据库要求。 不支持源数据库主备切换，源数据库主备切换会导致同步任务失败。 SQL Server仅支持SQL Server的身份认证模式，不支持Windows身份认证方式。 不支持源数据库Microsoft SQL Server为TLS 1.0、TLS 1.1协议的同步，如果需要同步，建议源库升级到TLS 1.2及以上版本。 因为部分SQL Server（例如Azure SQL）不支持use语法，不支持同步多库，所以如果需要同步多库时请创建多个同步任务。 因为GaussDB(DWS)中的B-Tree最多可在32个字段上创建索引，源数据库联合索引超过32字段时在目标数据库会创建索引失败。 Azure SQL数据库，连接策略暂不支持Redirect，如果是Redirect请修改成默认值或者Proxy选项。