--- title: "使用 CloudCanal 从 MySQL 数据库迁移数据到 OceanBase 数据库 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: 使用 CloudCanal 从 MySQL 数据库迁移数据到 OceanBase 数据库 CloudCanal 是一款数据迁移同步工具，帮助企业快速构建高质量数据流通通道，产品包含 SaaS 模式和私有输出专享模式。开发团队核心成员来自大厂，具备数据库内核、大规模分布式系统、云产品构建背景，懂数据库，懂分布式，懂云产… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # 使用 CloudCanal 从 MySQL 数据库迁移数据到 OceanBase 数据库 更新时间：2026-07-03 10:23:40 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/500.data-migration/200.migrate-data-from-mysql-database-to-oceanbase-database/400.use-cloudcanal-to-migrate-data-from-mysql-database-to-oceanbase-database.md) CloudCanal 是一款数据迁移同步工具，帮助企业快速构建高质量数据流通通道，产品包含 SaaS 模式和私有输出专享模式。开发团队核心成员来自大厂，具备数据库内核、大规模分布式系统、云产品构建背景，懂数据库，懂分布式，懂云产品商业和服务模式。 本文将介绍如何使用 CloudCanal 社区版 v2.2.5.36 将 MySQL 数据库中的数据同步到目标端 OceanBase 数据库 MySQL 模式中。 #### 功能适用性 - CloudCanal 社区版从 v2.2.0.7 版本开始支持从 MySQL 数据库迁移数据至 OceanBase 数据库 MySQL 模式。详情请参见 [v2.2.0.7](https://www.clougence.com/cc-doc/releaseNote/rn-cloudcanal-2-2-0-7)。 - CloudCanal 暂时只支持 MySQL 数据库 V5.6 之后的版本作为源库。 ## 前置条件 参考 [全新安装(Linux/MacOS)](https://www.clougence.com/cc-doc/productOP/docker/install_linux_macos) 完成 CloudCanal 社区版的安装部署以及申请免费 License 并激活。 ## 数据迁移操作步骤 1. 添加数据源。 2. 创建任务。 3. 查看任务。 ### 添加数据源 1. 登录 CloudCanal 平台。 ![CloudCanal登录](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/%E7%99%BB%E5%BD%95CloudCanal.png) 2. 进入数据源管理界面，点击新增数据源。 ![新增数据源](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/1%E6%96%B0%E5%A2%9E%E6%95%B0%E6%8D%AE%E6%BA%90.png) 3. 在新增数据源页面，填写数据源信息。 - 部署类型：有 **自建数据库** 和 **阿里云**。 - 阿里云：用户在阿里云上购买的数据库实例。 - 自建数据库：用户自己部署的数据库实例。 - 数据库类型：选择数据源类型。 新增两个数据源 MySQL 和 OceanBase，分别作为同步的源库和目标库： - 选择自建数据库中 MySQL，添加自己部署的 MySQL 数据库实例。 MySQL 数据源设置： - 网络地址：填写 MySQL 数据库的 IP。 - 认证方式：有 **账号密码**、**有账号密码** 和 **无账号密码** 三种方式。默认 **账号密码** 方式。 - 账号：连接 MySQL 数据库的用户名。 - 密码：连接 MySQL 数据库的用户名对应的密码。 - 描述：选填项，备注便于记忆的名字，方便使用时识别，如交易库、用户库、测试库等。 ![MySQL](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/2MySQL%E6%BA%90%E5%BA%93.png) - 选择自建数据库中 OceanBase，添加自己部署的 OceanBase 数据库实例。 OceanBase 数据源设置： - 网络地址：填写连接 OceanBase 数据库的 IP，直连或通过 ODP 连接。 - oblogproxy host：OceanBase Binglog 服务 的 IP 地址。OceanBase 数据库作为源库增量同步时，不可以为空；OceanBase 数据库作为目标库时，可为空。有关 OceanBase Binlog 服务的详细信息，请参考 [OceanBase Binlog 服务](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682666)。 - OceanBaseRpcPort：OceanBase Rpc 端口，默认 2882。 - 认证方式：分别为 **账号密码**、**有账号密码** 和 **无账号密码**。默认账号密码。 - 账号：连接 OceanBase 数据库的用户名。直连格式：**用户名@租户名称**；ODP 连接格式：**用户名@租户名称#集群名称**。 - 密码：连接 OceanBase 数据库的用户名对应的密码。 - 描述：选填项，备注便于记忆的名字，方便使用时识别，如交易库、用户库、测试库等。 ![OceanBase](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/3OB%E7%9B%AE%E6%A0%87%E5%BA%93.png) 4. 查看新增的两个数据源。 ![查看数据源](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/4%E6%95%B0%E6%8D%AE%E6%BA%90%E5%B1%95%E7%A4%BA.png) ### 创建任务 添加好数据源之后可以按照如下步骤进行数据全量迁移、增量同步和结构迁移。 1. 任务管理 -> 创建任务。 ![任务管理](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/5%E4%BB%BB%E5%8A%A1%E7%AE%A1%E7%90%86.png) 2. 源库和目标库设置。 - 选择 **任务运行集群**，任务会被调度到绑定集群的一台机器上执行。社区版部署完成后，会有一个默认的运行集群。 - 选择源库 MySQL 和目标数据库 OceanBase，并点击 **测试连接**。 - 选择需要 **迁移同步或校验的数据库**，指定数据库映射关系。 - 完成设置后点击 **下一步**。 ![源目标设置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/6%E6%BA%90%E7%9B%AE%E6%A0%87%E8%AE%BE%E7%BD%AEmysql-to-ob.png) 3. 功能配置。 选择 **增量同步** 功能，第一次会先查表进行全量同步，之后消费 binlog 增量同步数据。 - 任务类型具有以下功能： - 全量迁移：以数据迁移为主，适合数据的全量搬迁及短期的增量同步任务。 - 增量同步：默认选项，默认附带 **全量初始化**。以数据同步为主，适合长期的增量同步任务。 - 数据校验：对比源端与目标端的数据，一次性或定时多次校验数据迁移的准确性。社区版不支持此功能。 - 结构迁移：根据所选数据库、表自动创建对应的数据库、表。 - 数据订正：对比源端与目标端的数据，将不一致的数据自动覆盖成和源端一致。社区版不支持此功能。 - 任务规格：默认 **平衡型**、**2G** 规格即可。 - 完成配置后，点击 **下一步**。 ![功能配置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/7%E5%8A%9F%E8%83%BD%E9%85%8D%E7%BD%AE.png) 4. 表&action 过滤。 - 选择要同步的表，要保证目标库的 `UPDATE` 和 `DELETE` 操作和源库的一致，需要保证源库表中有主键或者唯一约束。 - 完成配置后，点击 **下一步**。 ![表&action过滤](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/8%E8%A1%A8%26action%E8%BF%87%E6%BB%A4_%E5%A2%9E%E9%87%8F%E5%90%8C%E6%AD%A5.png) 5. 数据处理。 - 选择表中要同步的列。 - 完成设置后，点击 **下一步**。 ![数据处理](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/9%E6%95%B0%E6%8D%AE%E5%A4%84%E7%90%86.png) 6. 确认创建任务。 最后一步，确认创建内容无误后点击确认创建。 ![创建确认](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/10%E7%A1%AE%E8%AE%A4%E5%88%9B%E5%BB%BA%E4%BB%BB%E5%8A%A1.png) ### 查看任务状态 任务创建成功后，会默认进行结构迁移、全量迁移、增量同步，进度条会逐步发生变化。回到 CloudCanal 任务管理控制台，刷新并查看任务实时状态，从结构迁移、数据初始化，到数据同步。 ![查看任务](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.0.0/data-migration/CloudCanal/cloudcanal2.2.5.36/11%E6%9F%A5%E7%9C%8B%E4%BB%BB%E5%8A%A1.png) ## 相关文档 有关 CloudCanal 的详细信息，请参见 [CloudCanal 官方文档](https://www.clougence.com/cc-doc/intro/product_intro/)。 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线