From ec20b226bfba4e4b3f0c1fa315086980a86d0b24 Mon Sep 17 00:00:00 2001 From: Weizhen Wang Date: Mon, 14 Oct 2024 11:51:04 +0800 Subject: [PATCH 1/6] *: add tidb_enable_stats_owner Signed-off-by: Weizhen Wang --- system-variables.md | 9 +++++++++ tidb-configuration-file.md | 6 ++++++ 2 files changed, 15 insertions(+) diff --git a/system-variables.md b/system-variables.md index 877cab704a6a..02af24768122 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1784,6 +1784,15 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 可选值：`OFF`，`ON` - 用于设置该 TiDB 实例是否可以成为 DDL owner。若当前 TiDB 集群中只有一台 TiDB 实例，则不能禁止该实例成为 DDL owner，即不能设置为 `OFF`。 +### `tidb_enable_stats_owner` 从 v8.4.0 版本开始引入 + +- 作用域：GLOBAL +- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 默认值：`ON` +- 可选值：`OFF`，`ON` +- 用于设置该 TiDB 实例是否可以成为 stats owner。若当前 TiDB 集群中只有一台 TiDB 实例，则不能禁止该实例成为 stats owner，即不能设置为 `OFF`。 + ### `tidb_enable_enhanced_security` - 作用域：NONE diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index aa6cc4f0bee7..6f0922fa693c 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -947,6 +947,12 @@ TiDB 服务状态相关配置。 + 该值作为系统变量 [`tidb_enable_ddl`](/system-variables.md#tidb_enable_ddl-从-v630-版本开始引入) 的初始值。 + 在 v6.3.0 之前，该功能由配置项 `run-ddl` 进行设置。 +### `tidb_enable_stats_owner` + ++ 用于表示该 tidb-server 是否可以成为 stats owner。 ++ 默认值：true ++ 该值作为系统变量 [`tidb_enable_stats_owner`](/system-variables.md#tidb_enable_stats_owner-从-v840-版本开始引入) 的初始值。 + ### `tidb_stmt_summary_enable_persistent` 从 v6.6.0 版本开始引入 > **警告：** From 6a9b6723ef49474f093213f3769c5a569addecd5 Mon Sep 17 00:00:00 2001 From: Weizhen Wang Date: Tue, 15 Oct 2024 13:56:08 +0800 Subject: [PATCH 2/6] Update system-variables.md Co-authored-by: Roger Song --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index 02af24768122..ff316cf5fd86 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1791,7 +1791,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 - 默认值：`ON` - 可选值：`OFF`，`ON` -- 用于设置该 TiDB 实例是否可以成为 stats owner。若当前 TiDB 集群中只有一台 TiDB 实例，则不能禁止该实例成为 stats owner，即不能设置为 `OFF`。 +- 用于设置该 TiDB 实例是否可以运行[统计信息自动更新](/statistics.md#自动更新)任务。若当前 TiDB 集群中只有一台 TiDB 实例，则不能禁止该实例运行统计信息自动更新，即不能设置为 `OFF`。 ### `tidb_enable_enhanced_security` From 074c5ee3522bccb6989449c7f15390a15c9bf91d Mon Sep 17 00:00:00 2001 From: Aolin Date: Tue, 22 Oct 2024 15:27:30 +0800 Subject: [PATCH 3/6] fix the order in system-variables.md and version-mark in tidb-configuration-file.md Signed-off-by: Aolin --- system-variables.md | 18 +++++++++--------- tidb-configuration-file.md | 2 +- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/system-variables.md b/system-variables.md index ff316cf5fd86..5b4c18ddaaa2 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1784,15 +1784,6 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 可选值：`OFF`，`ON` - 用于设置该 TiDB 实例是否可以成为 DDL owner。若当前 TiDB 集群中只有一台 TiDB 实例，则不能禁止该实例成为 DDL owner，即不能设置为 `OFF`。 -### `tidb_enable_stats_owner` 从 v8.4.0 版本开始引入 - -- 作用域：GLOBAL -- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例 -- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 默认值：`ON` -- 可选值：`OFF`，`ON` -- 用于设置该 TiDB 实例是否可以运行[统计信息自动更新](/statistics.md#自动更新)任务。若当前 TiDB 集群中只有一台 TiDB 实例，则不能禁止该实例运行统计信息自动更新，即不能设置为 `OFF`。 - ### `tidb_enable_enhanced_security` - 作用域：NONE @@ -2338,6 +2329,15 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 默认值：`ON` - 这个变量用于控制是否开启 slow log 功能。 +### `tidb_enable_stats_owner` 从 v8.4.0 版本开始引入 + +- 作用域：GLOBAL +- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 默认值：`ON` +- 可选值：`OFF`，`ON` +- 用于设置该 TiDB 实例是否可以运行[统计信息自动更新](/statistics.md#自动更新)任务。若当前 TiDB 集群中只有一台 TiDB 实例，则不能禁止该实例运行统计信息自动更新，即不能设置为 `OFF`。 + ### `tidb_enable_stmt_summary` 从 v3.0.4 版本开始引入 - 作用域：GLOBAL diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index 6f0922fa693c..5f20cc733be0 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -947,7 +947,7 @@ TiDB 服务状态相关配置。 + 该值作为系统变量 [`tidb_enable_ddl`](/system-variables.md#tidb_enable_ddl-从-v630-版本开始引入) 的初始值。 + 在 v6.3.0 之前，该功能由配置项 `run-ddl` 进行设置。 -### `tidb_enable_stats_owner` +### `tidb_enable_stats_owner` 从 v8.4.0 版本开始引入 + 用于表示该 tidb-server 是否可以成为 stats owner。 + 默认值：true From 91eb9eff5598654b583e27b97f66a892accc1d57 Mon Sep 17 00:00:00 2001 From: Weizhen Wang Date: Mon, 28 Oct 2024 14:01:11 +0800 Subject: [PATCH 4/6] Update tidb-configuration-file.md Co-authored-by: Aolin --- tidb-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index 5f20cc733be0..c1e75d9952c4 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -949,7 +949,7 @@ TiDB 服务状态相关配置。 ### `tidb_enable_stats_owner` 从 v8.4.0 版本开始引入 -+ 用于表示该 tidb-server 是否可以成为 stats owner。 ++ 用于表示该 tidb-server 是否可以运行[统计信息自动更新](/statistics.md#自动更新)任务。 + 默认值：true + 该值作为系统变量 [`tidb_enable_stats_owner`](/system-variables.md#tidb_enable_stats_owner-从-v840-版本开始引入) 的初始值。 From 941b9db5ad946aa15d2e0702903877406a6ab298 Mon Sep 17 00:00:00 2001 From: Aolin Date: Mon, 28 Oct 2024 14:07:02 +0800 Subject: [PATCH 5/6] Apply suggestions from code review --- tidb-configuration-file.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index c1e75d9952c4..b5ee051090bb 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -950,7 +950,8 @@ TiDB 服务状态相关配置。 ### `tidb_enable_stats_owner` 从 v8.4.0 版本开始引入 + 用于表示该 tidb-server 是否可以运行[统计信息自动更新](/statistics.md#自动更新)任务。 -+ 默认值：true ++ 默认值：`true` ++ 可选值：`true`，`false` + 该值作为系统变量 [`tidb_enable_stats_owner`](/system-variables.md#tidb_enable_stats_owner-从-v840-版本开始引入) 的初始值。 ### `tidb_stmt_summary_enable_persistent` 从 v6.6.0 版本开始引入 From 3c6169e400c3b23c233f1773eae22f1c8ab2876b Mon Sep 17 00:00:00 2001 From: Aolin Date: Mon, 28 Oct 2024 14:31:56 +0800 Subject: [PATCH 6/6] fix format Co-authored-by: Grace Cai --- system-variables.md | 2 +- tidb-configuration-file.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/system-variables.md b/system-variables.md index 5b4c18ddaaa2..564574e39754 100644 --- a/system-variables.md +++ b/system-variables.md @@ -2335,7 +2335,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 - 默认值：`ON` -- 可选值：`OFF`，`ON` +- 可选值：`OFF`、`ON` - 用于设置该 TiDB 实例是否可以运行[统计信息自动更新](/statistics.md#自动更新)任务。若当前 TiDB 集群中只有一台 TiDB 实例，则不能禁止该实例运行统计信息自动更新，即不能设置为 `OFF`。 ### `tidb_enable_stmt_summary` 从 v3.0.4 版本开始引入 diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index b5ee051090bb..322dc0b0357b 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -951,7 +951,7 @@ TiDB 服务状态相关配置。 + 用于表示该 tidb-server 是否可以运行[统计信息自动更新](/statistics.md#自动更新)任务。 + 默认值：`true` -+ 可选值：`true`，`false` ++ 可选值：`true`、`false` + 该值作为系统变量 [`tidb_enable_stats_owner`](/system-variables.md#tidb_enable_stats_owner-从-v840-版本开始引入) 的初始值。 ### `tidb_stmt_summary_enable_persistent` 从 v6.6.0 版本开始引入