本文为您介绍如何创建 OceanBase 数据库 MySQL 租户(简称为 OB_MySQL)至 OceanBase 数据库 MySQL 租户的数据同步项目。
前提条件
数据传输已具备云资源访问权限。详情请参见 数据传输迁移角色授权。
已为 OceanBase 数据库创建专用于数据同步项目的数据库用户,并为其赋予了相关权限。详情请参见 创建数据库用户。
使用限制
数据传输仅支持迁移库名、表名和列名为 ASCII 码且不包含特殊字符(包括换行、空格,以及 .|"'`()=;/&)的对象。
注意事项
节点之间的时钟不同步,或者电脑终端和服务器之间的时钟不同步,均可能导致增量同步的延迟时间不准确。
例如,如果时钟早于标准时间,可能导致延迟时间为负数。如果时钟晚于标准时间,可能导致延迟。
支持的源端和目标端实例类型
OceanBase 数据库 MySQL 租户之间的数据同步项目中,数据传输仅支持同步具有唯一键的表。
源端 | 目标端 |
OB_MySQL(OceanBase 集群实例) | OB_MySQL(OceanBase 集群实例) |
OB_MySQL(OceanBase 集群实例) | OB_MySQL(VPC 内自建数据库) |
OB_MySQL(VPC 内自建数据库) | OB_MySQL(OceanBase 集群实例) |
操作步骤
登录 OceanBase 管理控制台,购买数据同步项目。
详情请参见 购买数据同步项目。
在 数据传输 > 数据同步 页面,单击新购买的数据同步项目后的 配置。
如果您需要引用已有的项目配置信息,可以单击 引用配置。详情请参见 引用和清空数据同步项目配置。
在 选择源和目标 页面,配置各项参数。
参数
描述
同步项目名称
建议使用中文、数字和字母的组合。名称中不能包含空格,长度不能超过 64 个字符。
标签
单击文本框,在下拉列表中选择目标标签。您也可以单击 管理标签,进行新建、修改和删除。详情请参见 通过标签管理数据同步项目。
源端
如果您已新建 OceanBase 数据源,请从下拉列表中进行选择。如果未新建,请单击下拉列表中的 新建数据源,在右侧对话框进行新建。参数详情请参见 新建 OceanBase 数据源。
重要源端不支持 OceanBase 数据库 MySQL 租户的 实例类型 为 OceanBase 租户实例。
目标端
如果您已新建 OceanBase 数据源,请从下拉列表中进行选择。如果未新建,请单击下拉列表中的 新建数据源,在右侧对话框进行新建。
重要目标端不支持 OceanBase 数据库 MySQL 租户的 实例类型 为 OceanBase 租户实例。
单击 下一步。在 选择同步类型 页面,选择当前数据同步项目的同步类型。
同步类型包括 结构同步、全量同步 和 增量同步。增量同步 包括 同步 DML 和 同步 DDL。
单击 下一步。在 选择同步对象 页面,选择当前数据同步项目需要同步的对象。
您可以通过 指定对象 和 匹配规则 两个入口选择迁移对象。
重要待同步的表名和其中的列名不能包含中文字符。
当数据库的库名或表名存在“$$”字符时,会影响数据同步项目的创建。
通过 指定对象 的方式选择同步对象后,DDL 操作仅对已选择的对象生效,不支持创建新表。
选择 指定对象,在左侧选中需要同步的对象,单击 >,将其添加至右侧列表中。您可以选择一个或多个库的表作为同步对象。
数据传输支持通过文本导入对象,并支持对目标端对象进行重命名、设置行过滤、移除单个对象或全部对象等操作。
操作
步骤
导入对象
在选择区域的右侧列表中,单击右上角的 导入对象。
在对话框中,单击 确定。
重要导入会覆盖之前的操作选择,请谨慎操作。
在 导入同步对象 对话框中,导入需要同步的对象。 您可以通过导入 CSV 文件的方式进行库表重命名、设置行过滤条件等操作。详情请参见 下载和导入同步对象配置。
单击 检验合法性。
通过合法性的检验后,单击 确定。
重命名
数据传输支持重命名同步对象的名称,详情请参见 数据库库表重命名。
设置
数据传输支持
WHERE
条件实现行过滤,以及查看同步对象的列信息。在选择区域的右侧列表中,鼠标悬停至目标对象。
单击显示的 设置。
在 设置 对话框中,您可以进行以下操作。
在 行过滤条件 区域的文本框中,输入标准的 SQL 语句中的
WHERE
子句,来配置行过滤。详情请参见 SQL 条件过滤数据。在 查看列 区域,查看同步对象的列信息。
单击 确定。
移除/全部移除
数据传输支持在数据映射时,对暂时选中到目标端的单个或多个对象进行移除操作。
移除单个同步对象
在选择区域的右侧列表中,鼠标悬停至目标对象,单击显示的 移除,即可移除该同步对象。
移除全部同步对象
在选择区域的右侧列表中,单击右上角的 全部移除。在对话框中,单击 确定,即可移除全部同步对象。
选择 匹配规则,详情请参见 配置匹配规则。
单击 下一步。在 同步选项 页面,配置各项参数。
参数
描述
增量同步起始位点
如果选择同步类型时已选择 全量同步,此处默认为增量同步启动时间,不支持修改。
如果选择同步类型时未选择 全量同步,请在此处指定同步某个时间节点之后的数据,默认为当前系统时间。详情请参见 设置增量同步位点。
目标端表对象存在记录时处理策略
在 选择同步类型 页面,选中 全量同步,才会显示该参数。处理策略包括 忽略 和 停止迁移:
选择 忽略:目标端表对象存在数据时,如果原数据与写入数据冲突,数据传输采用将冲突数据记录日志,保留原数据不变的策略进行数据写入。
重要选择 忽略,全量校验将使用 IN 模式拉取数据,无法校验目标端多数据的场景,并且校验性能存在一定程度降级。
选择默认值 停止迁移:当目标端表对象存在数据时,全量迁移会报错不允许迁移,请处理好目标端数据后再继续迁移。
重要如果出错后单击恢复,数据传输将忽略该配置选项,继续迁移表数据,请谨慎操作。
单击 预检查。
在 预检查 环节,数据传输会检测逻辑表 Schema 和物理表 Schema 是否一致。目前仅检查列名、列类型,以及是否为空,不检查长度和默认值。如果预检查报错:
您可以在排查并处理问题后,重新执行预检查,直至预检查成功。
您也可以单击错误预检查项操作列中的 跳过,会弹出对话框提示您跳过本操作的具体影响,确认可以跳过后,请单击对话框中的 确定。
预检查成功后,单击 启动项目。
如果您暂时无需启动项目,请单击 保存。后续您只能在 同步项目列表 页面手动启动项目或通过批量操作启动项目。批量操作的详情请参见 批量操作数据同步项目。
数据传输支持在数据同步项目运行过程中修改同步对象,详情请参见 查看和修改同步对象。数据同步项目启动后,会根据选择的同步类型依次执行,详情请参见 查看同步详情。
如果数据同步项目运行报错(通常由于网络不通或进程启动过慢导致),您可以在数据同步项目的列表或详情页面,单击 恢复。
相关文档
- 本页导读 (0)