From 862df04e3c215fa0011e45069ea295351ea3262f Mon Sep 17 00:00:00 2001 From: xixirangrang <35301108+hfxsd@users.noreply.github.com> Date: Wed, 31 Aug 2022 16:39:23 +0800 Subject: [PATCH 01/13] Update dev-guide-use-fastscan.md --- develop/dev-guide-use-fastscan.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/develop/dev-guide-use-fastscan.md b/develop/dev-guide-use-fastscan.md index bebdc1067788..d71b3d9bbfdc 100644 --- a/develop/dev-guide-use-fastscan.md +++ b/develop/dev-guide-use-fastscan.md @@ -1,9 +1,9 @@ --- -title: Fast Mode -summary: 介绍通过使用 Fast Mode 来加速 OLAP 场景的查询的方法。 +title: FastScan +summary: 介绍通过使用 FastScan 来加速 OLAP 场景的查询的方法。 --- -# Fast Mode +# FastScan > **警告：** > From b3d61fb3a0629a8605b7969cf21f5ecea1afee83 Mon Sep 17 00:00:00 2001 From: xixirangrang <35301108+hfxsd@users.noreply.github.com> Date: Sun, 23 Apr 2023 11:46:48 +0800 Subject: [PATCH 02/13] Update sql-plan-management.md --- sql-plan-management.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/sql-plan-management.md b/sql-plan-management.md index ec14dba57512..8c4a14d336d0 100644 --- a/sql-plan-management.md +++ b/sql-plan-management.md @@ -432,6 +432,8 @@ SHOW binding_cache status; 自动绑定会对符合捕获条件的查询进行捕获，为符合条件的查询生成相应的绑定。通常用于[升级时的计划回退防护](#升级时的计划回退防护)。 +Plan Baseline 是一组被允许用于 SQL 语句优化器的可接受计划。在典型的应用场景中，数据库仅在验证计划的表现良好后才将其添加到计划 Baseline 中。在这种情况下，计划包括所有与计划相关的信息（例如，SQL计划标识符、提示集、绑定值和优化器环境），优化器需要这些信息才能重新生成执行计划。 + ### 使用方式 通过将 `tidb_capture_plan_baselines` 的值设置为 `on`（其默认值为 `off`）可以打开自动捕获绑定功能。 From e15762085f8b1f1760d42add7e38001631809d99 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Mon, 26 Aug 2024 10:07:22 +0800 Subject: [PATCH 03/13] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index f961962f4633..d0f85f382233 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,8 @@ | 文档仓库 branch | 对应 TiDB 文档版本 | |:---------|:----------| | [`master`](https://github.com/pingcap/docs-cn/tree/master) | dev 最新开发版 | +| [`release-8.3`](https://github.com/pingcap/docs-cn/tree/release-8.3) | 8.3 开发里程碑版 (DMR) | +| [`release-8.2`](https://github.com/pingcap/docs-cn/tree/release-8.2) | 8.2 开发里程碑版 (DMR) | | [`release-8.1`](https://github.com/pingcap/docs-cn/tree/release-8.1) | 8.1 长期支持版 (LTS) | | [`release-8.0`](https://github.com/pingcap/docs-cn/tree/release-8.0) | 8.0 开发里程碑版 (DMR) | | [`release-7.6`](https://github.com/pingcap/docs-cn/tree/release-7.6) | 7.6 开发里程碑版 (DMR) | From 608d769a34011f41df3ebd81d94468fec3e30099 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Mon, 26 Aug 2024 10:08:40 +0800 Subject: [PATCH 04/13] Revert "Update README.md" This reverts commit e15762085f8b1f1760d42add7e38001631809d99. --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index d0f85f382233..f961962f4633 100644 --- a/README.md +++ b/README.md @@ -15,8 +15,6 @@ | 文档仓库 branch | 对应 TiDB 文档版本 | |:---------|:----------| | [`master`](https://github.com/pingcap/docs-cn/tree/master) | dev 最新开发版 | -| [`release-8.3`](https://github.com/pingcap/docs-cn/tree/release-8.3) | 8.3 开发里程碑版 (DMR) | -| [`release-8.2`](https://github.com/pingcap/docs-cn/tree/release-8.2) | 8.2 开发里程碑版 (DMR) | | [`release-8.1`](https://github.com/pingcap/docs-cn/tree/release-8.1) | 8.1 长期支持版 (LTS) | | [`release-8.0`](https://github.com/pingcap/docs-cn/tree/release-8.0) | 8.0 开发里程碑版 (DMR) | | [`release-7.6`](https://github.com/pingcap/docs-cn/tree/release-7.6) | 7.6 开发里程碑版 (DMR) | From c0f20b886439f8ec232324263140a0b01291abe6 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Mon, 26 Aug 2024 14:37:50 +0800 Subject: [PATCH 05/13] Update keywords.md --- keywords.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/keywords.md b/keywords.md index 7683ad14c40a..bd93faaa2072 100644 --- a/keywords.md +++ b/keywords.md @@ -134,6 +134,7 @@ TiDB 从 v7.5.3 和 v7.6.0 开始提供 [`INFORMATION_SCHEMA.KEYWORDS`](/informa - CHECK (R) - CHECKPOINT - CHECKSUM +- CHECKSUM_CONCURRENCY - CIPHER - CLEANUP - CLIENT @@ -155,6 +156,8 @@ TiDB 从 v7.5.3 和 v7.6.0 开始提供 [`INFORMATION_SCHEMA.KEYWORDS`](/informa - COMPACT - COMPRESSED - COMPRESSION +- COMPRESSION_LEVE +- COMPRESSION_TYPE - CONCURRENCY - CONFIG - CONNECTION @@ -237,6 +240,8 @@ TiDB 从 v7.5.3 和 v7.6.0 开始提供 [`INFORMATION_SCHEMA.KEYWORDS`](/informa - ENABLED - ENCLOSED (R) - ENCRYPTION +- ENCRYPTION_KEYFILE +- ENCRYPTION_METHOD - END - ENFORCED - ENGINE @@ -318,6 +323,7 @@ TiDB 从 v7.5.3 和 v7.6.0 开始提供 [`INFORMATION_SCHEMA.KEYWORDS`](/informa - IDENTIFIED - IF (R) - IGNORE (R) +- IGNORE_STATS - ILIKE (R) - IMPORT - IMPORTS @@ -386,6 +392,7 @@ TiDB 从 v7.5.3 和 v7.6.0 开始提供 [`INFORMATION_SCHEMA.KEYWORDS`](/informa - LINES (R) - LIST - LOAD (R) +- LOAD_STATS - LOCAL - LOCALTIME (R) - LOCALTIMESTAMP (R) @@ -746,6 +753,7 @@ TiDB 从 v7.5.3 和 v7.6.0 开始提供 [`INFORMATION_SCHEMA.KEYWORDS`](/informa - VARCHARACTER (R) - VARIABLES - VARYING (R) +- VECTOR - VIEW - VIRTUAL (R) - VISIBLE @@ -753,6 +761,7 @@ TiDB 从 v7.5.3 和 v7.6.0 开始提供 [`INFORMATION_SCHEMA.KEYWORDS`](/informa W - WAIT +- WAIT_TIFLASH_READY - WARNINGS - WEEK - WEIGHT_STRING @@ -762,6 +771,7 @@ TiDB 从 v7.5.3 和 v7.6.0 开始提供 [`INFORMATION_SCHEMA.KEYWORDS`](/informa - WIDTH - WINDOW (R-Window) - WITH (R) +- WITH_SYS_TABLE - WITHOUT - WORKLOAD - WRITE (R) From f244e679c4925b61e48c692b9a09634cd8a22fef Mon Sep 17 00:00:00 2001 From: houfaxin Date: Mon, 13 Jan 2025 09:02:50 +0800 Subject: [PATCH 06/13] update Percolator link --- best-practices/tidb-best-practices.md | 2 +- tidb-storage.md | 2 +- tso.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/best-practices/tidb-best-practices.md b/best-practices/tidb-best-practices.md index 9bd160c060b0..03c9a61d7fb1 100644 --- a/best-practices/tidb-best-practices.md +++ b/best-practices/tidb-best-practices.md @@ -28,7 +28,7 @@ Raft 是一种一致性协议，能提供强一致的数据复制保证，TiDB ### 分布式事务 -TiDB 提供完整的分布式事务，事务模型是在 [Google Percolator](https://research.google.com/pubs/pub36726.html) 的基础上做了一些优化。具体的实现可以参考[《Percolator 和 TiDB 事务算法》](https://pingcap.com/blog-cn/percolator-and-txn/)这篇文章。本文档只讨论以下几点： +TiDB 提供完整的分布式事务，事务模型是在 [Google Percolator](https://research.google/pubs/large-scale-incremental-processing-using-distributed-transactions-and-notifications/) 的基础上做了一些优化。具体的实现可以参考[《Percolator 和 TiDB 事务算法》](https://pingcap.com/blog-cn/percolator-and-txn/)这篇文章。本文档只讨论以下几点： + 乐观锁 diff --git a/tidb-storage.md b/tidb-storage.md index 0a388b2308a0..52fc18982128 100644 --- a/tidb-storage.md +++ b/tidb-storage.md @@ -104,4 +104,4 @@ KeyN_Version1 -> Value ## 分布式 ACID 事务 -TiKV 的事务采用的是 Google 在 BigTable 中使用的事务模型：[Percolator](https://research.google.com/pubs/pub36726.html)，TiKV 根据这篇论文实现，并做了大量的优化。详细介绍参见[事务概览](/transaction-overview.md)。 +TiKV 的事务采用的是 Google 在 BigTable 中使用的事务模型：[Percolator](https://research.google/pubs/large-scale-incremental-processing-using-distributed-transactions-and-notifications/)，TiKV 根据这篇论文实现，并做了大量的优化。详细介绍参见[事务概览](/transaction-overview.md)。 diff --git a/tso.md b/tso.md index a36d0c77a673..6e21ff5ac935 100644 --- a/tso.md +++ b/tso.md @@ -5,7 +5,7 @@ summary: 了解 TiDB 中的 TimeStamp Oracle (TSO)。 # TiDB 中的 TimeStamp Oracle (TSO) -在 TiDB 中，Placement Driver (PD) 承担着 TSO 时间戳分配器的角色，负责为集群内各组件分配时间戳。这些时间戳用于为事务和数据分配时间标记。该分配机制对于在 TiDB 中启用 [Percolator](https://research.google.com/pubs/pub36726.html) 模型至关重要。Percolator 模型用于支持多版本并发控制（Multi-Version Concurrency Control, MVCC）和[事务管理](/transaction-overview.md)。 +在 TiDB 中，Placement Driver (PD) 承担着 TSO 时间戳分配器的角色，负责为集群内各组件分配时间戳。这些时间戳用于为事务和数据分配时间标记。该分配机制对于在 TiDB 中启用 [Percolator](https://research.google/pubs/large-scale-incremental-processing-using-distributed-transactions-and-notifications/) 模型至关重要。Percolator 模型用于支持多版本并发控制（Multi-Version Concurrency Control, MVCC）和[事务管理](/transaction-overview.md)。 下面示例显示了如何获取 TiDB 当前的 TSO： From a5a86e2750c745d5f0b2cbcdb67f42421626cbcf Mon Sep 17 00:00:00 2001 From: houfaxin Date: Wed, 26 Nov 2025 14:45:37 +0800 Subject: [PATCH 07/13] Update pd-configuration-file.md --- pd-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pd-configuration-file.md b/pd-configuration-file.md index e8dc720afdfd..9723266777f9 100644 --- a/pd-configuration-file.md +++ b/pd-configuration-file.md @@ -14,7 +14,7 @@ PD 配置文件比命令行参数支持更多的选项。你可以在 [conf/conf > **Tip:** > -> 如果你需要调整配置项的值，请参考[修改配置参数](/maintain-tidb-using-tiup.md#修改配置参数)进行操作。 +> PD 初始化后，如果你需要调整配置项的值，请参考 [PD Control 使用说明](/pd-control.md)进行操作。 ### `name` From 89463299c156ea37b6091cbaccf28752eae3f6bc Mon Sep 17 00:00:00 2001 From: houfaxin Date: Wed, 4 Mar 2026 14:20:01 +0800 Subject: [PATCH 08/13] Update system-variables.md --- system-variables.md | 284 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 284 insertions(+) diff --git a/system-variables.md b/system-variables.md index 07c20abe665f..45394ac1cd30 100644 --- a/system-variables.md +++ b/system-variables.md @@ -6067,3 +6067,287 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 类型：布尔型 - 默认值：`ON` - 这个变量用于控制计算[窗口函数](/functions-and-operators/window-functions.md)时是否采用高精度模式。 + +### `authentication_ldap_sasl_user_search_attr` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`uid` +- LDAP SASL 身份验证中用于检索用户的属性名称。 + +### `authentication_ldap_simple_user_search_attr` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`uid` +- LDAP Simple 身份验证中用于检索用户的属性名称。 + +### `plugin_audit_log_buffer_size` + +- 作用域：INSTANCE +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串（只读） +- 默认值：来自 `[instance]` 配置项（代码默认读取 `plugin-audit-log-flush-interval`） +- 审计日志插件相关的实例级只读变量。 + +### `plugin_audit_log_flush_interval` + +- 作用域：INSTANCE +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串（只读） +- 默认值：来自 `[instance]` 配置项（代码默认读取 `plugin-audit-log-flush-interval`） +- 审计日志插件相关的实例级只读变量。 + +### `tidb_analyze_column_options` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`ALL` +- 可选值：`ALL`、`PREDICATE` +- 控制 `ANALYZE` 默认的列选择策略。 + +### `tidb_enable_batch_query_region` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`OFF` +- 控制是否开启批量查询 Region。 + +### `tidb_enable_binding_usage` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`ON` +- 控制是否启用绑定的使用。 + +### `tidb_enable_tiflash_pipeline_model` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`ON` +- 控制 TiFlash Pipeline 模式开关（代码中变量名为 `tidb_enable_tiflash_pipeline_model`）。 + +### `tidb_enable_ts_validation` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`ON` +- 控制是否启用时间戳校验。 + +### `tidb_foreign_key_check_in_shared_lock` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`OFF` +- 控制共享锁场景下外键检查行为。 + +### `tidb_mem_arbitrator_mode` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`disable` +- 可选值：`disable`、`standard`、`priority` +- 设置全局内存仲裁器工作模式。 + +### `tidb_mem_arbitrator_query_reserved` + +- 作用域：SESSION +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：字符串 +- 默认值：`0` +- 控制内存仲裁器为当前查询保留的内存值。 + +### `tidb_mem_arbitrator_soft_limit` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`0` +- 可选值：`0`、`auto`、正整数、`(0,1]` 区间的小数 +- 设置全局内存仲裁器软上限。 + +### `tidb_mem_arbitrator_wait_averse` + +- 作用域：SESSION +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`0` +- 可选值：`0`、`1`、`nolimit` +- 控制会话级内存仲裁等待规避策略。 + +### `tidb_opt_always_keep_join_key` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：布尔型 +- 默认值：`ON` +- 控制优化器是否始终保留 Join Key。 + +### `tidb_opt_cartesian_join_order_threshold` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`0.0` +- 范围：`[0, 18446744073709551615]` +- 控制笛卡尔积 Join 重排序阈值。 + +### `tidb_opt_enable_three_stage_multi_distinct_agg` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`OFF` +- 控制是否启用三阶段多 DISTINCT 聚合优化。 + +### `tidb_opt_group_ndv_skew_ratio` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`0.0` +- 范围：`[0, 1]` +- 控制分组 NDV 倾斜比例参数。 + +### `tidb_opt_index_join_build_v2` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`ON` +- 控制是否启用 Index Join Build V2。 + +### `tidb_opt_index_prune_threshold` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：整数型 +- 默认值：`20` +- 范围：`[-1, 2147483647]` +- 控制索引裁剪阈值。 + +### `tidb_opt_join_reorder_through_sel` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`OFF` +- 控制 Join 重排序是否可穿透选择条件。 + +### `tidb_opt_partial_ordered_index_for_topn` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：枚举型 +- 默认值：`DISABLE` +- 可选值：`DISABLE`、`COST` +- 控制 TopN 的部分有序索引优化策略。 + +### `tidb_opt_risk_eq_skew_ratio` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`0.0` +- 范围：`[0, 1]` +- 控制等值条件风险倾斜比例参数。 + +### `tidb_opt_risk_range_skew_ratio` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`0.0` +- 范围：`[0, 1]` +- 控制范围条件风险倾斜比例参数。 + +### `tidb_opt_scale_ndv_skew_ratio` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`1.0` +- 范围：`[0, 1]` +- 控制 NDV 倾斜缩放比例参数。 + +### `tidb_opt_selectivity_factor` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`0.8` +- 范围：`[0, 1]` +- 控制优化器选择率因子参数。 + +### `tidb_opt_table_rowid_scan_cost_factor` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`1.0` +- 范围：`[0, 18446744073709551615]` +- 控制按 RowID 扫描的代价因子。 + +### `tidb_opt_use_invisible_indexes` + +- 作用域：SESSION +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：布尔型 +- 默认值：`OFF` +- 控制优化器是否使用 Invisible Index。 + +### `tidb_trace_event` + +- 作用域：INSTANCE +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`` +- 实例级 Trace 事件控制变量。 + +### `tiflash_compute_dispatch_policy` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`consistent_hash` +- 可选值：`consistent_hash`、`round_robin` +- 控制 TiFlash Compute 任务分发策略。 From f2f268a6ce1bad312faa6f3d4610f77f03a873ae Mon Sep 17 00:00:00 2001 From: houfaxin Date: Wed, 4 Mar 2026 14:22:20 +0800 Subject: [PATCH 09/13] Revert "Update system-variables.md" This reverts commit 89463299c156ea37b6091cbaccf28752eae3f6bc. --- system-variables.md | 284 -------------------------------------------- 1 file changed, 284 deletions(-) diff --git a/system-variables.md b/system-variables.md index 45394ac1cd30..07c20abe665f 100644 --- a/system-variables.md +++ b/system-variables.md @@ -6067,287 +6067,3 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 类型：布尔型 - 默认值：`ON` - 这个变量用于控制计算[窗口函数](/functions-and-operators/window-functions.md)时是否采用高精度模式。 - -### `authentication_ldap_sasl_user_search_attr` - -- 作用域：GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串 -- 默认值：`uid` -- LDAP SASL 身份验证中用于检索用户的属性名称。 - -### `authentication_ldap_simple_user_search_attr` - -- 作用域：GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串 -- 默认值：`uid` -- LDAP Simple 身份验证中用于检索用户的属性名称。 - -### `plugin_audit_log_buffer_size` - -- 作用域：INSTANCE -- 是否持久化到集群：否 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串（只读） -- 默认值：来自 `[instance]` 配置项（代码默认读取 `plugin-audit-log-flush-interval`） -- 审计日志插件相关的实例级只读变量。 - -### `plugin_audit_log_flush_interval` - -- 作用域：INSTANCE -- 是否持久化到集群：否 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串（只读） -- 默认值：来自 `[instance]` 配置项（代码默认读取 `plugin-audit-log-flush-interval`） -- 审计日志插件相关的实例级只读变量。 - -### `tidb_analyze_column_options` - -- 作用域：GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串 -- 默认值：`ALL` -- 可选值：`ALL`、`PREDICATE` -- 控制 `ANALYZE` 默认的列选择策略。 - -### `tidb_enable_batch_query_region` - -- 作用域：GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：布尔型 -- 默认值：`OFF` -- 控制是否开启批量查询 Region。 - -### `tidb_enable_binding_usage` - -- 作用域：GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：布尔型 -- 默认值：`ON` -- 控制是否启用绑定的使用。 - -### `tidb_enable_tiflash_pipeline_model` - -- 作用域：GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：布尔型 -- 默认值：`ON` -- 控制 TiFlash Pipeline 模式开关（代码中变量名为 `tidb_enable_tiflash_pipeline_model`）。 - -### `tidb_enable_ts_validation` - -- 作用域：GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：布尔型 -- 默认值：`ON` -- 控制是否启用时间戳校验。 - -### `tidb_foreign_key_check_in_shared_lock` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：布尔型 -- 默认值：`OFF` -- 控制共享锁场景下外键检查行为。 - -### `tidb_mem_arbitrator_mode` - -- 作用域：GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串 -- 默认值：`disable` -- 可选值：`disable`、`standard`、`priority` -- 设置全局内存仲裁器工作模式。 - -### `tidb_mem_arbitrator_query_reserved` - -- 作用域：SESSION -- 是否持久化到集群：否 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：字符串 -- 默认值：`0` -- 控制内存仲裁器为当前查询保留的内存值。 - -### `tidb_mem_arbitrator_soft_limit` - -- 作用域：GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串 -- 默认值：`0` -- 可选值：`0`、`auto`、正整数、`(0,1]` 区间的小数 -- 设置全局内存仲裁器软上限。 - -### `tidb_mem_arbitrator_wait_averse` - -- 作用域：SESSION -- 是否持久化到集群：否 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串 -- 默认值：`0` -- 可选值：`0`、`1`、`nolimit` -- 控制会话级内存仲裁等待规避策略。 - -### `tidb_opt_always_keep_join_key` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：布尔型 -- 默认值：`ON` -- 控制优化器是否始终保留 Join Key。 - -### `tidb_opt_cartesian_join_order_threshold` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：浮点型 -- 默认值：`0.0` -- 范围：`[0, 18446744073709551615]` -- 控制笛卡尔积 Join 重排序阈值。 - -### `tidb_opt_enable_three_stage_multi_distinct_agg` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：布尔型 -- 默认值：`OFF` -- 控制是否启用三阶段多 DISTINCT 聚合优化。 - -### `tidb_opt_group_ndv_skew_ratio` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：浮点型 -- 默认值：`0.0` -- 范围：`[0, 1]` -- 控制分组 NDV 倾斜比例参数。 - -### `tidb_opt_index_join_build_v2` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：布尔型 -- 默认值：`ON` -- 控制是否启用 Index Join Build V2。 - -### `tidb_opt_index_prune_threshold` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：整数型 -- 默认值：`20` -- 范围：`[-1, 2147483647]` -- 控制索引裁剪阈值。 - -### `tidb_opt_join_reorder_through_sel` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：布尔型 -- 默认值：`OFF` -- 控制 Join 重排序是否可穿透选择条件。 - -### `tidb_opt_partial_ordered_index_for_topn` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：枚举型 -- 默认值：`DISABLE` -- 可选值：`DISABLE`、`COST` -- 控制 TopN 的部分有序索引优化策略。 - -### `tidb_opt_risk_eq_skew_ratio` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：浮点型 -- 默认值：`0.0` -- 范围：`[0, 1]` -- 控制等值条件风险倾斜比例参数。 - -### `tidb_opt_risk_range_skew_ratio` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：浮点型 -- 默认值：`0.0` -- 范围：`[0, 1]` -- 控制范围条件风险倾斜比例参数。 - -### `tidb_opt_scale_ndv_skew_ratio` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：浮点型 -- 默认值：`1.0` -- 范围：`[0, 1]` -- 控制 NDV 倾斜缩放比例参数。 - -### `tidb_opt_selectivity_factor` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：浮点型 -- 默认值：`0.8` -- 范围：`[0, 1]` -- 控制优化器选择率因子参数。 - -### `tidb_opt_table_rowid_scan_cost_factor` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：浮点型 -- 默认值：`1.0` -- 范围：`[0, 18446744073709551615]` -- 控制按 RowID 扫描的代价因子。 - -### `tidb_opt_use_invisible_indexes` - -- 作用域：SESSION -- 是否持久化到集群：否 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 -- 类型：布尔型 -- 默认值：`OFF` -- 控制优化器是否使用 Invisible Index。 - -### `tidb_trace_event` - -- 作用域：INSTANCE -- 是否持久化到集群：否 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串 -- 默认值：`` -- 实例级 Trace 事件控制变量。 - -### `tiflash_compute_dispatch_policy` - -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串 -- 默认值：`consistent_hash` -- 可选值：`consistent_hash`、`round_robin` -- 控制 TiFlash Compute 任务分发策略。 From 574682b38495f2d1d32d437aa86ec0afcf528c89 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Wed, 4 Mar 2026 14:39:25 +0800 Subject: [PATCH 10/13] Update system-variables.md --- system-variables.md | 264 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 264 insertions(+) diff --git a/system-variables.md b/system-variables.md index 07c20abe665f..db5176ad6dcc 100644 --- a/system-variables.md +++ b/system-variables.md @@ -6067,3 +6067,267 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 类型：布尔型 - 默认值：`ON` - 这个变量用于控制计算[窗口函数](/functions-and-operators/window-functions.md)时是否采用高精度模式。 + +### `authentication_ldap_sasl_user_search_attr` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`uid` +- LDAP SASL user search attribute. + +### `authentication_ldap_simple_user_search_attr` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`uid` +- LDAP Simple user search attribute. + +### `plugin_audit_log_buffer_size` + +- 作用域：INSTANCE +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串（只读） +- 默认值：来自 `[instance]` 配置项 +- Plugin audit log instance variable (read-only). + +### `plugin_audit_log_flush_interval` + +- 作用域：INSTANCE +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串（只读） +- 默认值：来自 `[instance]` 配置项 +- Plugin audit log flush interval (read-only). + +### `tidb_enable_batch_query_region` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`OFF` +- Enable/disable batch Region query. + +### `tidb_enable_binding_usage` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`ON` +- Enable/disable binding usage. + +### `tidb_enable_tiflash_pipeline_model` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`ON` +- Enable/disable TiFlash pipeline mode. + +### `tidb_enable_ts_validation` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`ON` +- Enable/disable TS validation. + +### `tidb_foreign_key_check_in_shared_lock` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`OFF` +- Foreign key check behavior in shared lock. + +### `tidb_mem_arbitrator_mode` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`disable` +- 可选值：`disable`、`standard`、`priority` +- Global memory arbitrator mode. + +### `tidb_mem_arbitrator_query_reserved` + +- 作用域：SESSION +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：字符串 +- 默认值：`0` +- Reserved memory for current query. + +### `tidb_mem_arbitrator_soft_limit` +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`0` +- 可选值：`0`、`auto`、正整数、`(0,1]`小数 +- Global memory arbitrator soft limit. + +### `tidb_mem_arbitrator_wait_averse` + +- 作用域：SESSION +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`0` +- 可选值：`0`、`1`、`nolimit` +- Session wait-averse strategy for memory arbitrator. + +### `tidb_opt_always_keep_join_key` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：布尔型 +- 默认值：`ON` +- Optimizer always keeps join key. + +### `tidb_opt_cartesian_join_order_threshold` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`0.0` +- 范围：`[0, 18446744073709551615]` +- Cartesian join reorder threshold. + +### `tidb_opt_enable_three_stage_multi_distinct_agg` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`OFF` +- Enable 3-stage multi-distinct agg optimization. + +### `tidb_opt_group_ndv_skew_ratio` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`0.0` +- 范围：`[0, 1]` +- Group NDV skew ratio. + +### `tidb_opt_index_join_build_v2` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`ON` +- Enable index join build v2. + +### `tidb_opt_index_prune_threshold` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：整数型 +- 默认值：`20` +- 范围：`[-1, 2147483647]` +- Index prune threshold. + +### `tidb_opt_join_reorder_through_sel` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`OFF` +- Allow join reorder through selection. + +### `tidb_opt_partial_ordered_index_for_topn` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：枚举型 +- 默认值：`DISABLE` +- 可选值：`DISABLE`、`COST` +- Partial ordered index strategy for TopN. + +### `tidb_opt_risk_eq_skew_ratio` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`0.0` +- 范围：`[0, 1]` +- Risk eq skew ratio. + +### `tidb_opt_risk_range_skew_ratio` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`0.0` +- 范围：`[0, 1]` +- Risk range skew ratio. + +### `tidb_opt_scale_ndv_skew_ratio` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`1.0` +- 范围：`[0, 1]` +- Scale NDV skew ratio. + +### `tidb_opt_selectivity_factor` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`0.8` +- 范围：`[0, 1]` +- Optimizer selectivity factor. + +### `tidb_opt_table_rowid_scan_cost_factor` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：浮点型 +- 默认值：`1.0` +- 范围：`[0, 18446744073709551615]` +- Table rowid scan cost factor. + +### `tidb_trace_event` + +- 作用域：INSTANCE +- 是否持久化到集群：否 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`` +- Instance-level trace event control. + +### `tiflash_compute_dispatch_policy` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：字符串 +- 默认值：`consistent_hash` +- 可选值：`consistent_hash`、`round_robin` +- TiFlash compute dispatch policy. From 0db9d26c8a27d93f2bc165e803ca303a39222432 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Wed, 4 Mar 2026 14:53:38 +0800 Subject: [PATCH 11/13] Update system-variables.md --- system-variables.md | 1 + 1 file changed, 1 insertion(+) diff --git a/system-variables.md b/system-variables.md index db5176ad6dcc..dd5c79fe69e4 100644 --- a/system-variables.md +++ b/system-variables.md @@ -6169,6 +6169,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - Reserved memory for current query. ### `tidb_mem_arbitrator_soft_limit` + - 作用域：GLOBAL - 是否持久化到集群：是 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 From c2c7c9aae5834fbb7acb86bc77b85e9191b3bd27 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Wed, 4 Mar 2026 14:59:05 +0800 Subject: [PATCH 12/13] Update system-variables.md --- system-variables.md | 56 ++++++++++++++++++++++----------------------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/system-variables.md b/system-variables.md index dd5c79fe69e4..3c823f1b9e0a 100644 --- a/system-variables.md +++ b/system-variables.md @@ -6068,7 +6068,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`ON` - 这个变量用于控制计算[窗口函数](/functions-and-operators/window-functions.md)时是否采用高精度模式。 -### `authentication_ldap_sasl_user_search_attr` +### `authentication_ldap_sasl_user_search_attr` 从 v8.5.4 版本开始引入 - 作用域：GLOBAL - 是否持久化到集群：是 @@ -6077,7 +6077,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`uid` - LDAP SASL user search attribute. -### `authentication_ldap_simple_user_search_attr` +### `authentication_ldap_simple_user_search_attr` 从 v8.5.4 版本开始引入 - 作用域：GLOBAL - 是否持久化到集群：是 @@ -6086,7 +6086,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`uid` - LDAP Simple user search attribute. -### `plugin_audit_log_buffer_size` +### `plugin_audit_log_buffer_size` 从 v8.5.4 版本开始引入 - 作用域：INSTANCE - 是否持久化到集群：否 @@ -6095,7 +6095,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：来自 `[instance]` 配置项 - Plugin audit log instance variable (read-only). -### `plugin_audit_log_flush_interval` +### `plugin_audit_log_flush_interval` 从 v8.5.4 版本开始引入 - 作用域：INSTANCE - 是否持久化到集群：否 @@ -6104,7 +6104,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：来自 `[instance]` 配置项 - Plugin audit log flush interval (read-only). -### `tidb_enable_batch_query_region` +### `tidb_enable_batch_query_region` 从 v8.5.4 版本开始引入 - 作用域：GLOBAL - 是否持久化到集群：是 @@ -6113,7 +6113,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`OFF` - Enable/disable batch Region query. -### `tidb_enable_binding_usage` +### `tidb_enable_binding_usage` 从 v8.5.6 版本开始引入 - 作用域：GLOBAL - 是否持久化到集群：是 @@ -6122,7 +6122,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`ON` - Enable/disable binding usage. -### `tidb_enable_tiflash_pipeline_model` +### `tidb_enable_tiflash_pipeline_model` 从 v8.5.4 版本开始引入 - 作用域：GLOBAL - 是否持久化到集群：是 @@ -6131,7 +6131,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`ON` - Enable/disable TiFlash pipeline mode. -### `tidb_enable_ts_validation` +### `tidb_enable_ts_validation` 从 v8.5.4 版本开始引入 - 作用域：GLOBAL - 是否持久化到集群：是 @@ -6140,7 +6140,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`ON` - Enable/disable TS validation. -### `tidb_foreign_key_check_in_shared_lock` +### `tidb_foreign_key_check_in_shared_lock` 从 v9.0.0 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6149,7 +6149,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`OFF` - Foreign key check behavior in shared lock. -### `tidb_mem_arbitrator_mode` +### `tidb_mem_arbitrator_mode` 从 v8.5.6 版本开始引入 - 作用域：GLOBAL - 是否持久化到集群：是 @@ -6159,7 +6159,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 可选值：`disable`、`standard`、`priority` - Global memory arbitrator mode. -### `tidb_mem_arbitrator_query_reserved` +### `tidb_mem_arbitrator_query_reserved` 从 v8.5.6 版本开始引入 - 作用域：SESSION - 是否持久化到集群：否 @@ -6168,7 +6168,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`0` - Reserved memory for current query. -### `tidb_mem_arbitrator_soft_limit` +### `tidb_mem_arbitrator_soft_limit` 从 v8.5.6 版本开始引入 - 作用域：GLOBAL - 是否持久化到集群：是 @@ -6178,7 +6178,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 可选值：`0`、`auto`、正整数、`(0,1]`小数 - Global memory arbitrator soft limit. -### `tidb_mem_arbitrator_wait_averse` +### `tidb_mem_arbitrator_wait_averse` 从 v8.5.6 版本开始引入 - 作用域：SESSION - 是否持久化到集群：否 @@ -6188,7 +6188,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 可选值：`0`、`1`、`nolimit` - Session wait-averse strategy for memory arbitrator. -### `tidb_opt_always_keep_join_key` +### `tidb_opt_always_keep_join_key` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6197,7 +6197,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`ON` - Optimizer always keeps join key. -### `tidb_opt_cartesian_join_order_threshold` +### `tidb_opt_cartesian_join_order_threshold` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6207,7 +6207,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 范围：`[0, 18446744073709551615]` - Cartesian join reorder threshold. -### `tidb_opt_enable_three_stage_multi_distinct_agg` +### `tidb_opt_enable_three_stage_multi_distinct_agg` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6216,7 +6216,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`OFF` - Enable 3-stage multi-distinct agg optimization. -### `tidb_opt_group_ndv_skew_ratio` +### `tidb_opt_group_ndv_skew_ratio` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6226,7 +6226,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 范围：`[0, 1]` - Group NDV skew ratio. -### `tidb_opt_index_join_build_v2` +### `tidb_opt_index_join_build_v2` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6235,7 +6235,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`ON` - Enable index join build v2. -### `tidb_opt_index_prune_threshold` +### `tidb_opt_index_prune_threshold` 从 v8.5.6 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6245,7 +6245,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 范围：`[-1, 2147483647]` - Index prune threshold. -### `tidb_opt_join_reorder_through_sel` +### `tidb_opt_join_reorder_through_sel` 从 v8.5.6 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6254,7 +6254,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`OFF` - Allow join reorder through selection. -### `tidb_opt_partial_ordered_index_for_topn` +### `tidb_opt_partial_ordered_index_for_topn` 从 v8.5.6 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6264,7 +6264,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 可选值：`DISABLE`、`COST` - Partial ordered index strategy for TopN. -### `tidb_opt_risk_eq_skew_ratio` +### `tidb_opt_risk_eq_skew_ratio` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6274,7 +6274,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 范围：`[0, 1]` - Risk eq skew ratio. -### `tidb_opt_risk_range_skew_ratio` +### `tidb_opt_risk_range_skew_ratio` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6284,7 +6284,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 范围：`[0, 1]` - Risk range skew ratio. -### `tidb_opt_scale_ndv_skew_ratio` +### `tidb_opt_scale_ndv_skew_ratio` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6294,7 +6294,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 范围：`[0, 1]` - Scale NDV skew ratio. -### `tidb_opt_selectivity_factor` +### `tidb_opt_selectivity_factor` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6304,7 +6304,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 范围：`[0, 1]` - Optimizer selectivity factor. -### `tidb_opt_table_rowid_scan_cost_factor` +### `tidb_opt_table_rowid_scan_cost_factor` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -6314,7 +6314,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 范围：`[0, 18446744073709551615]` - Table rowid scan cost factor. -### `tidb_trace_event` +### `tidb_trace_event` 从 v8.5.6 版本开始引入 - 作用域：INSTANCE - 是否持久化到集群：否 @@ -6323,7 +6323,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`` - Instance-level trace event control. -### `tiflash_compute_dispatch_policy` +### `tiflash_compute_dispatch_policy` 从 v8.5.4 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 From 2b410a1eaa2b71d1505ac6cef5420a8cd3bee29f Mon Sep 17 00:00:00 2001 From: houfaxin Date: Wed, 4 Mar 2026 16:43:32 +0800 Subject: [PATCH 13/13] Update system-variables.md --- system-variables.md | 18 ------------------ 1 file changed, 18 deletions(-) diff --git a/system-variables.md b/system-variables.md index 3c823f1b9e0a..b24ada10ba51 100644 --- a/system-variables.md +++ b/system-variables.md @@ -6086,24 +6086,6 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 默认值：`uid` - LDAP Simple user search attribute. -### `plugin_audit_log_buffer_size` 从 v8.5.4 版本开始引入 - -- 作用域：INSTANCE -- 是否持久化到集群：否 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串（只读） -- 默认值：来自 `[instance]` 配置项 -- Plugin audit log instance variable (read-only). - -### `plugin_audit_log_flush_interval` 从 v8.5.4 版本开始引入 - -- 作用域：INSTANCE -- 是否持久化到集群：否 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 类型：字符串（只读） -- 默认值：来自 `[instance]` 配置项 -- Plugin audit log flush interval (read-only). - ### `tidb_enable_batch_query_region` 从 v8.5.4 版本开始引入 - 作用域：GLOBAL