# 将DB2 for LUW同步到GaussDB分布式版 #### 支持的源和目标数据库 表1支持的数据库 | 源数据库 | 目标数据库 | |:---|:---| | DB2 for LUW 9.7、10.1、10.5、11.1、11.5版本 | GaussDB分布式版（ORA、MYSQL兼容模式。数据库内核版本为505.2及以下版本，内核版本与数据库引擎版本的关系请参考云数据库GaussDB的[数据库引擎版本说明](https://support.huaweicloud.com/productdesc-gaussdb/gaussdb_01_012.html)。） | #### 数据库账号权限要求 在使用DRS进行同步时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时同步任务。不同类型的同步任务，需要的账号权限也不同，详细可参考[表2]进行赋权。**DRS会在"预检查"阶段对数据库账号权限进行自动检查，并给出处理建议。** 表2数据库账号权限 | **类型名称** | **全量同步** | **全量+增量同步** | |:---|:---|:---| | 源数据库连接账号 | 需要用户具有CONNECT、DATAACCESS权限。 | 需要用户具有DBADM权限。 | | 源数据库连接账号 | 如果源数据库表结构存在DB2SECURITYLABEL字段类型，需要确保该用户具有该表全部数据的读权限。 || | 目标数据库连接账号 | - 库级权限：需要使用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工具参考》](https://support.huaweicloud.com/tg-gaussdb-cent/gaussdb-38-0011.html)。 || ![](https://support.huaweicloud.com/realtimesyn-drs/public_sys-resources/note_3.0-zh-cn.png) - 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 - 连接源和目标数据库的账号密码修改后，请参考[修改连接信息](https://support.huaweicloud.com/realtimesyn-drs/drs_10_0016.html)章节修改DRS任务的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。 #### 支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考[表3]。**DRS会根据用户选择，在"预检查"阶段对同步对象进行自动检查**。 表3支持的同步对象 | **类型名称** | **使用须知** | |:---|:---| | 同步对象范围 | - 全量同步时支持表、普通索引、主键与唯一约束、数据的同步。 - 增量同步时支持表的实时同步。 - TIMESTAMP类型支持的最大精度是6。 - 增量同步支持的LOB类型大小限制10M以内。 - 不支持自定义类型。 - 全量同步结构不支持位图索引、倒排索引、函数索引、XML索引。 - 增量同步不支持长度大于3998的VARCHAR、VARGRAPHIC类型。 - 不支持默认值含有表达式的函数的表的同步。 - 不支持同步源库中的临时表。 - 不支持同步源库中执行的DDL语句。 - 全量+增量任务不支持带XML字段的无主键表。 - 浮点数类型作为主键时，增量同步可能会导致数据不一致。 - 不支持GaussDB的无主键复制表，如果需要同步的表在GaussDB为无主键复制表，会导致任务失败。 | #### 注意事项 为保证任务的正常运行，DRS提供了自动化的检查方法，在您启动DRS任务前，会针对源数据库和目标数据库的相关配置、条件进行检查。主要的检查项和对应的处理建议请参考DRS预检查项一览表内的相关内容。除了预检查项目之外，您还需要注意的事情参见[表4]。 表4注意事项 | **类型名称** | **使用和操作限制** | |:---|:---| | 使用限制 | **通用：** - 不允许修改、删除连接源和目标数据库的用户的用户名、密码、权限，或修改源和目标数据库的端口号。 - 源库不允许有未提交的DDL事务。 **全量同步阶段：** - 对于全量同步中的目标数据库表对象，不能进行写入操作，否则会导致数据不一致。 - 全量同步分为表结构同步（含索引）、数据同步两个阶段，任务中只要有一个表的结构在目标库中创建成功即进入数据同步阶段。如果同步完成产生失败表，再启动时将只同步数据，不同步表结构信息，用户必须手动在目标库中建表。 - 全量同步分区表的结构时会将该对象转为非分区的普通表。 - 全量同步表结构时只支持字符串或数字类型的普通默认值约束，不支持函数、序列等类型的默认值约束，如有需要，用户必须手动在目标库创建对应表的默认值约束。 - 全量同步表结构时，目标库存在与某用户名称同名的schema，用其他用户进行同步表结构到schema时，需要使用grant \[role\] to \[role\]的方式为此用户赋权，否则可能因为无法创建表结构而导致同步失败。 - 全量同步表结构时，对象名为CTID、XMIN、CMIN、XMAX、CMAX、TABLEOID这些GaussDB禁止小写创建的关键字，会被默认创建为大写。 **增量同步阶段：** - 增量同步时，BLOB末尾的0x00、CLOB末尾的空格会被截断。 - 增量同步时，支持任务再编辑追加同步对象。 - 增量同步阶段，源库DB2 for LUW对主键列或无主键表的第一列的update操作会导致在GaussDB数据库更新分布列，有可能会造成数据不一致，所以业务上要尽量规避对上述列的更新。 - 不支持分布式为源，DB2分布式集群LSN存在乱序情况，无法保证数据最终一致性。 - 如果源库无主键表中包含LOB、LONG等大字段，增量同步阶段存在大字段数据不一致的可能性。 - 增量同步过程中，不支持DELETE和UPDATE目标数据库主键类型为clob、blob、dbclob、varbinary、binary、xml、character for bit data、 varchar for bit data、long varchar for bit data的表。 - 增量同步过程中，若目标数据库中的表缺少主键且所有列均为以下类型：clob、blob、dbclob、varbinary、binary、xml、character for bit data、 varchar for bit data、long varchar for bit data，则不支持对该表执行DELETE和UPDATE操作。 **常见故障排查：** - 在任务创建、启动、全量同步、增量同步、结束等过程中，如有遇到问题，可先参考"[故障排查](https://support.huaweicloud.com/trouble-drs/drs_13_0008.html)"章节进行排查。 | | 其他限制 | - 确保目标库已创建以小写字母命名的数据库。 - 支持目标数据库中的表比源数据库多列场景，但是需要避免以下场景可能导致的任务失败。 - 目标端多的列要求非空且没有默认值，源端insert数据，同步到目标端后多的列为null，不符合目标端要求。 - 目标端多的列设置固定默认值，且有唯一约束。源端insert多条数据后，同步到目标端后多的列为固定默认值，不符合目标端要求。 - 不建议在数据库中使用非精确数值类型做主键，该特性影响DRS增量场景下对UPDATE、DELETE语句的同步。 - 不支持ARM虚拟机环境。 - 如果表结构存在DB2SECURITYLABEL字段类型，读取全量阶段数据可能会受DB2 LBAC（基于标签的访问控制）影响，导致源库和目标库数据不一致。 - 如果源库和目标库字符集不一致，如源库是GBK，目标库是UTF8，由于GBK字符集单个中文字符占用2个字节，而UTF8字符集单个中文字符占用3个字节，可能会导致CHAR或VARCHAR类型数据同步到目标库后超出字段定义长度，所以客户需要根据实际情况对目标库CHAR和VARCHAR类型字段长度进行扩充（如扩大为源库的1.5倍）。 - 任务启动后，对于分区表的detach操作可能导致数据不一致。 - 包含增量同步的任务启动前，请确保被选中同步的表，在源数据库的事务都已提交，否则可能会出现数据损失。建议先暂停源数据库业务写入，再启动任务。 - 任务再编辑增加新表时，请确保新增的表的事务都已提交，否则未提交的事务可能无法同步到目标库。建议在业务低峰期做增加表的操作。 - 源库中的空字符串写入目标库的结果是空字符串或者null取决于目标库的兼容性处理，例如GaussDB A兼容模式会将空字符串自动转换为null。 - 正常结束任务时，如果目标库同步表中已关联序列，DRS将自动重置目标库序列值。重置的自增序列值为目标库序列关联列的最大值+安全余度，自减序列值为目标库序列关联列的最小值-安全余度，安全余度默认为10000。 | #### 操作步骤 1. 在"实时同步管理"页面，单击"创建同步任务"。 2. 在"同步实例"页面，填选区域、项目、任务名称、描述、同步实例信息，单击"开始创建"。此处支持单击"使用上次创建信息"，使用上次创建任务实例缓存的信息。 - 任务信息 图1同步任务信息 ![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000002544724256.png "点击放大") 表5任务和描述 | **参数** | **描述** | |:---|:---| | 计费模式 | 有如下两种模式可选择： - 包年/包月 - 按需计费 | | 区域 | 当前所在区域，可进行切换。 | | 项目 | 当前区域对应的项目，可进行切换。 | | 任务名称 | 任务名称在4到50位之间，必须以字母开头，可以包含字母、数字、中划线或下划线，不能包含其他的特殊字符。 | | 描述 | 描述不能超过256位，且不能包含! = \< \> \& ' " \\ 特殊字符。 | - 同步实例信息 图2同步实例信息 ![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000002142357229.png "点击放大") 表6同步实例信息 | **参数** | **描述** | |:---|:---| | 数据流动方向 | 选择"入云"。 | | 源数据库引擎 | 选择"DB2 for LUW"。 | | 目标数据库引擎 | 选择"GaussDB分布式版"。 | | 网络类型 | 此处以"公网网络"为示例。可根据业务场景选择"公网网络"、"VPC网络"和"VPN、专线网络"。 - VPC网络：适合云上同账号同Region同VPC场景下数据库之间的同步。 - 公网网络：适合通过公网网络将其他云下或其他平台的数据库同步到目标数据库的场景，此类型要求数据库绑定弹性公网IP（EIP）。当一端为本云的数据库实例时，DRS任务与该端的通信方式为VPC内网。 - VPN、专线网络：适合VPN、专线、CC、VPCEP、或者用户已打通VPC对等连接的网络场景，实现其他云下自建数据库与云上数据库同步、云上同Region跨账号、或云上跨Region的数据库之间的同步。 | | 目标数据库实例 | 用户所创建的GaussDB分布式版实例。 | | 同步实例所在子网 | 请选择同步实例所在的子网。也可以单击"查看子网"，跳转至"网络控制台"查看实例所在子网帮助选择。 默认值为当前所选数据库实例所在子网，请选择有可用IP地址的子网。为确保同步实例创建成功，仅显示已经开启DHCP的子网。 | | 同步模式 | DRS任务支持的同步模式，此处以"全量+增量"为示例。DRS全量、增量底层实现原理可参考[产品架构和功能原理](https://support.huaweicloud.com/productdesc-drs/drs_01_0317.html#section1)。 | | 指定公网IP | 网络类型选择"公网网络"时可见，选择为DRS实例绑定的弹性公网IP。任务创建时，DRS将会自动绑定该弹性公网IP，等待任务结束后将自动解绑该弹性公网IP。 公网网络迁移产生的数据传输费用收取标准请参见：[弹性公网IP价格计算器](https://www.huaweicloud.com/pricing.html#/eip)。 | - 可用区 图3可用区 ![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000001880173562.png "点击放大") 表7任务可用区 | **参数** | **描述** | |:---|:---| | 可用区 | DRS任务创建的可用区，选择跟源或目标库相同的可用区性能更优。 | - 企业项目和标签 图4企业项目和标签 ![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000002544564662.png "点击放大") 表8企业项目和标签 | **参数** | **描述** | |:---|:---| | 企业项目 | 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。请在下拉框中选择所在的企业项目，其中，default为默认项目。 更多关于企业项目的信息，请参见[《企业管理用户指南》](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0108763975.html)。 如果需要自定义企业项目，请在控制台右上角单击"企业"，进入"企业项目管理"页面创建，具体请参见《企业管理用户指南》中"[创建企业项目](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0108763964.html)"的内容。 | | 标签 | - 可选配置，对同步任务的标识。使用标签可方便管理您的任务。每个任务最多支持20个标签配额。 - 如果您的组织已经设定DRS的相关标签策略，则需按照标签策略规则为任务添加标签。标签如果不符合标签策略的规则，则可能会导致任务创建失败，请联系组织管理员了解标签策略详情。 - 任务创建成功后，您可以单击任务名称，在"标签"页签下查看对应标签。关于标签的详细操作，请参见[标签管理](https://support.huaweicloud.com/realtimesyn-drs/drs_synchronization_tag.html)。 | 3. 在"源库及目标库"页面，填选源库信息和目标库信息，单击"源库和目标库"处的"测试连接"，分别测试并确定与源库和目标库连通后，单击"下一步"。 图5源库信息 ![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000001880013036.png "点击放大") 表9源库信息 | **参数** | **描述** | |:---|:---| | IP地址或域名 | 源数据库DB2 for LUW的IP地址或域名。 | | 端口 | 源数据库DB2 for LUW服务端口，可输入范围为1\~65535间的整数。 | | 数据库用户名 | 源数据库DB2 for LUW的数据库账号。 | | 数据库密码 | 源数据库账号所对应的密码。 | | 数据库名 | 源数据库DB2 for LUW中同步对象所属数据库的名称。 | | SSL安全连接 | 通过该功能，用户可以选择是否开启对同步链路的加密。如果开启该功能，需要用户上传SSL CA根证书。目前仅DB2 for LUW 10.5及以上的版本支持SSL安全连接，DB2 for LUW 9.7和10.1版本暂不支持。 说明： - 最大支持上传500KB的证书文件。 - 如果不使用SSL安全连接，请自行承担数据安全风险。 - DB2 for LUW SSL安全连接需要上传三个证书文件：jks证书、kdb证书和sth证书。 - kdb证书和sth证书测试连接时DRS不会进行校验，需要用户保证文件正确性，避免后续任务失败。 | | 同步驱动 | 用户需要手动添加并上传源数据库DB2 for LUW对应的JDBC驱动包后，再进行测试连接。 | ![](https://support.huaweicloud.com/realtimesyn-drs/public_sys-resources/note_3.0-zh-cn.png) **源数据库的数据库IP地址、用户名和密码，** **会被系统加密暂存，直至删除该同步任务后自动清除。** 图6目标库信息 ![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000001880174162.png "点击放大") 表10目标库信息 | **参数** | **描述** | |:---|:---| | 数据库实例名称 | 默认为创建同步任务时选择的GaussDB分布式版实例，不可进行修改。 | | 数据库用户名 | 目标数据库的账号。 | | 数据库密码 | 目标数据库账号所对应的密码。数据库用户名和密码将被系统加密暂存，直至该任务删除后清除。 | ![](https://support.huaweicloud.com/realtimesyn-drs/public_sys-resources/note_3.0-zh-cn.png) **目标数据库的数据库的用户名和密码，** **会被系统加密暂存，直至删除该同步任务后自动清除。** 4. 在"设置同步"页面，选择同步对象，此处必须手动输入目标数据库名称，完成后单击"下一步"。 图7设置同步 ![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000001926013481.png "点击放大") 表11同步对象 | **参数** | **描述** | |:---|:---| | 全量同步对象类型 | 全量同步对象类型，可选同步表结构、同步数据、同步索引，根据实际需求进行选择要同步内容。 - 同步数据为必选项。 - 选择同步表结构的时候目标库不能有同名的表。 - 不选同步表结构的时候目标库必须有相应的表，且要保证表结构与所选表结构相同。 | | DML同步 | 选择需要同步的DML操作，默认都勾选。 不勾选Delete则不会同步源库增量数据中的Delete语句，可能会导致数据不一致，因此存在数据冲突或任务失败的风险。 | | 同步对象 | 左侧框是源数据库对象，右侧框是已经选择的对象，支持表级同步和导入对象文件，您可以根据业务场景选择对应的数据进行同步。 - 在同步对象右侧已选对象框中，可以使用对象名映射功能进行源数据库和目标数据库中的同步对象映射，具体操作可参考[对象名修改（对象名映射）](https://support.huaweicloud.com/realtimesyn-drs/drs_10_0015.html)。 - 选择导入对象文件，具体步骤和说明可参考[导入同步对象](https://support.huaweicloud.com/realtimesyn-drs/drs_10_0402.html)。 说明： - 选择对象的时候支持对**展开的库**进行搜索，以便您快速选择需要的数据库对象。 - 如果有切换源数据库的操作或源库同步对象变化的情况，请在选择同步对象前单击右上角的![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000002555122086.png)，以确保待选择的对象为最新源数据库对象。 - 当对象名称包含空格时，名称前后的空格不显示，中间如有多个空格只显示一个空格。 - 选择的同步对象名称中不能包含空格。 | 5. 在"数据加工"页面，选择需要加工的数据，进行数据过滤。 - 如果不需要数据加工，单击"下一步"。 - 如果需要数据过滤，参考[数据加工](https://support.huaweicloud.com/realtimesyn-drs/drs_03_0035.html)中的数据过滤，设置相关规则。 6. 在"预检查"页面，进行同步任务预校验，校验是否可进行实时同步。 - 查看检查结果，如有不通过的检查项，需要修复不通过项后，单击"重新校验"按钮重新进行任务预校验。 预检查不通过项处理建议请参见《数据复制服务用户指南》中的"[预检查不通过项修复方法](https://support.huaweicloud.com/trouble-drs/drs_11_0001.html)"。 - 预检查完成后，且所有检查项结果均通过时，单击"下一步"。 ![](https://support.huaweicloud.com/realtimesyn-drs/public_sys-resources/note_3.0-zh-cn.png) 所有检查项结果均通过时，若存在请确认项，需要阅读并确认详情后才可以继续执行下一步操作。 7. 在"任务确认"页面，设置同步任务的启动时间、任务异常通知设置、SMN主题、时延阈值、结束自动创建对比任务、立即启动（仅初始化）、任务异常自动结束时间，并确认同步任务信息无误后，勾选协议，单击"启动任务"，提交同步任务。 图8任务启动设置 ![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000002575364719.png "点击放大") 图9单全量任务启动设置 ![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000002575244769.png "点击放大") 表12任务启动设置 | **参数** | **描述** | |:---|:---| | 启动时间 | 同步任务的启动时间可以根据业务需求，设置为"立即启动"或"稍后启动"。 说明： 预计同步任务启动后，会对源数据库和目标数据库的性能产生影响，建议选择业务低峰期，合理设置同步任务的启动时间。 | | 任务异常通知设置 | 该项为可选参数，开启之后，选择对应的SMN主题。当同步任务状态、时延指标或数据异常时，系统将发送通知。 | | SMN主题 | "任务异常通知设置"项开启后可见，需提前在SMN上申请主题并添加订阅。 SMN主题申请和订阅可参考[《消息通知服务用户指南》](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043394914.html)。 | | 时延阈值 | 在增量同步阶段，源数据库和目标数据库之间的同步有时会存在一个时间差，称为时延，单位为秒。 时延阈值设置是指时延超过一定的值后（时延阈值范围为0到3600s），DRS可以发送告警通知。告警通知将在时延稳定超过设定的阈值6min后发送，避免出现由于时延波动反复发送告警通知的情况。 说明： - 当时延阈值设置为0时，不会发送通知给收件人。 - 首次进入增量同步阶段，会有较多数据等待同步，存在较大的时延，属于正常情况，不在此功能的监控范围之内。 - 设置时延阈值之前，需要设置任务异常通知。 | | 结束自动创建对比任务 | 在单全量任务场景，可选择是否开启"结束自动创建对比任务"。 - 开启"结束自动创建对比任务"，任务结束后自动创建对象对比与行对比。 - 不开启"结束自动创建对比任务"，任务结束后不自动创建对比任务。 | | 立即启动（仅初始化） | 在单全量任务场景，可选择是否开启"立即启动（仅初始化）"。 | | 数据异常通知 | 该项为可选参数，开启之后，当同步任务数据异常时，系统将发送通知。 | | 任务异常自动结束时间（天） | 设置任务异常自动结束天数，输入值必须在14到100之间，默认值14。 说明： - 仅按需计费任务支持设置任务异常自动结束时间，包年/包月任务不支持。 - 异常状态下的任务仍然会计费，而长时间异常的任务无法续传和恢复。设置任务异常自动结束天数后，异常且超时的任务将会自动结束，以免产生不必要的费用。 | ![](https://support.huaweicloud.com/realtimesyn-drs/public_sys-resources/note_3.0-zh-cn.png) 在公测免费场景，需勾选"我已阅读并同意公测试用服务协议"，才能启动任务。 8. 同步任务提交后，您可在"实时同步管理"页面，查看并[管理自己的任务](https://support.huaweicloud.com/realtimesyn-drs/drs_TaskMangement.html)。 - 您可查看任务提交后的状态，状态请参见[任务状态说明](https://support.huaweicloud.com/realtimesyn-drs/drs_06_0004.html)。 - 在任务列表的右上角，单击![](https://support.huaweicloud.com/realtimesyn-drs/figure/zh-cn_image_0000001180625010.png)刷新列表，可查看到最新的任务状态。 - 对于未启动、状态为配置中的任务，DRS默认保留3天，超过3天DRS会自动删除后台资源，当前任务状态不变。当用户再次配置时，DRS会重新申请资源，此时DRS任务IP会发生改变。 - 对于创建失败的任务，DRS默认保留3天，超过3天将会自动结束任务。 - 对于公网网络类型的任务，由于DRS需要在任务结束后删除后台资源，所以该任务绑定的弹性公网IP需要等待一段时间，才能恢复为解绑状态。