TiDB Lightning 命令行参数
你可以使用配置文件或命令行配置 TiDB Lightning。本文主要介绍 TiDB Lightning 的命令行参数。
命令行参数
tidb-lightning
使用 tidb-lightning
可以对下列参数进行配置:
参数 | 描述 | 对应配置项 |
---|---|---|
—config file | 从 file 读取全局设置。如果没有指定则使用默认设置。 | |
-V | 输出程序的版本 | |
-d directory | 读取数据的本地目录或外部存储 URI | mydumper.data-source-dir |
-L level | 日志的等级: debug、info、warn、error 或 fatal (默认为 info) | lightning.log-level |
-f rule | 表库过滤的规则 (可多次指定) | mydumper.filter |
—backend backend | 选择导入的模式:local 为物理导入模式,tidb 为逻辑导入模式 | tikv-importer.backend |
—log-file file | 日志文件路径(默认值为 /tmp/lightning.log.{timestamp} ,设置为 ‘-‘ 表示日志输出到终端) | lightning.log-file |
—status-addr ip:port | TiDB Lightning 服务器的监听地址 | lightning.status-port |
—importer host:port | TiKV Importer 的地址 | tikv-importer.addr |
—pd-urls host:port | PD endpoint 的地址 | tidb.pd-addr |
—tidb-host host | TiDB Server 的 host | tidb.host |
—tidb-port port | TiDB Server 的端口(默认为 4000) | tidb.port |
—tidb-status port | TiDB Server 的状态端口的(默认为 10080) | tidb.status-port |
—tidb-user user | 连接到 TiDB 的用户名 | tidb.user |
—tidb-password password | 连接到 TiDB 的密码,可为明文或 Base64 编码 | tidb.password |
—enable-checkpoint bool | 是否启用断点 (默认值为 true) | checkpoint.enable |
—analyze level | 导入后分析表信息,可选值为 required、optional(默认值)、off | post-restore.analyze |
—checksum level | 导入后比较校验和,可选值为 required(默认值)、optional、off | post-restore.checksum |
—check-requirements bool | 开始之前检查集群版本兼容性(默认值为 true) | lightning.check-requirements |
—ca file | TLS 连接的 CA 证书路径 | security.ca-path |
—cert file | TLS 连接的证书路径 | security.cert-path |
—key file | TLS 连接的私钥路径 | security.key-path |
—server-mode | 在服务器模式下启动 TiDB Lightning | lightning.server-mode |
如果同时对命令行参数和配置文件中的对应参数进行更改,命令行参数将优先生效。例如,在 cfg.toml
文件中,不管对日志等级做出什么修改,运行 ./tidb-lightning -L debug --config cfg.toml
命令总是将日志级别设置为 “debug”。
tidb-lightning-ctl
所有 tidb-lightning
的参数也适用于 tidb-lightning-ctl
。此外,使用 tidb-lightning-ctl
还可以对下列参数进行配置:
参数 | 描述 |
---|---|
—compact | 执行 full compact |
—switch-mode mode | 将每个 TiKV Store 切换到指定模式(normal 或 import) |
—fetch-mode | 打印每个 TiKV Store 的当前模式 |
—import-engine uuid | 将 TiKV Importer 上关闭的引擎文件导入到 TiKV 集群 |
—cleanup-engine uuid | 删除 TiKV Importer 上的引擎文件 |
—checkpoint-dump folder | 将当前的断点以 CSV 格式存储到文件夹中 |
—checkpoint-error-destroy tablename | 删除断点,如果报错则删除该表 |
—checkpoint-error-ignore tablename | 忽略指定表中断点的报错 |
—checkpoint-remove tablename | 无条件删除表的断点 |
tablename 必须是`db`.`tbl`
中的限定表名(包括反引号),或关键词 all
。