tencent cloud

TDSQL Boundless

产品动态
产品简介
产品概述
应用场景
产品架构
实例类型
兼容性说明
使用规范建议
自研内核
内核概述
内核版本更新动态
功能类特性
性能类特性
产品计费
计费概述
购买方式
价格详情
续费说明
欠费说明
退费说明
快速入门
创建实例
连接实例
用户指南
数据迁移
数据同步/订阅
实例管理
参数配置
账号管理
安全组
备份与恢复
数据库审计
标签管理
实践教程
Online DDL 的技术演进与使用实践
锁机制解析与问题排查实践
数据智能调度及相关性能优化实践
TDSQL Boundless 选型指南与实践教程
开发指南
开发指南(MySQL 兼容模式)
开发指南(HBase 兼容模式)
性能调优
性能调优概述
SQL 调优
DDL 调优
性能白皮书
性能概述
TPC-C 测试
Sysbench 测试
API 文档
History
Introduction
API Category
Making API Requests
Instance APIs
Security Group APIs
Task APIs
Backup APIs
Rollback APIs
Parameter APIs
Database APIs
Data Types
Error Codes
通用参考
系统原理
SQL 参考
数据库参数说明
TPC-H 基准测试数据模型参考
错误码信息
安全与合规
常见问题
服务协议
服务等级协议
服务条款
隐私政策
数据处理和安全协议
联系我们
词汇表
文档TDSQL Boundless用户指南数据迁移从小数据量 TiDB 实例迁移至 TDSQL Boundless

从小数据量 TiDB 实例迁移至 TDSQL Boundless

PDF
聚焦模式
字号
最后更新时间: 2026-03-06 18:50:07
Dumpling 是一个可以将 TiDB 数据导出为 SQL 或 CSV 文件的工具。本文介绍如何使用 Dumpling 从 TiDB 自建集群导出全量数据。

前置准备

1. 部署环境准备
推荐在与待迁移 MySQL/TiDB 和 TDSQL Boundless 实例网络互通的服务器上部署 Dumpling。
2. 使用 TiUP 部署 Dumpling
## 部署 TiUP
curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh
source /root/.bash_profile

## 部署 Dumpling 并升级到最新版本
tiup install dumpling
tiup update --self && tiup update dumpling
3. 配置 Dumpling 所需权限
你需要以下权限才能从上游数据库导出数据:
SELECT
RELOAD
LOCK TABLES
REPLICATION CLIENT
PROCESS

操作步骤

如下示例将展示如何使用 Dumpling 从 TiDB 中导出 SQL 文件并通过社区工具 myloader 导入 TDSQL Boundless,并开启 TiCDC 进行增量同步。
1. 临时关闭上游 TiDB 自建集群的 GC 机制。
为确保增量迁移期间新写入的数据不会丢失,在开始迁移前需要关闭上游集群的垃圾回收(GC)机制,防止系统清理历史数据。
运行以下命令,验证设置是否成功。
SET GLOBAL tidb_gc_enable = FALSE;
验证设置是否成功:
SELECT @@global.tidb_gc_enable;
以下为示例输出,其中0表示已关闭。
+-------------------------+
| @@global.tidb_gc_enable |
+-------------------------+
| 0 |
+-------------------------+
1 row in set (0.00 sec)
2. 运行 Dumpling,将全量数据导出为 SQL 文件。
tiup dumpling -u root -P 4000 -h tidb_host -o /tmp/test
Dumpling 默认导出格式为 SQL 文件。如需部分数据导出或者进行过滤,可参考 Dumpling 使用说明。
3. 检查导出数据。
通常导出的数据包括以下内容:
metadata:包含导出起始时间和主库 binlog 位置
{schema}-schema-create.sql:创建 schema 的 SQL 文件
{schema}.{table}-schema.sql:创建表的 SQL 文件
{schema}.{table}.{0001}.{sql|csv}:数据文件
*-schema-view.sql、*-schema-trigger.sql、*-schema-post.sql:其他导出的 SQL 文件
以如下 metadata 文件为例:
Started dump at: 2025-12-02 12:42:53
SHOW MASTER STATUS:
Log: tidb-binlog
Pos: 462583122654920710
GTID:

Finished dump at: 2025-12-02 12:42:53
其中 Pos 后数字为导出所使用的 TiDB 时间戳,该时间戳将用于后续增量迁移设置 TiCDC 回放起点。
4. 导入数据
使用 myloader 工具进行导入。下例中 -d 所使用的目录为前例中 Dumpling 所导出的目录。
myloader -h tdsql_host -P 3306 --user tdsqluser -d /tmp/test
5. 通过 TiCDC 进行增量同步。如下例子中,将start-ts设为从 Dumpling metadata 中获取的时间戳。详情可参考 TiDB 官方说明
tiup cdc cli changefeed create --server=http://ticdc_host:8300 --sink-uri='mysql://tdsql_user@tdsql_host:3306' --changefeed-id="upstream-to-downstream" --start-ts="462583122654920710"
6. 恢复 TiDB 的 GC 行为,并检查设置成功与否。
SET GLOBAL tidb_gc_enable = TRUE;
验证恢复成功:
SELECT @@global.tidb_gc_enable;
预期输出为1,表示已开启:
+-------------------------+
| @@global.tidb_gc_enable |
+-------------------------+
| 1 |
+-------------------------+
1 row in set (0.00 sec)

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈