diff --git a/tidb-lightning/tidb-lightning-configuration.md b/tidb-lightning/tidb-lightning-configuration.md index e6f34946785f..83058b43fbe7 100644 --- a/tidb-lightning/tidb-lightning-configuration.md +++ b/tidb-lightning/tidb-lightning-configuration.md @@ -303,8 +303,8 @@ pd-addr = "172.16.31.4:2379" # 设置 TiDB 库的日志等级。 log-level = "error" -# 设置 TiDB 会话变量,提升 Checksum 和 Analyze 的速度。 -# 各参数定义可参阅”控制 Analyze 并发度“文档 +# 设置 TiDB 会话变量,提升 Checksum 和 Analyze 的速度。注意,如果将 checksum-via-sql 设置为 "true",则会通过 TiDB 执行 ADMIN CHECKSUM TABLE SQL 语句来进行 Checksum 操作。在这种情况下,以下参数设置 `distsql-scan-concurrency = 15` 和 `checksum-table-concurrency = 2` 将不会生效。 +# 各参数定义可参阅 “控制 Analyze 并发度文档” (https://docs.pingcap.com/zh/tidb/stable/statistics#%E6%8E%A7%E5%88%B6-analyze-%E5%B9%B6%E5%8F%91%E5%BA%A6)。 build-stats-concurrency = 20 distsql-scan-concurrency = 15 index-serial-scan-concurrency = 20 @@ -350,6 +350,11 @@ max-allowed-packet = 67_108_864 # 1. Checksum 对比失败通常表示导入异常(数据丢失或数据不一致),因此建议总是开启 Checksum。 # 2. 考虑到与旧版本的兼容性,依然可以在本配置项设置 `true` 和 `false` 两个布尔值,其效果与 `required` 和 `off` 相同。 checksum = "required" +# 设置是否通过 TiDB 执行 ADMIN CHECKSUM TABLE
操作。 +# 默认值为 "false",表示通过 TiDB Lightning 下发 ADMIN CHECKSUM TABLE
命令给 TiKV 执行。 +# 建议将该值设为 "true",以便在 checksum 失败时更容易定位问题。 +# 同时,当该值为 "true" 时,如果需要调整并发,请在 TiDB 中设置 `tidb_checksum_table_concurrency` 变量 (https://docs.pingcap.com/zh/tidb/stable/system-variables#tidb_checksum_table_concurrency)。 +checksum-via-sql = "false" # 配置是否在 CHECKSUM 结束后对所有表逐个执行 `ANALYZE TABLE
` 操作。 # 此配置的可选配置项与 `checksum` 相同,但默认值为 "optional"。 analyze = "optional"