TiDB Lightning 部署与执行

    如果使用 Local-backend 进行数据导入，TiDB Lightning 运行后，TiDB 集群将无法正常对外提供服务。如果你不希望 TiDB 集群的对外服务受到影响，可以参考 TiDB Lightning TiDB-backend 中的硬件需求与部署方式进行数据导入。

    在使用 TiDB Lightning 前，需注意以下事项：

    • 若 tidb-lightning 崩溃，集群会留在“导入模式”。若忘记转回“普通模式”，集群会产生大量未压缩的文件，继而消耗 CPU 并导致延迟。此时，需要使用 tidb-lightning-ctl 手动将集群转回“普通模式”：

    • TiDB Lightning 需要下游 TiDB 有如下权限：

      | 权限 | 作用域 | |:——|:———| | SELECT | Tables | | INSERT | Tables | | UPDATE | Tables | | DELETE | Tables | | CREATE | Databases, tables | | DROP | Databases, tables | | ALTER | Tables |

      如果配置项 checksum = true，则 TiDB Lightning 需要有下游 TiDB admin 用户权限。

    • 32+ 逻辑核 CPU
    • 20GB+ 内存
    • 足够储存整个数据源的 SSD 硬盘，读取速度越快越好
    • 使用万兆网卡，带宽需要 1GB/s 以上

    此外，目标 TiKV 集群必须有足够空间接收新导入的数据。除了以外，目标 TiKV 集群的总存储空间必须大于 数据源大小 × 副本数量 × 2。例如集群默认使用 3 副本，那么总存储空间需为数据源大小的 6 倍以上。

    使用 从 MySQL 导出数据，如下：

    其中：

    • -B test：从 test 数据库导出。
    • -f test.t[12]：只导出 test.t1 和 test.t2 这两个表。
    • ：使用 16 个线程导出数据。
    • -F 256MB：将每张表切分成多个文件，每个文件大小约为 256 MB。

    如果数据源是 CSV 文件，请参考 CSV 支持获取配置信息。

    本节介绍 TiDB Lightning 的部署方式：。

    第 1 步：部署 TiDB 集群

    第 2 步：下载 TiDB Lightning 安装包

    在工具下载页面下载 TiDB Lightning 安装包（TiDB Lightning 完全兼容较低版本的 TiDB 集群，建议选择最新稳定版本）。

    第 3 步：启动 tidb-lightning

    1. 从安装包上传 bin/tidb-lightning 及 bin/tidb-lightning-ctl。

    2. 将数据源写入到同样的机器。

    3. 运行 tidb-lightning。如果直接在命令行中用 启动程序，可能会因为 SIGHUP 信号而退出，建议把 nohup 放到脚本里面，如：

    如果当前有运行的导入任务，推荐任务完成后再升级 TiDB Lightning。否则，你可能需要从头重新导入，因为无法保证断点可以跨版本工作。