title | aliases | ||
---|---|---|---|
TiDB Lightning 教程 |
|
本教程假设使用的是若干新的、纯净版 CentOS 7 实例,你可以(使用 VMware、VirtualBox 及其他工具)在本地虚拟化或在供应商提供的平台上部署一台小型的云虚拟主机。因为 TiDB Lightning 对计算机资源消耗较高,建议分配 16 GB 以上的内存以及 32 核以上的 CPU 以获取最佳性能。
警告:
本教程中的部署方法只适用于测试及功能体验,并不适用于生产或开发环境。
我们使用 dumpling
从 MySQL 导出数据,如下:
{{< copyable "shell-regular" >}}
tiup dumpling -h 127.0.0.1 -P 3306 -u root -t 16 -F 256MB -B test -f 'test.t[12]' -o /data/my_database/
其中:
-B test
:从test
数据库导出。-f test.t[12]
:只导出test.t1
和test.t2
这两个表。-t 16
:使用 16 个线程导出数据。-F 256MB
:将每张表切分成多个文件,每个文件大小约为 256 MB。
这样全量备份数据就导出到了 /data/my_database
目录中。
在开始数据导入之前,需先部署一套要进行导入的 TiDB 集群。本教程以 TiDB v5.4.0 版本为例,具体部署方法可参考使用 TiUP 部署 TiDB 集群。
TiDB Lightning 的安装包位于 TiDB 离线工具包中。下载方式,请参考 TiDB 工具下载。
-
将安装包里的
bin/tidb-lightning
及bin/tidb-lightning-ctl
上传至部署 TiDB Lightning 的服务器。 -
将数据源也上传到同样的服务器。
-
配置
tidb-lightning.toml
。[lightning] # 日志 level = "info" file = "tidb-lightning.log" [tikv-importer] # 选择使用的导入模式 backend = "local" # 设置排序的键值对的临时存放地址,目标路径需要是一个空目录 sorted-kv-dir = "/mnt/ssd/sorted-kv-dir" [mydumper] # 源数据目录。 data-source-dir = "/data/my_datasource/" # 配置通配符规则,默认规则会过滤 mysql、sys、INFORMATION_SCHEMA、PERFORMANCE_SCHEMA、METRICS_SCHEMA、INSPECTION_SCHEMA 系统数据库下的所有表 # 若不配置该项,导入系统表时会出现“找不到 schema”的异常 filter = ['*.*', '!mysql.*', '!sys.*', '!INFORMATION_SCHEMA.*', '!PERFORMANCE_SCHEMA.*', '!METRICS_SCHEMA.*', '!INSPECTION_SCHEMA.*'] [tidb] # 目标集群的信息 host = "172.16.31.2" port = 4000 user = "root" password = "rootroot" # 表架构信息在从 TiDB 的“状态端口”获取。 status-port = 10080 # 集群 pd 的地址 pd-addr = "172.16.31.3:2379"
-
配置合适的参数运行
tidb-lightning
。如果直接在命令行中用nohup
启动程序,可能会因为 SIGHUP 信号而退出,建议把nohup
放到脚本里面,如:{{< copyable "shell-regular" >}}
#!/bin/bash nohup tiup tidb-lightning -config tidb-lightning.toml > nohup.out &
导入完毕后,TiDB Lightning 会自动退出。若导入成功,日志的最后一行会显示 tidb lightning exit
。
如果出错,请参见 TiDB Lightning 常见问题。
本教程对 TiDB Lightning 进行了简单的介绍,并快速部署了一套简单的 TiDB Lightning 集群,将全量备份数据导入到 TiDB 集群中。
关于 TiDB Lightning 的详细功能和使用,参见 TiDB Lightning 简介。