Skip to content

Commit 6fa5993

Browse files
en-jin19ti-chi-bot
authored andcommitted
This is an automated cherry-pick of pingcap#7432
Signed-off-by: ti-chi-bot <ti-community-prow-bot@tidb.io>
1 parent baf8916 commit 6fa5993

File tree

1 file changed

+31
-6
lines changed

1 file changed

+31
-6
lines changed

system-variables.md

Lines changed: 31 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -622,6 +622,24 @@ MPP 是 TiFlash 引擎提供的分布式计算框架,允许节点之间的数
622622
>
623623
> 该变量只有在默认值 `OFF` 时,才算是安全的。因为设置 `tidb_enable_noop_functions=1` 后,TiDB 会自动忽略某些语法而不报错,这可能会导致应用程序出现异常行为。例如,允许使用语法 `START TRANSACTION READ ONLY` 时,事务仍会处于读写模式。
624624

625+
<<<<<<< HEAD
626+
=======
627+
### `tidb_enable_parallel_apply` <span class="version-mark">从 v5.0 版本开始引入</span>
628+
629+
- 作用域:SESSION | GLOBAL
630+
- 默认值:0
631+
- 这个变量用于控制是否开启 Apply 算子并发,并发数由 `tidb_executor_concurrency` 变量控制。Apply 算子用来处理关联子查询且默认无并发,所以执行速度较慢。打开 Apply 并发开关可增加并发度,提高执行速度。目前默认关闭。
632+
633+
### `tidb_enable_pseudo_for_outdated_stats` <span class="version-mark">从 v5.3.0 版本开始引入</span>
634+
635+
- 作用域:SESSION | GLOBAL
636+
- 默认值:`ON`
637+
- 这个变量用来控制优化器在一张表上的统计信息过期时的行为。
638+
- 统计信息过期的判断标准:最近一次对某张表执行 `ANALYZE` 获得统计信息后,该表数据被修改的行数大于该表总行数的 80%,便可判定该表的统计信息已过期。该比例可通过 [`pseudo-estimate-ratio`](/tidb-configuration-file.md#pseudo-estimate-ratio) 配置参数调整。
639+
- 默认情况下(即该变量值为 `ON` 时),某张表上的统计信息过期后,优化器认为该表上除总行数以外的统计信息不再可靠,转而使用 pseudo 统计信息。将该变量值设为 `OFF` 后,即使统计信息过期,优化器也仍会使用该表上的统计信息。
640+
- 如果表数据修改较频繁,没有及时对表执行 `ANALYZE`,但又希望执行计划保持稳定,可以将该变量值设为 `OFF`
641+
642+
>>>>>>> d545f7cfb (revise the order of system variables into alphabetical order (#7432))
625643
### `tidb_enable_rate_limit_action`
626644

627645
- 作用域:SESSION | GLOBAL
@@ -673,18 +691,25 @@ Query OK, 0 rows affected (0.09 sec)
673691
- `AUTO` 目前作用和 `ON` 一样。
674692
- `OFF` 表示关闭 `TABLE PARTITION` 特性,此时语法还是保持兼容,只是创建的表并不是真正的分区表,而是普通的表。
675693

676-
### `tidb_enable_parallel_apply` <span class="version-mark">从 v5.0 版本开始引入</span>
677-
678-
- 作用域:SESSION | GLOBAL
679-
- 默认值:0
680-
- 这个变量用于控制是否开启 Apply 算子并发,并发数由 `tidb_executor_concurrency` 变量控制。Apply 算子用来处理关联子查询且默认无并发,所以执行速度较慢。打开 Apply 并发开关可增加并发度,提高执行速度。目前默认关闭。
681-
682694
### `tidb_enable_telemetry` <span class="version-mark">从 v4.0.2 版本开始引入</span>
683695

684696
- 作用域:GLOBAL
685697
- 默认值:`ON`
686698
- 这个变量用于动态地控制 TiDB 遥测功能是否开启。设置为 `OFF` 可以关闭 TiDB 遥测功能。当所有 TiDB 实例都设置 [`enable-telemetry`](/tidb-configuration-file.md#enable-telemetry-从-v402-版本开始引入) 为 `false` 时将忽略该系统变量并总是关闭 TiDB 遥测功能。参阅[遥测](/telemetry.md)了解该功能详情。
687699

700+
### `tidb_enable_tso_follower_proxy` <span class="version-mark">从 v5.3 版本开始引入</span>
701+
702+
- 作用域:GLOBAL
703+
- 默认值:`OFF`
704+
- 这个变量用来开启 TSO Follower Proxy 特性。当该值为 `OFF` 时,TiDB 仅会从 PD leader 获取 TSO。开启该特性之后,TiDB 在获取 TSO 时会将请求均匀地发送到所有 PD 节点上,通过 PD follower 转发 TSO 请求,从而降低 PD leader 的 CPU 压力。
705+
- 适合开启 TSO Follower Proxy 的场景:
706+
* PD leader 因高压力的 TSO 请求而达到 CPU 瓶颈,导致 TSO RPC 请求的延迟较高。
707+
* 集群中的 TiDB 实例数量较多,且调高 [`tidb_tso_client_batch_max_wait_time`](/system-variables.md#tidb_tso_client_batch_max_wait_time-从-v53-版本开始引入) 并不能缓解 TSO RPC 请求延迟高的问题。
708+
709+
> **注意:**
710+
>
711+
> 如果 PD leader 未因 CPU 限制达到瓶颈而导致 TSO RPC 延迟升高,打开 TSO Follower Proxy 可能会导致 TiDB 的语句执行延迟上升,从而影响集群的 QPS 表现。
712+
688713
### `tidb_enable_vectorized_expression` <span class="version-mark">从 v4.0 版本开始引入</span>
689714

690715
- 作用域:SESSION | GLOBAL

0 commit comments

Comments
 (0)