Skip to content

Commit 8d853ce

Browse files
authored
sys var: clarify the description of tidb_ddl_reorg_max_write_speed (#20042)
1 parent 01c6635 commit 8d853ce

File tree

1 file changed

+8
-5
lines changed

1 file changed

+8
-5
lines changed

system-variables.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1519,11 +1519,14 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1;
15191519
- 作用域:GLOBAL
15201520
- 是否持久化到集群:是
15211521
- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制:否
1522-
- 类型:整数型
1522+
- 类型:字符串
15231523
- 默认值:`0`
1524-
- 范围:`[0, 1125899906842624]`(即最大可设置为 1 PiB)
1524+
- 范围:`[0, 1PiB]`
15251525
- 这个变量用于限制每个 TiKV 节点写入的带宽,仅在开启添加索引加速功能时生效(由变量 [`tidb_ddl_enable_fast_reorg`](#tidb_ddl_enable_fast_reorg-从-v630-版本开始引入) 控制)。在数据量特别大的情况下(如数十亿行数据),降低加索引时写入 TiKV 节点的带宽可以有效减少对业务负载的影响。
1526-
- 默认值 `0` 表示不限制写入带宽。默认单位为字节每秒,也可以通过 `'1GiB'``'256MiB'` 等格式设置该变量。
1526+
- 默认值 `0` 表示不限制写入带宽。
1527+
- 该变量可设置为带单位的格式或不带单位的格式。
1528+
- 当该变量值不带单位时,默认单位为字节每秒。例如 `67108864` 表示 `64MiB` 每秒。
1529+
- 当该变量值带单位时,支持的单位包括 KiB、MiB、GiB、TiB。例如,`'1GiB'` 表示 1 GiB 每秒, `'256MiB'` 表示 256 MiB 每秒。
15271530

15281531
### `tidb_ddl_reorg_worker_cnt`
15291532

@@ -1546,7 +1549,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1;
15461549
- 默认值:`ON`。在 v8.5.0 之前,默认值为 `OFF`
15471550
- 这个变量用于控制是否开启 [TiDB 加速建表](/accelerated-table-creation.md)。
15481551
- 从 TiDB v8.0.0 开始,支持使用 `tidb_enable_fast_create_table` 加速建表 [`CREATE TABLE`](/sql-statements/sql-statement-create-table.md)。
1549-
- 该变量是由 v7.6.0 中引入的 [`tidb_ddl_version`](https://docs.pingcap.com/zh/tidb/v7.6/system-variables#tidb_ddl_version-从-v760-版本开始引入) 更名而来。从 v8.0.0 开始,`tidb_ddl_version` 不再生效。
1552+
- 该变量是由 v7.6.0 中引入的 [`tidb_ddl_version`](https://docs-archive.pingcap.com/zh/tidb/v7.6/system-variables#tidb_ddl_version-从-v760-版本开始引入) 更名而来。从 v8.0.0 开始,`tidb_ddl_version` 不再生效。
15501553
- 从 TiDB v8.5.0 开始,新创建的集群默认开启 TiDB 加速建表功能,即 `tidb_enable_fast_create_table` 默认值为 `ON`。如果从 v8.4.0 及之前版本的集群升级至 v8.5.0 及之后的版本,`tidb_enable_fast_create_table` 的默认值不发生变化。
15511554

15521555
### `tidb_default_string_match_selectivity` <span class="version-mark">从 v6.2.0 版本开始引入</span>
@@ -4225,7 +4228,7 @@ SHOW WARNINGS;
42254228
>
42264229
> - 视具体业务场景的不同,启用该选项可能对存在频繁锁冲突的事务造成一定程度的吞吐下降(平均延迟上升)。
42274230
> - 该选项目前仅对需要上锁单个 key 的语句有效。如果一个语句需要对多行同时上锁,则该选项不会对此类语句生效。
4228-
> - 该功能从 v6.6.0 版本引入。在 v6.6.0 版本中,该功能由变量 [`tidb_pessimistic_txn_aggressive_locking`](https://docs.pingcap.com/zh/tidb/v6.6/system-variables#tidb_pessimistic_txn_aggressive_locking-%E4%BB%8E-v660-%E7%89%88%E6%9C%AC%E5%BC%80%E5%A7%8B%E5%BC%95%E5%85%A5) 控制,默认关闭。
4231+
> - 该功能从 v6.6.0 版本引入。在 v6.6.0 版本中,该功能由变量 [`tidb_pessimistic_txn_aggressive_locking`](https://docs-archive.pingcap.com/zh/tidb/v6.6/system-variables#tidb_pessimistic_txn_aggressive_locking--v660-版本开始引入) 控制,默认关闭。
42294232

42304233
### `tidb_placement_mode` <span class="version-mark">从 v6.0.0 版本开始引入</span>
42314234

0 commit comments

Comments
 (0)