From b155e076f3d49e29ea11cc024e68078d99926844 Mon Sep 17 00:00:00 2001 From: shichun-0415 Date: Wed, 21 Sep 2022 20:23:07 +0800 Subject: [PATCH 01/13] add 8 system variables introduced in 6.3 but have no user doc --- system-variables.md | 61 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) diff --git a/system-variables.md b/system-variables.md index b6ee3f53e65c..f22a58aa0bf9 100644 --- a/system-variables.md +++ b/system-variables.md @@ -345,6 +345,14 @@ mysql> SHOW GLOBAL VARIABLES LIKE 'max_prepared_stmt_count'; - 默认值：`ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION` - 这个变量控制许多 MySQL 兼容行为。详情见 [SQL 模式](/sql-mode.md)。 +### `sql_require_primary_key` 从 v6.3.0 版本开始引入 + +- 作用域： +- 是否持久化到集群： +- 默认值： +- 范围： +- 这个变量用来 XXX。 + ### `sql_select_limit` 从 v4.0.2 版本开始引入 - 作用域：SESSION | GLOBAL @@ -687,6 +695,14 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 - 范围：`[0, 9223372036854775807]` - 这个变量用来控制 DDL 操作失败重试的次数。失败重试次数超过该参数的值后，会取消出错的 DDL 操作。 +### `tidb_ddl_flashback_concurrency` 从 v6.3.0 版本开始引入 + +- 作用域： +- 是否持久化到集群： +- 默认值： +- 范围： +- 这个变量用来 XXX。 + ### `tidb_ddl_reorg_batch_size` - 作用域：GLOBAL @@ -894,6 +910,7 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 - `RESTRICTED_VARIABLES_ADMIN`：能够在 `SHOW [GLOBAL] VARIABLES` 和 `SET` 命令中查看和设置包含敏感内容的变量。 - `RESTRICTED_USER_ADMIN`：能够阻止其他用户更改或删除用户帐户。 + ### `tidb_restricted_read_only` 从 v5.2.0 版本开始引入 - 作用域：GLOBAL @@ -931,6 +948,20 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 - 这个变量用来控制是否启用统计信息快速分析功能。默认值 0 表示不开启。 - 快速分析功能开启后，TiDB 会随机采样约 10000 行的数据来构建统计信息。因此在数据分布不均匀或者数据量比较少的情况下，统计信息的准确度会比较低。这可能导致执行计划不优，比如选错索引。如果可以接受普通 `ANALYZE` 语句的执行时间，则推荐关闭快速分析功能。 +### `tidb_enable_foreign_key` 从 v6.3.0 版本开始引入 + +- 作用域： +- 是否持久化到集群：是 +- 默认值： +- 这个变量用于 XXX。 + +### `tidb_enable_general_plan_cache` 从 v6.3.0 版本开始引入 + +- 作用域： +- 是否持久化到集群：是 +- 默认值： +- 这个变量用于 XXX。 + ### `tidb_enable_index_merge` 从 v4.0 版本开始引入 > **注意：** @@ -1006,6 +1037,13 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 * 使用 `SELECT` 读取 `noop` 的系统变量时会报 `"variable *variable_name* has no effect in TiDB"` 的警告。 - 你可以通过 `SELECT * FROM INFORMATION_SCHEMA.CLIENT_ERRORS_SUMMARY_GLOBAL;` 语句来检查 TiDB 实例是否曾设置和读取 `noop` 系统变量。 +### `tidb_enable_null_aware_anti_join` 从 v6.3.0 版本开始引入 + +- 作用域： +- 是否持久化到集群：是 +- 默认值： +- 这个变量用于 XXX。 + ### `tidb_enable_outer_join_reorder` 从 v6.1.0 版本开始引入 - 作用域：SESSION | GLOBAL @@ -1119,6 +1157,13 @@ Query OK, 0 rows affected (0.09 sec) - 默认值：`ON` - 这个变量用于动态地控制 TiDB 遥测功能是否开启。设置为 `OFF` 可以关闭 TiDB 遥测功能。当所有 TiDB 实例都设置 [`enable-telemetry`](/tidb-configuration-file.md#enable-telemetry-从-v402-版本开始引入) 为 `false` 时将忽略该系统变量并总是关闭 TiDB 遥测功能。参阅[遥测](/telemetry.md)了解该功能详情。 +### `tidb_enable_tiflash_read_for_write_stmt` 从 v6.3.0 版本开始引入 + +- 作用域： +- 是否持久化到集群：是 +- 默认值： +- 这个变量用于 XXX。 + ### `tidb_enable_top_sql` 从 v5.4.0 版本开始引入 > **警告：** @@ -1345,6 +1390,14 @@ v5.0 后，用户仍可以单独修改以上系统变量（会有废弃警告） - `txn_mode`：事务模式。可选值：`OPTIMISTIC`（乐观事务模式），或 `PESSIMISTIC`（悲观事务模式） - `sql`：当前查询对应的 SQL 语句 +### `tidb_general_plan_cache_size` 从 v6.3.0 版本开始引入 + +- 作用域： +- 是否持久化到集群： +- 默认值： +- 范围： +- 这个变量用来 XXX。 + ### `tidb_guarantee_linearizability` 从 v5.0 版本开始引入 - 作用域：SESSION | GLOBAL @@ -1476,6 +1529,14 @@ v5.0 后，用户仍可以单独修改以上系统变量（会有废弃警告） - "query"：上一个 DDL 查询字符串。 - "seq_num"：每个 DDL 操作的序列号，用于标识 DDL 操作的顺序。 +### `tidb_last_plan_replayer_token` 从 v6.3.0 版本开始引入 + +- 作用域： +- 是否持久化到集群： +- 默认值： +- 范围： +- 这个变量用来 XXX。 + ### `tidb_last_query_info` 从 v4.0.14 版本开始引入 - 作用域：SESSION From 7855039b952e0c05d2d4d67f0e3b1fb0460aee31 Mon Sep 17 00:00:00 2001 From: shichun-0415 Date: Wed, 21 Sep 2022 20:30:08 +0800 Subject: [PATCH 02/13] fix format --- system-variables.md | 1 - 1 file changed, 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index f22a58aa0bf9..f7d80e8dfbc8 100644 --- a/system-variables.md +++ b/system-variables.md @@ -910,7 +910,6 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 - `RESTRICTED_VARIABLES_ADMIN`：能够在 `SHOW [GLOBAL] VARIABLES` 和 `SET` 命令中查看和设置包含敏感内容的变量。 - `RESTRICTED_USER_ADMIN`：能够阻止其他用户更改或删除用户帐户。 - ### `tidb_restricted_read_only` 从 v5.2.0 版本开始引入 - 作用域：GLOBAL From b9cac5dd16434f5634cfdb98f6c84b265e666566 Mon Sep 17 00:00:00 2001 From: shichun-0415 Date: Wed, 21 Sep 2022 20:35:41 +0800 Subject: [PATCH 03/13] fix --- system-variables.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/system-variables.md b/system-variables.md index f7d80e8dfbc8..0a939b011c94 100644 --- a/system-variables.md +++ b/system-variables.md @@ -950,14 +950,14 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 ### `tidb_enable_foreign_key` 从 v6.3.0 版本开始引入 - 作用域： -- 是否持久化到集群：是 +- 是否持久化到集群： - 默认值： - 这个变量用于 XXX。 ### `tidb_enable_general_plan_cache` 从 v6.3.0 版本开始引入 - 作用域： -- 是否持久化到集群：是 +- 是否持久化到集群： - 默认值： - 这个变量用于 XXX。 @@ -1039,7 +1039,7 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 ### `tidb_enable_null_aware_anti_join` 从 v6.3.0 版本开始引入 - 作用域： -- 是否持久化到集群：是 +- 是否持久化到集群： - 默认值： - 这个变量用于 XXX。 @@ -1159,7 +1159,7 @@ Query OK, 0 rows affected (0.09 sec) ### `tidb_enable_tiflash_read_for_write_stmt` 从 v6.3.0 版本开始引入 - 作用域： -- 是否持久化到集群：是 +- 是否持久化到集群： - 默认值： - 这个变量用于 XXX。 From 4216652783908e2c03a0e5316d5b259d4fa43655 Mon Sep 17 00:00:00 2001 From: shichun-0415 <89768198+shichun-0415@users.noreply.github.com> Date: Wed, 21 Sep 2022 21:41:54 +0800 Subject: [PATCH 04/13] Apply suggestions from code review Co-authored-by: Arenatlx --- system-variables.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/system-variables.md b/system-variables.md index 0a939b011c94..c57f1ffbb682 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1038,10 +1038,10 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 ### `tidb_enable_null_aware_anti_join` 从 v6.3.0 版本开始引入 -- 作用域： -- 是否持久化到集群： -- 默认值： -- 这个变量用于 XXX。 +- 作用域：SESSION ｜GLOBAL +- 是否持久化到集群：是 +- 默认值：`OFF` +- 自 v6.3.0 起，TiDB 的对特殊集合算子 `NOT IN` 和 `!= ALL` 引导子查询而产生的 ANTI JOIN 将可以使用此开关控制是否采用 Null Aware Hash Join 的执行方式。该开关默认为 `OFF`。 ### `tidb_enable_outer_join_reorder` 从 v6.1.0 版本开始引入 From 08fe4b200a9f5ee43eadf2c3bd564ac651b6ad40 Mon Sep 17 00:00:00 2001 From: shichun-0415 Date: Wed, 21 Sep 2022 21:57:01 +0800 Subject: [PATCH 05/13] remove an existing variable --- system-variables.md | 8 -------- 1 file changed, 8 deletions(-) diff --git a/system-variables.md b/system-variables.md index c57f1ffbb682..cf7ef4938b99 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1528,14 +1528,6 @@ v5.0 后，用户仍可以单独修改以上系统变量（会有废弃警告） - "query"：上一个 DDL 查询字符串。 - "seq_num"：每个 DDL 操作的序列号，用于标识 DDL 操作的顺序。 -### `tidb_last_plan_replayer_token` 从 v6.3.0 版本开始引入 - -- 作用域： -- 是否持久化到集群： -- 默认值： -- 范围： -- 这个变量用来 XXX。 - ### `tidb_last_query_info` 从 v4.0.14 版本开始引入 - 作用域：SESSION From 37d2a731b5bf4dd293f4f92052ea0a555cc2f527 Mon Sep 17 00:00:00 2001 From: shichun-0415 <89768198+shichun-0415@users.noreply.github.com> Date: Wed, 21 Sep 2022 21:58:03 +0800 Subject: [PATCH 06/13] Apply suggestions from code review Co-authored-by: Hangjie Mo --- system-variables.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/system-variables.md b/system-variables.md index cf7ef4938b99..e7ff9fead076 100644 --- a/system-variables.md +++ b/system-variables.md @@ -697,11 +697,11 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 ### `tidb_ddl_flashback_concurrency` 从 v6.3.0 版本开始引入 -- 作用域： -- 是否持久化到集群： -- 默认值： -- 范围： -- 这个变量用来 XXX。 +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 默认值：`64` +- 范围：`[1, 256]` +- 这个变量用来控制 `flashback cluster` 的并发数。 ### `tidb_ddl_reorg_batch_size` From ced450b668fcf1e82de405a79dc199d7cc574cef Mon Sep 17 00:00:00 2001 From: shichun-0415 <89768198+shichun-0415@users.noreply.github.com> Date: Thu, 22 Sep 2022 11:15:37 +0800 Subject: [PATCH 07/13] update tidb_ddl_flashback_concurrency Co-authored-by: Hangjie Mo --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index e7ff9fead076..b4a0f602198b 100644 --- a/system-variables.md +++ b/system-variables.md @@ -701,7 +701,7 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 - 是否持久化到集群：是 - 默认值：`64` - 范围：`[1, 256]` -- 这个变量用来控制 `flashback cluster` 的并发数。 +- 这个变量用来控制 `flashback cluster` 的并发数。**需要注意的是 `flashback cluster` 功能还未正式发布，请勿随意使用。** ### `tidb_ddl_reorg_batch_size` From 93b5e9c09c5cb6ca7e0686c0b4cea9040fff5bc7 Mon Sep 17 00:00:00 2001 From: shichun-0415 <89768198+shichun-0415@users.noreply.github.com> Date: Thu, 22 Sep 2022 12:45:11 +0800 Subject: [PATCH 08/13] Apply suggestions from code review Co-authored-by: Liqi Geng --- system-variables.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/system-variables.md b/system-variables.md index b4a0f602198b..6b047f80f912 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1158,10 +1158,10 @@ Query OK, 0 rows affected (0.09 sec) ### `tidb_enable_tiflash_read_for_write_stmt` 从 v6.3.0 版本开始引入 -- 作用域： -- 是否持久化到集群： -- 默认值： -- 这个变量用于 XXX。 +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 默认值：`OFF` +- 这个变量用于控制写 SQL 中的读取是否会下推 TiFlash。**需要注意该功能目前仅供测试，请勿在正式环境中使用，该功能正式 release 之后该参数不会保留** ### `tidb_enable_top_sql` 从 v5.4.0 版本开始引入 From 46b52bc53b9fa0d4c80be8d5954c026e9eb97576 Mon Sep 17 00:00:00 2001 From: shichun-0415 <89768198+shichun-0415@users.noreply.github.com> Date: Thu, 22 Sep 2022 16:22:05 +0800 Subject: [PATCH 09/13] Update system-variables.md Co-authored-by: Liqi Geng --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index 6b047f80f912..da9fa82079e8 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1161,7 +1161,7 @@ Query OK, 0 rows affected (0.09 sec) - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 - 默认值：`OFF` -- 这个变量用于控制写 SQL 中的读取是否会下推 TiFlash。**需要注意该功能目前仅供测试，请勿在正式环境中使用，该功能正式 release 之后该参数不会保留** +- 这个变量用于控制写 SQL 中的读取是否会下推到 TiFlash。注意，该功能目前仅供测试，请保留其默认值 `OFF`。 ### `tidb_enable_top_sql` 从 v5.4.0 版本开始引入 From aa009ed78aac32b913a9627c243c37718e103299 Mon Sep 17 00:00:00 2001 From: shichun-0415 <89768198+shichun-0415@users.noreply.github.com> Date: Thu, 22 Sep 2022 16:37:23 +0800 Subject: [PATCH 10/13] Apply suggestions from code review Co-authored-by: crazycs --- system-variables.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/system-variables.md b/system-variables.md index da9fa82079e8..bb65dc733f39 100644 --- a/system-variables.md +++ b/system-variables.md @@ -949,10 +949,10 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 ### `tidb_enable_foreign_key` 从 v6.3.0 版本开始引入 -- 作用域： -- 是否持久化到集群： -- 默认值： -- 这个变量用于 XXX。 +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 默认值：`OFF` +- 这个变量用于控制是否开启 `FOREIGN KEY` 特性，目前 `FOREIGN KEY` 特性还未 GA，不推荐开启该变量。 ### `tidb_enable_general_plan_cache` 从 v6.3.0 版本开始引入 From fee749aeefa2f270d97cb7c97ced3d9691d6c10f Mon Sep 17 00:00:00 2001 From: shichun-0415 <89768198+shichun-0415@users.noreply.github.com> Date: Tue, 27 Sep 2022 15:25:36 +0800 Subject: [PATCH 11/13] Apply suggestions from code review Co-authored-by: fzzf678 <108643977+fzzf678@users.noreply.github.com> --- system-variables.md | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) diff --git a/system-variables.md b/system-variables.md index bb65dc733f39..348061a3eb3d 100644 --- a/system-variables.md +++ b/system-variables.md @@ -956,11 +956,14 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 ### `tidb_enable_general_plan_cache` 从 v6.3.0 版本开始引入 -- 作用域： -- 是否持久化到集群： -- 默认值： -- 这个变量用于 XXX。 +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 默认值：`OFF` +- 这个变量用来控制是否开启 General Plan Cache。 +> **警告：** +> +> 当前版本中该变量控制的功能尚未完全生效，请保留默认值。 ### `tidb_enable_index_merge` 从 v4.0 版本开始引入 > **注意：** @@ -1391,12 +1394,15 @@ v5.0 后，用户仍可以单独修改以上系统变量（会有废弃警告） ### `tidb_general_plan_cache_size` 从 v6.3.0 版本开始引入 -- 作用域： -- 是否持久化到集群： -- 默认值： -- 范围： -- 这个变量用来 XXX。 +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 默认值：`100` +- 范围：`[1, 100000]` +- 这个变量用来控制 General Plan Cache 最多能够缓存的计划数量。 +> **警告：** +> +> 当前版本中该变量控制的功能尚未完全生效，请保留默认值。 ### `tidb_guarantee_linearizability` 从 v5.0 版本开始引入 - 作用域：SESSION | GLOBAL From 6e88891b4a520b3175e6303ae1d02e95c53e5538 Mon Sep 17 00:00:00 2001 From: shichun-0415 Date: Tue, 27 Sep 2022 17:37:20 +0800 Subject: [PATCH 12/13] translate sql_require_primary_key and refine others --- system-variables.md | 54 +++++++++++++++++++++++++++++---------------- 1 file changed, 35 insertions(+), 19 deletions(-) diff --git a/system-variables.md b/system-variables.md index 2e55342b8f71..11bce5418731 100644 --- a/system-variables.md +++ b/system-variables.md @@ -347,11 +347,13 @@ mysql> SHOW GLOBAL VARIABLES LIKE 'max_prepared_stmt_count'; ### `sql_require_primary_key` 从 v6.3.0 版本开始引入 -- 作用域： -- 是否持久化到集群： -- 默认值： -- 范围： -- 这个变量用来 XXX。 +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 类型：布尔型 +- 默认值：`OFF` +- 这个变量用于控制表是否必须有主键。启用该变量后，如果在没有主键的情况下创建或修改表，将返回错误。 +- 该功能基于 MySQL 8.0 的特性 [`sql_require_primary_key`](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_sql_require_primary_key)。 +- 强烈推荐在使用 TiCDC 时启用改变量，因为同步数据变更至 MySQL sink 时要求表必须有主键。 ### `sql_select_limit` 从 v4.0.2 版本开始引入 @@ -707,11 +709,15 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 ### `tidb_ddl_flashback_concurrency` 从 v6.3.0 版本开始引入 +> **警告：** +> +> 当前版本中该变量控制的功能尚未完全生效，请保留默认值。 + - 作用域：GLOBAL - 是否持久化到集群：是 - 默认值：`64` - 范围：`[1, 256]` -- 这个变量用来控制 `flashback cluster` 的并发数。**需要注意的是 `flashback cluster` 功能还未正式发布，请勿随意使用。** +- 这个变量用来控制 `flashback cluster` 的并发数。 ### `tidb_ddl_reorg_batch_size` @@ -967,21 +973,26 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 ### `tidb_enable_foreign_key` 从 v6.3.0 版本开始引入 +> **警告：** +> +> 当前版本中该变量控制的功能尚未完全生效，请保留默认值。 + - 作用域：GLOBAL - 是否持久化到集群：是 - 默认值：`OFF` -- 这个变量用于控制是否开启 `FOREIGN KEY` 特性，目前 `FOREIGN KEY` 特性还未 GA，不推荐开启该变量。 +- 这个变量用于控制是否开启 `FOREIGN KEY` 特性。 ### `tidb_enable_general_plan_cache` 从 v6.3.0 版本开始引入 +> **警告：** +> +> 当前版本中该变量控制的功能尚未完全生效，请保留默认值。 + - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 - 默认值：`OFF` - 这个变量用来控制是否开启 General Plan Cache。 -> **警告：** -> -> 当前版本中该变量控制的功能尚未完全生效，请保留默认值。 ### `tidb_enable_index_merge` 从 v4.0 版本开始引入 > **注意：** @@ -1180,10 +1191,14 @@ Query OK, 0 rows affected (0.09 sec) ### `tidb_enable_tiflash_read_for_write_stmt` 从 v6.3.0 版本开始引入 +> **警告：** +> +> 当前版本中该变量控制的功能尚未完全生效，请保留默认值。 + - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 - 默认值：`OFF` -- 这个变量用于控制写 SQL 中的读取是否会下推到 TiFlash。注意，该功能目前仅供测试，请保留其默认值 `OFF`。 +- 这个变量用于控制写 SQL 中的读取是否会下推到 TiFlash。 ### `tidb_enable_top_sql` 从 v5.4.0 版本开始引入 @@ -1413,20 +1428,21 @@ v5.0 后，用户仍可以单独修改以上系统变量（会有废弃警告） ### `tidb_general_plan_cache_size` 从 v6.3.0 版本开始引入 +> **警告：** +> +> 当前版本中该变量控制的功能尚未完全生效，请保留默认值。 + - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 - 默认值：`100` - 范围：`[1, 100000]` - 这个变量用来控制 General Plan Cache 最多能够缓存的计划数量。 -> **警告：** -> -> 当前版本中该变量控制的功能尚未完全生效，请保留默认值。 ### `tidb_guarantee_linearizability` 从 v5.0 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 -- 类型：布尔值 +- 类型：布尔型 - 默认值：`OFF` - 此变量控制异步提交 (Async Commit) 中提交时间戳的计算方式。默认情况下（使用 `OFF` 值），两阶段提交从 PD 服务器请求一个新的时间戳，并使用该时间戳计算最终提交的时间戳，这样可保证所有并发事务可线性化。 - 如果将该变量值设为 `ON`，从 PD 获取的时间戳的操作会被省掉，这种情况下只保证因果一致性但不保证线性一致性。详情请参考 PingCAP 博文 [Async Commit 原理介绍](https://pingcap.com/zh/blog/async-commit-principle)。 @@ -1936,7 +1952,7 @@ mysql> desc select count(distinct a) from test.t; - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 -- 类型：布尔值 +- 类型：布尔型 - 默认值：`ON` - 当该变量值为 `ON` 时，左连接始终使用内表作为构建端，右连接始终使用外表作为构建端。将该变量值设为 `OFF` 后，外连接可以灵活选择任意一边表作为构建端。 @@ -1985,7 +2001,7 @@ explain select * from t where age=5; - 作用域：SESSION - 是否持久化到集群：否 -- 类型：布尔值 +- 类型：布尔型 - 默认值：`OFF` - 指定是否允许优化器将 `Projection` 算子下推到 TiKV 或者 TiFlash。 @@ -2182,7 +2198,7 @@ explain select * from t where age=5; - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 -- 类型：布尔值 +- 类型：布尔型 - 默认值：`OFF` - 指定是否在子查询中移除 `ORDER BY` 子句。 @@ -2447,7 +2463,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 作用域：SESSION ｜ GLOBAL - 是否持久化到集群：是 -- 类型：布尔值 +- 类型：布尔型 - 默认值：`ON` - 本变量控制 TiDB 是否跟踪聚合函数的内存使用情况。 From 22a9773d4e418b23cde0a5427b70ce0f55f4add7 Mon Sep 17 00:00:00 2001 From: Arenatlx Date: Tue, 27 Sep 2022 18:00:36 +0800 Subject: [PATCH 13/13] Update system-variables.md Co-authored-by: Grace Cai --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index 11bce5418731..32047f24c621 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1073,7 +1073,7 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 - 作用域：SESSION ｜GLOBAL - 是否持久化到集群：是 - 默认值：`OFF` -- 自 v6.3.0 起，TiDB 的对特殊集合算子 `NOT IN` 和 `!= ALL` 引导子查询而产生的 ANTI JOIN 将可以使用此开关控制是否采用 Null Aware Hash Join 的执行方式。该开关默认为 `OFF`。 +- 这个变量用于控制 TiDB 对特殊集合算子 `NOT IN` 和 `!= ALL` 引导的子查询产生的 ANTI JOIN 是否采用 Null Aware Hash Join 的执行方式。 ### `tidb_enable_outer_join_reorder` 从 v6.1.0 版本开始引入