系统变量

TiDB 系统变量的行为与 MySQL 相似，变量的作用范围可以是会话级别有效 (Session Scope) 或全局范围有效 (Global Scope)。其中：

• 对 SESSION 作用域变量的更改，设置后只影响当前会话。
• 对 GLOBAL 作用域变量的更改，设置后立即生效。如果该变量也有 SESSION 作用域，已经连接的所有会话 (包括当前会话) 将继续使用会话当前的 SESSION 变量值。
• 要设置变量值，可使用 SET 语句。

# 以下两个语句等价地改变一个 Session 变量
SET tidb_distsql_scan_concurrency = 10;
SET SESSION tidb_distsql_scan_concurrency = 10;

# 以下两个语句等价地改变一个 Global 变量
SET @@global.tidb_distsql_scan_concurrency = 10;
SET GLOBAL tidb_distsql_scan_concurrency = 10;

从 v7.4.0 开始，部分 SESSION 作用域的变量可以通过 SET_VAR Hint 在语句执行期间临时修改变量的值。当语句执行完成后，系统变量将在当前会话中自动恢复为原始值。通过这个 Hint 可以修改一部分与优化器、执行器相关的系统变量行为。文档中的变量有一个“是否受 Hint SET_VAR 控制”的说明，可以为“是”或者“否”。

• 对于受 Hint SET_VAR 控制的变量，你可以在语句中使用 /*+ SET_VAR(...) */ 修改语句执行期间变量的值。
• 对于不受 Hint SET_VAR 控制的变量，你不能在语句中使用 /*+ SET_VAR(...) */ 修改语句执行期间变量的值。

关于 SET_VAR Hint 的更多说明，参考 SET_VAR。

变量参考

allow_auto_random_explicit_insert 从 v4.0.3 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 是否允许在 INSERT 语句中显式指定含有 AUTO_RANDOM 属性的列的值。

authentication_ldap_sasl_auth_method_name 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：SCRAM-SHA-1
• 可选值：SCRAM-SHA-1、SCRAM-SHA-256、GSSAPI
• LDAP SASL 身份验证中，验证方法的名称。

authentication_ldap_sasl_bind_base_dn 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：""
• LDAP SASL 身份验证中，搜索用户的范围。如果创建用户时没有通过 AS ... 指定 dn，TiDB 会自动在 LDAP Server 的该范围中根据用户名搜索用户 dn。例如 dc=example,dc=org。

authentication_ldap_sasl_bind_root_dn 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：""
• LDAP SASL 身份验证中，TiDB 登录 LDAP Server 搜索用户时使用的 dn。

authentication_ldap_sasl_bind_root_pwd 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：""
• LDAP SASL 身份验证中，TiDB 登录 LDAP Server 搜索用户时使用的密码。

authentication_ldap_sasl_ca_path 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：""
• LDAP SASL 身份验证中，TiDB 对 StartTLS 连接使用的 CA 证书的路径。

authentication_ldap_sasl_init_pool_size 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：10
• 范围：[1, 32767]
• LDAP SASL 身份验证中，TiDB 与 LDAP Server 间连接池的初始连接数。

authentication_ldap_sasl_max_pool_size 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：1000
• 范围：[1, 32767]
• LDAP SASL 身份验证中，TiDB 与 LDAP Server 间连接池的最大连接数。

authentication_ldap_sasl_server_host 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：""
• LDAP SASL 身份验证中，LDAP Server 的主机名或地址。

authentication_ldap_sasl_server_port 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：389
• 范围：[1, 65535]
• LDAP SASL 身份验证中，LDAP Server 的 TCP/IP 端口号。

authentication_ldap_sasl_tls 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• LDAP SASL 身份验证中，是否使用 StartTLS 对连接加密。

authentication_ldap_simple_auth_method_name 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：SIMPLE
• 可选值：SIMPLE
• LDAP simple 身份验证中，验证方法的名称。现在仅支持 SIMPLE。

authentication_ldap_simple_bind_base_dn 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：""
• LDAP simple 身份验证中，搜索用户的范围。如果创建用户时没有通过 AS ... 指定 dn，TiDB 会自动在 LDAP Server 的该范围中根据用户名搜索用户 dn。例如 dc=example,dc=org。

authentication_ldap_simple_bind_root_dn 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：""
• LDAP simple 身份验证中，TiDB 登录 LDAP Server 搜索用户时使用的 dn。

authentication_ldap_simple_bind_root_pwd 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：""
• LDAP simple 身份验证中，TiDB 登录 LDAP Server 搜索用户时使用的密码。

authentication_ldap_simple_ca_path 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：""
• LDAP simple 身份验证中，TiDB 对 StartTLS 连接使用的 CA 证书的路径。

authentication_ldap_simple_init_pool_size 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：10
• 范围：[1, 32767]
• LDAP simple 身份验证中，TiDB 与 LDAP Server 间连接池的初始连接数。

authentication_ldap_simple_max_pool_size 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：1000
• 范围：[1, 32767]
• LDAP simple 身份验证中，TiDB 与 LDAP Server 间连接池的最大连接数。

authentication_ldap_simple_server_host 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：""
• LDAP simple 身份验证中，LDAP Server 的主机名或地址。

authentication_ldap_simple_server_port 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：389
• 范围：[1, 65535]
• LDAP simple 身份验证中，LDAP Server 的 TCP/IP 端口号。

authentication_ldap_simple_tls 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• LDAP simple 身份验证中，是否使用 StartTLS 对连接加密。

auto_increment_increment

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：1
• 范围：[1, 65535]
• 控制 AUTO_INCREMENT 自增值字段的自增步长和 AUTO_RANDOM ID 的分配规则。该变量常与 auto_increment_offset 一起使用。

auto_increment_offset

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：1
• 范围：[1, 65535]
• 控制 AUTO_INCREMENT 自增值字段的初始值和 AUTO_RANDOM ID 的分配规则。该变量常与 auto_increment_increment 一起使用。示例如下：

mysql> CREATE TABLE t1 (a int not null primary key auto_increment);
Query OK, 0 rows affected (0.10 sec)

mysql> set auto_increment_offset=1;
Query OK, 0 rows affected (0.00 sec)

mysql> set auto_increment_increment=3;
Query OK, 0 rows affected (0.00 sec)

mysql> INSERT INTO t1 VALUES (),(),(),();
Query OK, 4 rows affected (0.04 sec)
Records: 4  Duplicates: 0  Warnings: 0

mysql> SELECT * FROM t1;
+----+
| a  |
+----+
|  1 |
|  4 |
|  7 |
| 10 |
+----+
4 rows in set (0.00 sec)

autocommit

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 用于设置在非显式事务时是否自动提交事务。更多信息，请参见事务概述。

block_encryption_mode

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：aes-128-ecb
• 可选值：aes-128-ecb、aes-192-ecb、aes-256-ecb、aes-128-cbc、aes-192-cbc、aes-256-cbc、aes-128-ofb、aes-192-ofb、aes-256-ofb、aes-128-cfb、aes-192-cfb、aes-256-cfb
• 该变量用于设置 AES_ENCRYPT() 和 AES_DECRYPT() 函数的加密模式。

character_set_client

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：utf8mb4
• 这个变量表示从客户端发出的数据所用的字符集。有关更多 TiDB 支持的字符集和排序规则，参阅字符集和排序规则文档。如果需要更改字符集，建议使用 SET NAMES 语句。

character_set_connection

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：utf8mb4
• 若没有为字符串常量指定字符集，该变量表示这些字符串常量所使用的字符集。

character_set_database

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：utf8mb4
• 该变量表示当前默认在用数据库的字符集，不建议设置该变量。选择新的默认数据库后，服务器会更改该变量的值。

character_set_results

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：utf8mb4
• 该变量表示数据发送至客户端时所使用的字符集。

character_set_server

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：utf8mb4
• 当 CREATE SCHEMA 中没有指定字符集时，该变量表示这些新建的表结构所使用的字符集。

collation_connection

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：utf8mb4_bin
• 该变量表示连接中所使用的排序规则。与 MySQL 中的 collation_connection 一致。

collation_database

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：utf8mb4_bin
• 该变量表示当前数据库默认所使用的排序规则。与 MySQL 中的 collation_database 一致。不建议设置此变量，当前使用的数据库变动时，此变量会被 TiDB 修改。

collation_server

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：utf8mb4_bin
• 该变量表示创建数据库时默认的排序规则。

cte_max_recursion_depth

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：1000
• 范围：[0, 4294967295]
• 这个变量用于控制公共表表达式的最大递归深度。

datadir

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 默认值：使用的组件和部署方式不同，默认值也不同。
  • /tmp/tidb：如果你将 --store 设置为 "unistore" 或没有设置 --store，则默认值为 /tmp/tidb。
  • ${pd-ip}:${pd-port}：如果你设置的存储引擎是 TiKV（如果使用 TiUP 和 TiDB Operator 部署，则默认的存储引擎为 TiKV），则默认值为 ${pd-ip}:${pd-port}。
• 这个变量表示数据存储的位置，位置可以是本地路径 /tmp/tidb。如果数据存储在 TiKV 上，则可以是指向 PD 服务器的路径。变量值的格式为 ${pd-ip}:${pd-port}，表示 TiDB 在启动时连接到的 PD 服务器。

ddl_slow_threshold

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：300
• 取值范围：[0, 2147483647]
• 单位：毫秒
• 耗时超过该阈值的 DDL 操作会被输出到日志。

default_authentication_plugin

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：mysql_native_password
• 可选值：mysql_native_password，caching_sha2_password，tidb_sm3_password，tidb_auth_token，authentication_ldap_sasl 或 authentication_ldap_simple。
• 服务器和客户端建立连接时，这个变量用于设置服务器对外通告的默认身份验证方式。如要了解该变量的其他可选值，参见可用的身份验证插件。
• 若要在用户登录时使用 tidb_sm3_password 插件，需要使用 TiDB-JDBC 进行连接。

default_collation_for_utf8mb4 从 v7.4.0 版本开始引入

• 作用域：GLOBAL | SESSION
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 默认值：utf8mb4_bin
• 可选值：utf8mb4_bin、utf8mb4_general_ci、utf8mb4_0900_ai_ci
• 该变量用于设置 utf8mb4 字符集的默认排序规则。它会影响以下语句的行为：
  • SHOW COLLATION 和 SHOW CHARACTER SET 语句显示的默认排序规则。
  • CREATE TABLE 和 ALTER TABLE 语句中对表或列使用 CHARACTER SET 语法明确指定 utf8mb4 字符集而未指定排序规则时，将使用该变量指定的排序规则。不影响未使用 CHARACTER SET 语法时的行为。
  • CREATE DATABASE 和 ALTER DATABASE 语句中使用 CHARACTER SET 语法明确指定 utf8mb4 字符集而未指定排序规则时，将使用该变量指定的排序规则。不影响未使用 CHARACTER SET 语法时的行为。
  • 任何使用 _utf8mb4'string' 形式的字面量在未使用 COLLATE 语法指定排序规则时，将使用该变量指定的排序规则。

default_password_lifetime 从 v6.5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 取值范围：[0, 65535]
• 该变量用于设置全局自动密码过期策略，默认值为 0，即禁用全局自动密码过期。如果设置该变量的值为正整数 N，则表示允许的密码生存期为 N，即必须在 N 天之内更改密码。

default_week_format

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 取值范围：[0, 7]
• 设置 WEEK() 函数使用的周格式。

disconnect_on_expired_password 从 v6.5.0 版本开始引入

• 作用域：GLOBAL
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 该变量是一个只读变量，用来显示 TiDB 是否会直接断开密码已过期用户的连接。当其值为 ON，表示 TiDB 会断开密码已过期用户的连接。当其值为 OFF，表示 TiDB 会将密码已过期用户的连接置于“沙盒模式”，允许该用户建立连接并执行密码重置操作。
• 如果需要改变 TiDB 对密码已过期用户连接的处理方式，请在 TiDB 配置文件中的 [security] 部分修改 disconnect-on-expired-password 选项。

div_precision_increment 从 v8.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：4
• 范围：[0, 30]
• 这个变量用于控制使用运算符 / 执行除法操作时，结果增加的小数位数。该功能与 MySQL 保持一致。

error_count

• 作用域：SESSION
• 默认值：0
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 表示上一条生成消息的 SQL 语句中的错误数。该变量为只读变量。

foreign_key_checks

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：在 v6.6.0 之前版本中为 OFF，在 v6.6.0 及之后的版本中为 ON。
• 表示是否开启外键约束检查。

group_concat_max_len

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：1024
• 取值范围：[4, 18446744073709551615]
• 表示 GROUP_CONCAT() 函数缓冲区的最大长度。

have_openssl

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：DISABLED
• 用于 MySQL 兼容性的只读变量。当服务器启用 TLS 时，服务器将其设置为 YES。

have_ssl

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：DISABLED
• 用于 MySQL 兼容性的只读变量。当服务器启用 TLS 时，服务器将其设置为 YES。

hostname

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 默认值：（系统主机名）
• 这个变量为只读变量，表示 TiDB server 的主机名。

identity 从 v5.3.0 版本开始引入

• 该变量为变量 last_insert_id 的别名。

init_connect

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：""
• 用户首次连接到 TiDB 服务器时，init_connect 特性允许 TiDB 自动执行一条或多条 SQL 语句。如果你有 CONNECTION_ADMIN 或者 SUPER 权限，这些 SQL 语句将不会被自动执行。如果这些语句执行报错，你的用户连接将被终止。

innodb_lock_wait_timeout

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：50
• 范围：[1, 3600]
• 单位：秒
• 悲观事务语句等锁时间。

interactive_timeout

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：28800
• 范围：[1, 31536000]
• 单位：秒
• 该变量表示交互式用户会话的空闲超时。交互式用户会话是指使用 CLIENT_INTERACTIVE 选项调用 mysql_real_connect() API 建立的会话（例如：MySQL shell 和 MySQL client）。该变量与 MySQL 完全兼容。

last_insert_id 从 v5.3.0 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 取值范围：[0, 18446744073709551615]
• 返回由 INSERT 语句产生的最新 AUTO_INSCRENT 或者 AUTO_RANDOM 值，与 LAST_INSERT_ID() 的返回的结果相同。与 MySQL 中的 last_insert_id 一致。

last_plan_from_binding 从 v4.0 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 该变量用来显示上一条执行的语句所使用的执行计划是否来自 binding 的执行计划。

last_plan_from_cache 从 v4.0 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来显示上一个 execute 语句所使用的执行计划是不是直接从 plan cache 中取出来的。

last_sql_use_alloc 从 v6.4.0 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 默认值：OFF
• 这个变量是一个只读变量，用来显示上一个语句是否使用了缓存的 Chunk 对象 (Chunk allocation)。

license

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 默认值：Apache License 2.0
• 这个变量表示 TiDB 服务器的安装许可证。

max_connections

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 取值范围：[0, 100000]
• 该变量表示 TiDB 中同时允许的最大客户端连接数，用于资源控制。
• 默认情况下，该变量值为 0 表示不限制客户端连接数。当本变量的值大于 0 且客户端连接数到达此值时，TiDB 服务端将会拒绝新的客户端连接。

max_execution_time

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：0
• 范围：[0, 2147483647]
• 单位：毫秒
• 语句最长执行时间。默认值 (0) 表示无限制。

max_prepared_stmt_count

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：-1
• 范围：[-1, 1048576]
• 指定当前实例中 PREPARE 语句的最大数量。
• 值为 -1 时表示不对实例中的 PREPARE 语句数量进行限制。
• 如果将变量值设为超过上限 1048576，则使用上限值 1048576：

mysql> SET GLOBAL max_prepared_stmt_count = 1048577;
Query OK, 0 rows affected, 1 warning (0.01 sec)

mysql> SHOW WARNINGS;
+---------+------+--------------------------------------------------------------+
| Level   | Code | Message                                                      |
+---------+------+--------------------------------------------------------------+
| Warning | 1292 | Truncated incorrect max_prepared_stmt_count value: '1048577' |
+---------+------+--------------------------------------------------------------+
1 row in set (0.00 sec)

mysql> SHOW GLOBAL VARIABLES LIKE 'max_prepared_stmt_count';
+-------------------------+---------+
| Variable_name           | Value   |
+-------------------------+---------+
| max_prepared_stmt_count | 1048576 |
+-------------------------+---------+
1 row in set (0.00 sec)

max_allowed_packet 从 v6.1.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：67108864
• 取值范围：[1024, 1073741824]
• 该变量取值应为 1024 的整数倍。若取值无法被 1024 整除，则会提示 warning 并向下取整。例如设置为 1025 时，则 TiDB 中的实际取值为 1024。
• 服务器端和客户端在一次传送数据包的过程中所允许最大的数据包大小，单位为字节。
• 在 SESSION 作用域下，该变量为只读变量。
• 该变量的行为与 MySQL 兼容。

mpp_exchange_compression_mode 从 v6.6.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 默认值：UNSPECIFIED
• 可选值：NONE，FAST，HIGH_COMPRESSION，UNSPECIFIED
• 该变量用于选择 MPP Exchange 算子的数据压缩模式，当 TiDB 选择版本号为 1 的 MPP 执行计划时生效。该变量值的含义如下：
  • UNSPECIFIED：表示未指定，TiDB 将自动选择压缩模式，当前 TiDB 自动选择 FAST 模式
  • NONE：不使用数据压缩
  • FAST：快速模式，整体性能较好，压缩比小于 HIGH_COMPRESSION
  • HIGH_COMPRESSION：高压缩比模式

mpp_version 从 v6.6.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 默认值：UNSPECIFIED
• 可选值：UNSPECIFIED，0，1，2
• 该变量用于指定不同版本的 MPP 执行计划。指定后，TiDB 会选择指定版本的 MPP 执行计划。该变量值含义如下：
  • UNSPECIFIED：表示未指定，此时 TiDB 自动选择最新版本 2。
  • 0：兼容所有 TiDB 集群版本，MPP 版本大于 0 的新特性均不会生效。
  • 1：从 v6.6.0 版本开始引入，用于开启 TiFlash 带压缩的数据交换，详情参见 MPP Version 和 Exchange 数据压缩。
  • 2：从 v7.3.0 版本开始引入，用于确保在 TiFlash 执行出错的情况下，获取到准确的报错信息。

password_history 从 v6.5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 范围：[0, 4294967295]
• 该变量用于建立密码重用策略，使 TiDB 基于密码更改次数限制密码的重复使用。该变量默认值为 0，表示禁用基于密码更改次数的密码重用策略。当设置该变量为一个正整数 N 时，表示不允许重复使用最近 N 次使用过的密码。

password_reuse_interval 从 v6.5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 范围：[0, 4294967295]
• 该变量用于建立密码重用策略，使 TiDB 基于经过时间限制密码重复使用。该变量默认值为 0，表示禁用基于密码经过时间的密码重用策略。当设置该变量为一个正整数 N 时，表示不允许重复使用最近 N 天内使用过的密码。

pd_enable_follower_handle_region 从 v7.6.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启 Active PD Follower 特性（目前该特性只适用于处理获取 Region 信息的相关请求）。当该值为 OFF 时，TiDB 仅从 PD leader 获取 Region 信息。当该值为 ON 时，TiDB 在获取 Region 信息时会将请求均匀地发送到所有 PD 节点上，因此 PD follower 也可以处理 Region 信息请求，从而减轻 PD leader 的 CPU 压力。
• 适合开启 Active PD Follower 的场景：
  • 集群 Region 数量较多，PD leader 由于处理心跳和调度任务的开销大，导致 CPU 资源紧张。
  • 集群中 TiDB 实例数量较多，Region 信息请求并发量较大，PD leader CPU 压力大。

plugin_dir

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 默认值：""
• 指定加载插件的目录。

plugin_load

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 默认值：""
• 指定 TiDB 启动时加载的插件，多个插件之间用逗号（,）分隔。

port

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：4000
• 范围：[0, 65535]
• 使用 MySQL 协议时 tidb-server 监听的端口。

rand_seed1

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 范围：[0, 2147483647]
• 该变量用于为 SQL 函数 RAND() 中使用的随机值生成器添加种子。
• 该变量的行为与 MySQL 兼容。

rand_seed2

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 范围：[0, 2147483647]
• 该变量用于为 SQL 函数 RAND() 中使用的随机值生成器添加种子。
• 该变量的行为与 MySQL 兼容。

require_secure_transport 从 v6.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 该变量控制是否所有 TiDB 的连接都在本地 socket 上进行通信，或使用 TLS。详情见为 TiDB 客户端服务端间通信开启加密传输。
• 该变量设置为 ON 时，必须使用开启 TLS 的会话连接到 TiDB，防止在 TLS 配置不正确时出现锁定的情况。
• 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (security.require-secure-transport) 进行配置，升级到 v6.1.0 时会自动继承原有设置。
• 从 v6.5.6、v7.1.2、v7.5.1 和 v8.0.0 起，当启用了安全增强模式 (SEM) 时，禁止将 security.require-secure-transport 设置为 ON。

skip_name_resolve 从 v5.2.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 该变量控制 tidb-server 实例是否将主机名作为连接握手的一部分来解析。
• 当 DNS 不可靠时，可以启用该变量来提高网络性能。

CREATE USER 'appuser'@'apphost' IDENTIFIED BY 'app-password';

socket

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 默认值：""
• 使用 MySQL 协议时，tidb-server 所监听的本地 unix 套接字文件。

sql_mode

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 默认值：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_require_primary_key 从 v6.3.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制表是否必须有主键。启用该变量后，如果在没有主键的情况下创建或修改表，将返回错误。
• 该功能基于 MySQL 8.0 的特性 sql_require_primary_key。
• 强烈推荐在使用 TiCDC 时启用该变量，因为同步数据变更至 MySQL sink 时要求表必须有主键。
• 如果启用了该变量，且使用了 TiDB Data Migration (DM) 来迁移数据，建议在 DM 任务配置文件里的 session 中添加该系统变量 sql_require_primary_key 并设置为 OFF，否则会导致 DM 任务创建失败。

sql_select_limit 从 v4.0.2 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：18446744073709551615
• 范围：[0, 18446744073709551615]
• 单位：行
• SELECT 语句返回的最大行数。

ssl_ca

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 默认值：""
• 证书颁发机构 (CA) 文件的位置。若文件不存在，则变量值为空。该变量的值由 TiDB 配置项 ssl-ca 定义。

ssl_cert

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 默认值：""
• 用于 SSL/TLS 连接的证书文件的位置。若文件不存在，则变量值为空。该变量的值由 TiDB 配置项 ssl-cert 定义。

ssl_key

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 默认值：""
• 用于 SSL/TLS 连接的私钥文件的位置。若文件不存在，则变量值为空。该变量的值由 TiDB 配置项 ssl-key 定义。

system_time_zone

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 默认值：（随系统）
• 该变量显示首次引导启动 TiDB 时的系统时区。另请参阅 time_zone。

tidb_adaptive_closest_read_threshold 从 v6.3.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：4096
• 取值范围：[0, 9223372036854775807]
• 单位：字节
• 这个变量用于控制当 replica-read 设置为 closest-adaptive 时，优先将读请求发送至 TiDB server 所在区域副本的阈值。当读请求预估的返回结果的大小超过此阈值时，TiDB 会将读请求优先发送至同一可用区的副本，否则会发送至 leader 副本。

tidb_allow_tiflash_cop 从 v7.3.0 版本开始引入

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：布尔型

• 默认值：OFF

• 当 TiDB 给 TiFlash 下推计算任务时，有三种方法（或协议）可供选择：Cop、BatchCop 和 MPP。相比于 Cop 和 BatchCop，MPP 协议更加成熟，提供更好的任务和资源管理。因此，更推荐使用 MPP 协议。

  • 0 或 OFF：优化器仅生成使用 TiFlash MPP 协议的计划。
  • 1 或 ON：优化器根据成本估算从 Cop、BatchCop 和 MPP 协议中选择一个用于生成执行计划。

tidb_allow_batch_cop 从 v4.0 版本开始引入

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：是

• 类型：整数型

• 默认值：1

• 范围：[0, 2]

• 这个变量用于控制 TiDB 向 TiFlash 发送 coprocessor 请求的方式，有以下几种取值：

  • 0：从不批量发送请求
  • 1：aggregation 和 join 的请求会进行批量发送
  • 2：所有的 cop 请求都会批量发送

tidb_allow_fallback_to_tikv 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 默认值：""
• 这个变量表示将 TiKV 作为备用存储引擎的存储引擎列表。当该列表中的存储引擎发生故障导致 SQL 语句执行失败时，TiDB 会使用 TiKV 作为存储引擎再次执行该 SQL 语句。目前支持设置该变量为 "" 或者 "tiflash"。如果设置该变量为 "tiflash"，当 TiFlash 返回超时错误（对应的错误码为 ErrTiFlashServerTimeout）时，TiDB 会使用 TiKV 作为存储引擎再次执行该 SQL 语句。

tidb_allow_function_for_expression_index 从 v5.2.0 版本开始引入

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 默认值：json_array, json_array_append, json_array_insert, json_contains, json_contains_path, json_depth, json_extract, json_insert, json_keys, json_length, json_merge_patch, json_merge_preserve, json_object, json_pretty, json_quote, json_remove, json_replace, json_search, json_set, json_storage_size, json_type, json_unquote, json_valid, lower, md5, reverse, tidb_shard, upper, vitess_hash
• 这个只读变量用于显示创建表达式索引所允许使用的函数。

tidb_allow_mpp 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：ON
• 这个变量用于控制是否使用 TiFlash 的 MPP 模式执行查询，可以设置的值包括：
  • 0 或 OFF，代表从不使用 MPP 模式。如果在 v7.3.0 及之后的版本将该变量值设置为 0 或 OFF，你需要同时开启 tidb_allow_tiflash_cop 变量，否则可能遇到查询报错。
  • 1 或 ON，代表由优化器根据代价估算选择是否使用 MPP 模式（默认）。

MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数据交换并提供高性能、高吞吐的 SQL 算法。MPP 模式选择的详细说明参见控制是否选择 MPP 模式。

tidb_allow_remove_auto_inc 从 v2.1.18 和 v3.0.4 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来控制是否允许通过 ALTER TABLE MODIFY 或 ALTER TABLE CHANGE 来移除某个列的 AUTO_INCREMENT 属性。默认 (OFF) 为不允许。

tidb_analyze_column_options 从 v8.3.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：PREDICATE
• 可选值：ALL，PREDICATE
• 该变量控制 ANALYZE TABLE 语句的行为。将其设置为 PREDICATE 表示仅收集 predicate columns 的统计信息；将其设置为 ALL 表示收集所有列的统计信息。在使用 OLAP 查询的场景中，建议将其设置为 ALL，否则查询性能可能会显著下降。

tidb_analyze_distsql_scan_concurrency 从 v7.6.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：4
• 范围：[0, 4294967295]。在 v8.2.0 之前版本中，最小值为 1。当设置为 0 时，TiDB 会根据集群规模自适应调整并发度。
• 这个变量用来设置执行 ANALYZE 时 scan 操作的并发度。

tidb_analyze_partition_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：2。TiDB v7.4.0 及其之前版本默认值为 1。
• 范围：[1, 128]。在 v8.4.0 之前版本中，取值范围是 [1, 18446744073709551615]。
• 这个变量用于 TiDB analyze 分区表时，写入分区表统计信息的并发度。

tidb_analyze_version 从 v5.1.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：2
• 范围：[1, 2]
• 这个变量用于控制 TiDB 收集统计信息的行为。
• 在 v5.3.0 及之后的版本中，该变量的默认值为 2，具体可参照常规统计信息文档。如果从 v5.3.0 之前版本的集群升级至 v5.3.0 及之后的版本，tidb_analyze_version 的默认值不发生变化。

tidb_analyze_skip_column_types 从 v7.2.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值："json,blob,mediumblob,longblob,mediumtext,longtext"。在 v8.2.0 之前，默认值为 "json,blob,mediumblob,longblob"。
• 可选值："json,blob,mediumblob,longblob,text,mediumtext,longtext"
• 这个变量表示在执行 ANALYZE 命令收集统计信息时，跳过哪些类型的列的统计信息收集。该变量仅适用于 tidb_analyze_version = 2 的情况。即使使用 ANALYZE TABLE t COLUMNS c1, ..., cn 语法指定列，如果指定的列的类型在 tidb_analyze_skip_column_types 中，也不会收集该列的统计信息。

mysql> SHOW CREATE TABLE t;
+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Table | Create Table                                                                                                                                                                                                             |
+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| t     | CREATE TABLE `t` (
  `a` int(11) DEFAULT NULL,
  `b` varchar(10) DEFAULT NULL,
  `c` json DEFAULT NULL,
  `d` blob DEFAULT NULL,
  `e` longblob DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin |
+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set (0.00 sec)

mysql> SELECT @@tidb_analyze_skip_column_types;
+----------------------------------+
| @@tidb_analyze_skip_column_types |
+----------------------------------+
| json,blob,mediumblob,longblob    |
+----------------------------------+
1 row in set (0.00 sec)

mysql> ANALYZE TABLE t;
Query OK, 0 rows affected, 1 warning (0.05 sec)

mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1;
+---------------------------------------------------------------------+
| job_info                                                            |
+---------------------------------------------------------------------+
| analyze table columns a, b with 256 buckets, 500 topn, 1 samplerate |
+---------------------------------------------------------------------+
1 row in set (0.00 sec)

mysql> ANALYZE TABLE t COLUMNS a, c;
Query OK, 0 rows affected, 1 warning (0.04 sec)

mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1;
+------------------------------------------------------------------+
| job_info                                                         |
+------------------------------------------------------------------+
| analyze table columns a with 256 buckets, 500 topn, 1 samplerate |
+------------------------------------------------------------------+
1 row in set (0.00 sec)

tidb_auto_analyze_concurrency 从 v8.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：1
• 范围：[1, 2147483647]
• 这个变量用来设置单个自动统计信息收集任务内部的并发度。在 v8.4.0 之前的版本中，该并发度固定为 1。你可以根据集群资源情况提高该并发度，从而加快统计信息收集任务的执行速度。

tidb_auto_analyze_end_time

• 作用域：GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：时间

• 默认值：23:59 +0000

• 这个变量用来设置一天中允许自动 ANALYZE 更新统计信息的结束时间。例如，只允许在 UTC 时间的凌晨 1:00 至 3:00 之间自动更新统计信息，可以设置如下：

  • tidb_auto_analyze_start_time='01:00 +0000'
  • tidb_auto_analyze_end_time='03:00 +0000'

tidb_auto_analyze_partition_batch_size 从 v6.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：128。对于 TiDB v7.6.0 之前的版本，默认值为 1。
• 范围：[1, 1024]
• 用于设置 TiDB 自动 analyze 分区表（即自动收集分区表上的统计信息）时，每次同时 analyze 分区的个数。
• 若该变量值小于分区表的分区数，则 TiDB 会分多批自动 analyze 该分区表的所有分区。若该变量值大于等于分区表的分区数，则 TiDB 会同时 analyze 该分区表的所有分区。
• 若分区表个数远大于该变量值，且自动 analyze 花费时间较长，可调大该参数的值以减少耗时。

tidb_auto_analyze_ratio

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：浮点数
• 默认值：0.5
• 范围：(0, 1]，v8.0.0 及之前版本范围为 [0, 18446744073709551615]。
• 这个变量用来设置 TiDB 在后台自动执行 ANALYZE TABLE 更新统计信息的阈值。0.5 指的是当表中超过 50% 的行被修改时，触发自动 ANALYZE 更新。可以指定 tidb_auto_analyze_start_time 和 tidb_auto_analyze_end_time 来限制自动 ANALYZE 的时间。

tidb_auto_analyze_start_time

• 作用域：GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：时间

• 默认值：00:00 +0000

• 这个变量用来设置一天中允许自动 ANALYZE 更新统计信息的开始时间。例如，只允许在 UTC 时间的凌晨 1:00 至 3:00 之间自动更新统计信息，可以设置如下：

  • tidb_auto_analyze_start_time='01:00 +0000'
  • tidb_auto_analyze_end_time='03:00 +0000'

tidb_auto_build_stats_concurrency 从 v6.5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：1
• 范围：[1, 256]
• 这个变量用来设置执行统计信息自动更新的并发度。

tidb_backoff_lock_fast

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：10
• 范围：[1, 2147483647]
• 这个变量用来设置读请求遇到锁的 backoff 时间。

tidb_backoff_weight

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：整数型

• 默认值：2

• 范围：[0, 2147483647]

• 这个变量用来给 TiDB 的 backoff 最大时间增加权重，即内部遇到网络或其他组件 (TiKV, PD) 故障时，发送重试请求的最大重试时间。可以通过这个变量来调整最大重试时间，最小值为 1。

  例如，TiDB 向 PD 取 TSO 的基础超时时间是 15 秒，当 tidb_backoff_weight = 2 时，取 TSO 的最大超时时间为：基础时间 * 2 等于 30 秒。

  在网络环境较差的情况下，适当增大该变量值可以有效缓解因为超时而向应用端报错的情况；而如果应用端希望更快地接到报错信息，则应该尽量减小该变量的值。

tidb_batch_commit

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 该变量控制是否启用已废弃的 batch-commit 特性。当该变量开启时，事务可能会通过分组一些语句被拆分为多个事务，并被非原子地提交。不推荐使用这种方式。

tidb_batch_delete

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 该变量控制是否启用已废弃的 batch-dml 特性中的 batch-delete 特性。当该变量开启时，DELETE 语句可能会被拆分为多个事务，并被非原子地提交。要使该特性生效，还需要开启 tidb_enable_batch_dml 并将 tidb_dml_batch_size 的值设置为正数。不推荐使用这种方式。

tidb_batch_insert

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 该变量控制是否启用已废弃的 batch-dml 特性中的 batch-insert 特性。当该变量开启时，INSERT 语句可能会被拆分为多个事务，并被非原子地提交。要使该特性生效，还需要开启 tidb_enable_batch_dml 并将 tidb_dml_batch_size 的值设置为正数。不推荐使用这种方式。

tidb_batch_pending_tiflash_count 从 v6.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：4000
• 范围：[0, 4294967295]
• 使用 ALTER DATABASE SET TIFLASH REPLICA 语句为 TiFlash 添加副本时，能容许的不可用表的个数上限。如果超过该上限，则会停止或者以非常慢的速度为库中的剩余表设置 TiFlash 副本。

tidb_broadcast_join_threshold_count 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：10240
• 范围：[0, 9223372036854775807]
• 单位：行
• 如果 join 的对象为子查询，优化器无法估计子查询结果集大小，在这种情况下通过结果集行数判断。如果子查询的行数估计值小于该变量，则选择 Broadcast Hash Join 算法。否则选择 Shuffled Hash Join 算法。
• 开启 tidb_prefer_broadcast_join_by_exchange_data_size 功能后，该变量将不再生效。

tidb_broadcast_join_threshold_size 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：104857600 (100 MiB)
• 范围：[0, 9223372036854775807]
• 单位：字节
• 如果表大小（字节数）小于该值，则选择 Broadcast Hash Join 算法。否则选择 Shuffled Hash Join 算法。
• 开启 tidb_prefer_broadcast_join_by_exchange_data_size 功能后，该变量将不再生效。

tidb_build_stats_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 单位：线程
• 默认值：2。TiDB v7.4.0 及其之前版本默认值为 4。
• 取值范围：[1, 256]
• 这个变量用来设置 ANALYZE 语句执行时并发度。
• 当这个变量被设置得更大时，会对其它的查询语句执行性能产生一定影响。

tidb_build_sampling_stats_concurrency 从 v7.5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 单位：线程
• 默认值：2
• 取值范围：[1, 256]
• 这个变量用来设置 ANALYZE 过程中的采样并发度。
• 当这个变量被设置得更大时，会对其它的查询语句执行性能产生一定影响。

tidb_capture_plan_baselines 从 v4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启自动捕获绑定功能。该功能依赖 Statement Summary，因此在使用自动绑定之前需打开 Statement Summary 开关。
• 开启该功能后会定期遍历一次 Statement Summary 中的历史 SQL 语句，并为至少出现两次的 SQL 语句自动创建绑定。

tidb_cdc_write_source 从 v6.5.0 版本开始引入

• 作用域：SESSION
• 是否持久化到集群：否
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值： 0
• 范围：[0, 15]
• 当变量非 0 时，该 SESSION 写入的数据将被视为是由 TiCDC 写入的。这个变量仅由 TiCDC 设置，任何时候都不应该手动调整该变量。

tidb_check_mb4_value_in_utf8

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 设置该变量为 ON 可强制只存储基本多文种平面 (BMP) 编码区段内的 utf8 字符值。若要存储 BMP 区段外的 utf8 值，推荐使用 utf8mb4 字符集。
• 早期版本的 TiDB 中 (v2.1.x)，utf8 检查更为宽松。如果你的 TiDB 集群是从早期版本升级的，推荐关闭该变量，详情参阅升级与升级后常见问题。

tidb_committer_concurrency 从 v6.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：128
• 范围：[1, 10000]
• 在单个事务的提交阶段，用于执行提交操作相关请求的 goroutine 数量。
• 若提交的事务过大，事务提交时的流控队列等待耗时可能会过长。此时，可以通过调大该配置项来加速提交。
• 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (performance.committer-concurrency) 进行配置，升级到 v6.1.0 时会自动继承原有设置。

tidb_checksum_table_concurrency

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：4
• 取值范围：[1, 256]
• 单位：线程
• 这个变量用来设置 ADMIN CHECKSUM TABLE 语句执行时扫描索引的并发度。当这个变量被设置得更大时，会对其它的查询语句执行性能产生一定影响。

tidb_config

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 默认值：""
• 这个变量是一个只读变量，用来获取当前 TiDB Server 的配置信息。

tidb_constraint_check_in_place

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：布尔型

• 默认值：OFF

• 该变量仅适用于乐观事务模型。悲观事务模式中的行为由 tidb_constraint_check_in_place_pessimistic 控制。

• 当这个变量设置为 OFF 时，唯一索引的重复值检查会被推迟到事务提交时才进行。这有助于提高性能，但对于某些应用，可能导致非预期的行为。详情见约束。

  • 乐观事务模型下将 tidb_constraint_check_in_place 设置为 OFF：

    create table t (i int key);
    insert into t values (1);
    begin optimistic;
    insert into t values (1);
    

    Query OK, 1 row affected
    

    tidb> commit; -- 事务提交时才检查
    

    ERROR 1062 : Duplicate entry '1' for key 't.PRIMARY'
    

  • 乐观事务模型下将 tidb_constraint_check_in_place 设置为 ON：

    set @@tidb_constraint_check_in_place=ON;
    begin optimistic;
    insert into t values (1);
    

    ERROR 1062 : Duplicate entry '1' for key 't.PRIMARY'
    

tidb_constraint_check_in_place_pessimistic 从 v6.3.0 版本开始引入

• 作用域：SESSION

• 是否受 Hint SET_VAR 控制：否

• 类型：布尔型

• 默认值：当配置项 pessimistic-txn.constraint-check-in-place-pessimistic 为默认值 true 时，该变量的默认值为 ON。当配置项 pessimistic-txn.constraint-check-in-place-pessimistic 为 false 时，该变量的默认值为 OFF。

• 该变量仅适用于悲观事务模型。乐观事务模式中的行为由 tidb_constraint_check_in_place 控制。

• 当这个变量设置为 OFF 时，唯一约束检查会被推迟到下一次需要对这个索引加锁的语句执行时，或事务提交时才进行。这有助于提高性能，但对于某些应用，可能导致非预期的行为。详情见约束。

• 关闭该变量可能会导致悲观事务中返回 LazyUniquenessCheckFailure 报错。返回该错误时，TiDB 将会回滚当前事务。

• 关闭该变量后，悲观事务中不支持使用 SAVEPOINT 功能。

• 关闭该变量时，commit 语句可能会报出 Write conflict 错误或 Duplicate entry 错误，两种错误都意味着事务回滚。

  • 悲观事务模型下将 tidb_constraint_check_in_place_pessimistic 设置为 OFF：

    set @@tidb_constraint_check_in_place_pessimistic=OFF;
    create table t (i int key);
    insert into t values (1);
    begin pessimistic;
    insert into t values (1);
    

    Query OK, 1 row affected
    

    tidb> commit; -- 事务提交时才检查
    

    ERROR 1062 : Duplicate entry '1' for key 't.PRIMARY'
    

  • 悲观事务模型下将 tidb_constraint_check_in_place_pessimistic 设置为 ON：

    set @@tidb_constraint_check_in_place_pessimistic=ON;
    begin pessimistic;
    insert into t values (1);
    

    ERROR 1062 : Duplicate entry '1' for key 't.PRIMARY'
    

tidb_cost_model_version 从 v6.2.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：2
• 取值范围：[1, 2]
• 可选值：
  • 1：使用 Cost Model Version 1 代价模型。TiDB v6.4.0 及之前的版本默认使用 Cost Model Version 1。
  • 2：使用 Cost Model Version 2 代价模型。TiDB v6.5.0 正式发布了代价模型 Cost Model Version 2，在内部测试中比 Version 1 版本的代价模型更加准确。
• 代价模型会影响优化器对计划的选择，具体可见代价模型。

tidb_current_ts

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 取值范围：[0, 9223372036854775807]
• 这个变量是一个只读变量，用来获取当前事务的时间戳。

tidb_ddl_disk_quota 从 v6.3.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：107374182400 (100 GiB)
• 范围：[107374182400, 1125899906842624] ([100 GiB, 1 PiB])
• 单位：字节
• 这个变量仅在 tidb_ddl_enable_fast_reorg 开启的情况下生效，用于设置创建索引的回填过程中本地存储空间的使用限制。

tidb_ddl_enable_fast_reorg 从 v6.3.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制是否开启添加索引加速功能，来提升创建索引回填过程的速度。开启该变量对于数据量较大的表有一定的性能提升。
• TiDB v7.1.0 引入了快速加索引功能的检查点机制，即使 TiDB owner 因故障重启或者切换，也能够通过自动定期保存的检查点恢复部分进度。
• 要验证已经完成的 ADD INDEX 操作是否使用了添加索引加速功能，可以执行 ADMIN SHOW DDL JOBS 语句查看 JOB_TYPE 一列中是否含有 ingest 字样。

tidb_enable_dist_task 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：ON
• 这个变量用于控制是否开启 TiDB 分布式执行框架。开启分布式执行框架后，DDL 和 Import 等将会由集群中多个 TiDB 节点共同完成。
• 从 TiDB v7.1.0 开始，支持分布式执行分区表的 ADD INDEX。
• 从 TiDB v7.2.0 开始，支持分布式导入任务 IMPORT INTO。
• 从 TiDB v8.1.0 开始，该变量默认开启。如果要从低版本的集群升级到 v8.1.0 或更高版本，且该集群已开启分布式执行框架，为了避免升级期间 ADD INDEX 操作可能导致数据索引不一致的问题，请在升级前关闭分布式执行框架（即将 tidb_enable_dist_task 设置为 OFF），升级后再手动开启。
• 该变量由 tidb_ddl_distribute_reorg 改名而来。

tidb_cloud_storage_uri 从 v7.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：""
• 该变量用来指定全局排序中使用的 Amazon S3 云存储的 URI。在开启 TiDB 分布式执行框架后，你可以配置 URI 指向具有访问存储所需权限的云存储路径，以此来实现全局排序的功能。更多详情，参考 Amazon S3 的 URI 格式。
• 以下语句支持全局排序功能：
  • ADD INDEX 语句。
  • 用于将数据导入本地部署的 TiDB 的 IMPORT INTO 语句。对于 TiDB Cloud，IMPORT INTO 语句不适用全局排序。

tidb_ddl_error_count_limit

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：512
• 范围：[0, 9223372036854775807]
• 这个变量用来控制 DDL 操作失败重试的次数。失败重试次数超过该参数的值后，会取消出错的 DDL 操作。

tidb_ddl_flashback_concurrency 从 v6.3.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：64
• 范围：[1, 256]
• 这个变量用来控制 FLASHBACK CLUSTER 的并发数。

tidb_ddl_reorg_batch_size

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：整数型

• 默认值：256

• 范围：[32, 10240]

• 单位：行

• 这个变量用来设置 DDL 操作 re-organize 阶段的 batch size。比如 ADD INDEX 操作，需要回填索引数据，通过并发 tidb_ddl_reorg_worker_cnt 个 worker 一起回填数据，每个 worker 以 batch 为单位进行回填。

  • 当设置 tidb_ddl_enable_fast_reorg 为 OFF 时，ADD INDEX 会通过事务的方式执行，执行时如果 ADD INDEX 的目标列有较多 UPDATE 或者 REPLACE 等更新操作，batch size 设置的值越大，事务冲突的概率也会越大。此时建议调小 batch size 的值，最小值是 32。
  • 在没有事务冲突的情况下，或者当 tidb_ddl_enable_fast_reorg 为 ON 时，batch size 可设为较大值，这样回填数据的速度更快，但是 TiKV 的写入压力也会变大。设置 batch size 时需要参考 tidb_ddl_reorg_worker_cnt 的设置值，详情见线上负载与 ADD INDEX 相互影响测试。
  • 从 v8.3.0 版本开始，该参数支持 SESSION 级别的设置，因此修改 GLOBAL 级别的参数值不会影响当前正在运行的 DDL，而只会对新建 SESSION 中提交的 DDL 生效。

tidb_ddl_reorg_priority

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：PRIORITY_LOW
• 可选值：PRIORITY_LOW、PRIORITY_NORMAL、PRIORITY_HIGH
• 这个变量用来设置 ADD INDEX 操作 re-organize 阶段的执行优先级，可设置为 PRIORITY_LOW/PRIORITY_NORMAL/PRIORITY_HIGH。

tidb_ddl_reorg_worker_cnt

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：4
• 范围：[1, 256]
• 单位：线程
• 这个变量用来设置 DDL 操作 re-organize 阶段的并发度。
• 从 v8.3.0 版本开始，该参数支持 SESSION 级别的设置，因此修改 GLOBAL 级别的参数值不会影响当前正在运行的 DDL，而只会对新建 SESSION 中提交的 DDL 生效。

tidb_enable_fast_create_table 从 v8.0.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启 TiDB 加速建表。
• 从 TiDB v8.0.0 开始，支持使用 tidb_enable_fast_create_table 加速建表 CREATE TABLE。
• 该变量是由 v7.6.0 中引入的 tidb_ddl_version 更名而来。从 v8.0.0 开始，tidb_ddl_version 不再生效。

tidb_default_string_match_selectivity 从 v6.2.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：浮点型
• 默认值：0.8
• 范围：[0, 1]
• 这个变量用来设置过滤条件中的 like、rlike、regexp 函数在行数估算时的默认选择率，以及是否对这些函数启用 TopN 辅助估算。
• TiDB 总是会尝试利用统计信息对过滤条件中的 like 进行估算，但是当 like 匹配的字符串太复杂时，或者面对 rlike 或 regexp 时，往往无法充分利用统计信息，转而使用 0.8 作为选择率，造成行数估算的误差较大。
• 该变量可以用于修改这个行为，当变量被设为 0 以外的值时，会使用变量的值而不是默认的 0.8 作为选择率。
• 如果将该变量的值设为 0，TiDB 在对上述三个函数进行行数估算时，会尝试利用统计信息中的 TopN 进行求值来提高估算精度，同时也会考虑统计信息中的 NULL 数。求值操作预计会造成少量性能损耗。这个功能生效的前提是统计信息是在 tidb_analyze_version 设为 2 时收集的。
• 当该变量的值被设为默认值以外的值的时候，会对 not like、not rlike、not regexp 的行数估算也进行相应的调整。

tidb_disable_txn_auto_retry

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：布尔型

• 默认值：ON

• 这个变量用来设置是否禁用显式的乐观事务自动重试，设置为 ON 时，不会自动重试，如果遇到事务冲突需要在应用层重试。

  如果将该变量的值设为 OFF，TiDB 将会自动重试事务，这样在事务提交时遇到的错误更少。需要注意的是，这样可能会导致数据更新丢失。

  这个变量不会影响自动提交的隐式事务和 TiDB 内部执行的事务，它们依旧会根据 tidb_retry_limit 的值来决定最大重试次数。

  关于是否需要禁用自动重试，请参考重试的局限性。

  该变量只适用于乐观事务，不适用于悲观事务。悲观事务的重试次数由 max_retry_count 控制。

tidb_distsql_scan_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：15
• 范围：[1, 256]
• 单位：线程
• 这个变量用来设置 scan 操作的并发度。
• AP 类应用适合较大的值，TP 类应用适合较小的值。对于 AP 类应用，最大值建议不要超过所有 TiKV 节点的 CPU 核数。
• 若表的分区较多可以适当调小该参数（取决于扫描数据量的大小以及扫描频率），避免 TiKV 内存溢出 (OOM)。
• 对于仅包含 LIMIT 子句的简单查询，如果 LIMIT 行数小于 100000，该查询的 scan 操作被下推到 TiKV 时，会将该变量的值视为 1 进行处理，以提升执行效率。
• 对于查询语句 SELECT MAX/MIN(col) FROM ...，如果 col 列有索引且该索引的顺序与 MAX(col) 或 MIN(col) 函数所需的顺序一致，TiDB 会将该查询改写为 SELECT col FROM ... LIMIT 1 进行处理，该变量的值也将视为 1 进行处理。例如，对于 SELECT MIN(col) FROM ...，如果 col 列有升序排列的索引，TiDB 通过将该查询改写为 SELECT col FROM ... LIMIT 1，可以直接读取该索引中第一条数据，从而快速得到 MIN(col) 值。

tidb_dml_batch_size

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 范围：[0, 2147483647]
• 单位：行
• 这个变量的值大于 0 时，TiDB 会将 INSERT 语句在更小的事务中批量提交。这样可减少内存使用，确保大批量修改时事务大小不会达到 txn-total-size-limit 限制。
• 只有变量值为 0 时才符合 ACID 要求。否则无法保证 TiDB 的原子性和隔离性要求。
• 要使该特性生效，还需要开启 tidb_enable_batch_dml，以及至少开启 tidb_batch_insert 和 tidb_batch_delete 中的一个。

tidb_dml_type 从 v8.0.0 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：是
• 类型：字符串
• 默认值："standard"
• 可选值："standard"、"bulk"
• 该变量用来设置 DML 语句的执行方式。
  • "standard" 表示使用标准的 DML 执行方式，TiDB 事务在提交前缓存在内存中。适用于处理高并发且可能存在冲突的事务场景，为默认推荐使用的执行方式。
  • "bulk" 表示使用批量 DML 执行方式，适合于处理因大量数据写入导致 TiDB 内存使用过多的情况。
    • 在 TiDB 事务执行过程中，数据不是完全缓存在 TiDB 内存中，而是持续写入 TiKV，以减少内存的占用，同时平滑写入压力。
    • 只有 INSERT、UPDATE、REPLACE 和 DELETE 语句受 "bulk" 方式的影响。由于 "bulk" 模式流水线执行的方式，其中 INSERT IGNORE ... ON DUPLICATE UPDATE ... 的用法可能会在更新造成冲突时报出 Duplicate entry 的错误；而在 "standard" 模式下，由于设置了 IGNORE 关键字，该错误会被忽略，不会返回给用户。
    • "bulk" 方式仅适用于大批量无冲突数据写入的场景，不能高效处理写入冲突的场景，写写冲突可能会导致大批量事务提交失败并被回滚。
    • "bulk" 方式只对自动提交 (auto-commit) 的语句生效。当设置为 "bulk" 时，pessimistic-auto-commit 配置项的效果等同于设置为 false。
    • 使用 "bulk" 方式执行语句时，需要确保在语句执行过程中保持元数据锁处于开启状态。
    • "bulk" 方式不可以在临时表、缓存表上使用。
    • "bulk" 方式不可以在开启外键约束检查时 (foreign_key_checks = ON) 对包含外键的表和被外键引用的表使用。
    • 当遇到不支持或不兼容的情况时，"bulk" 方式会回退到 "standard" 方式执行，并返回一条警告信息。你可以通过 tidb_last_txn_info 查看 pipelined 字段，如果为 true 则表示是使用 "bulk" 方式执行。
    • 以 "bulk" 方式执行超大事务时，事务耗时可能较长。对于这种模式的事务，其事务锁的最大 TTL 为 max-txn-ttl 与 24 小时中的较大值。此外，当事务执行时间超过 tidb_gc_max_wait_time 设定值后，GC 可能会强制回滚事务，导致事务失败。
    • 以 "bulk" 方式执行事务时，事务的大小不受 TiDB 配置项 txn-total-size-limit 的限制。
    • "bulk" 方式由 Pipelined DML 特性实现，详细设计和 GitHub issue 可见 Pipelined DML 和 #50215。

tidb_enable_1pc 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 指定是否在只涉及一个 Region 的事务上启用一阶段提交特性。比起传统两阶段提交，一阶段提交能大幅降低事务提交延迟并提升吞吐。

tidb_enable_analyze_snapshot 从 v6.2.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 该变量控制 ANALYZE 读取历史时刻的数据还是读取最新的数据。当该变量设置为 ON 时，ANALYZE 读取 ANALYZE 开始时刻的历史数据。当该变量设置为 OFF 时，ANALYZE 读取最新的数据。
• 在 v5.2 之前，ANALYZE 读取最新的数据。v5.2 至 v6.1 版本 ANALYZE 读取 ANALYZE 开始时刻的历史数据。

tidb_enable_async_commit 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 该变量控制是否启用 Async Commit 特性，使事务两阶段提交的第二阶段于后台异步进行。开启本特性能降低事务提交的延迟。

tidb_enable_auto_analyze 从 v6.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 该变量控制 TiDB 是否以后台操作自动更新表的统计信息。
• 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (performance.run-auto-analyze) 进行配置，升级到 v6.1.0 时会自动继承原有设置。

tidb_enable_auto_analyze_priority_queue 从 v8.0.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 该变量控制是否启用优先队列来调度自动收集统计信息的任务。开启该变量后，TiDB 会优先收集那些更有收集价值的表，例如新创建的索引、发生分区变更的分区表等。同时，TiDB 也会优先处理那些健康度较低的表，将它们安排在队列的前端。

tidb_enable_auto_increment_in_generated

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否允许在创建生成列或者表达式索引时引用自增列。

tidb_enable_batch_dml

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 该变量控制是否启用废弃的 batch-dml 特性。启用该变量后，部分语句可能会被拆分为多个事务执行，这是非原子性的，使用时需谨慎。使用 batch-dml 时，必须确保正在操作的数据没有并发操作。要使该变量生效，还需要为 tidb_batch_dml_size 指定一个正值，并启用 tidb_batch_insert 和 tidb_batch_delete 中的至少一个。

tidb_enable_cascades_planner

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启 cascades planner。

tidb_enable_check_constraint 从 v7.2.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否启用 CHECK 约束。

tidb_enable_chunk_rpc 从 v4.0 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来设置是否启用 Coprocessor 的 Chunk 数据编码格式。

tidb_enable_clustered_index 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：ON
• 可选值：OFF，ON，INT_ONLY
• 这个变量用于控制默认情况下表的主键是否使用聚簇索引。“默认情况”即不显式指定 CLUSTERED/NONCLUSTERED 关键字的情况。可设置为 OFF/ON/INT_ONLY。
  • OFF 表示所有主键默认使用非聚簇索引。
  • ON 表示所有主键默认使用聚簇索引。
  • INT_ONLY 此时的行为受配置项 alter-primary-key 控制。如果该配置项取值为 true，则所有主键默认使用非聚簇索引；如果该配置项取值为 false，则由单个整数类型的列构成的主键默认使用聚簇索引，其他类型的主键默认使用非聚簇索引。

tidb_enable_collect_execution_info

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用于控制是否同时将各个执行算子的执行信息记录入 slow query log 中，以及是否维护访问索引有关的统计信息。

tidb_enable_column_tracking 从 v5.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启 TiDB 对 PREDICATE COLUMNS 的收集。关闭该变量后，之前收集的 PREDICATE COLUMNS 会被清除。详情见收集部分列的统计信息。

tidb_enable_ddl 从 v6.3.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 默认值：ON
• 可选值：OFF，ON
• 用于设置该 TiDB 实例是否可以成为 DDL owner。若当前 TiDB 集群中只有一台 TiDB 实例，则不能禁止该实例成为 DDL owner，即不能设置为 OFF。

tidb_enable_enhanced_security

• 作用域：NONE
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量表示所连接的 TiDB 服务器是否启用了安全增强模式 (SEM)。若要改变该变量值，你需要在 TiDB 服务器的配置文件中修改 enable-sem 项的值，并重启 TiDB 服务器。
• 安全增强模式受安全增强式 Linux 等系统设计的启发，削减拥有 MySQL SUPER 权限的用户能力，转而使用细粒度的 RESTRICTED 权限作为替代。这些细粒度的 RESTRICTED 权限如下：
  • RESTRICTED_TABLES_ADMIN：能够写入 mysql 库中的系统表，能查看 information_schema 表上的敏感列。
  • RESTRICTED_STATUS_ADMIN：能够在 SHOW STATUS 命令中查看敏感内容。
  • RESTRICTED_VARIABLES_ADMIN：能够在 SHOW [GLOBAL] VARIABLES 和 SET 命令中查看和设置包含敏感内容的变量。
  • RESTRICTED_USER_ADMIN：能够阻止其他用户更改或删除用户帐户。
  • RESTRICTED_CONNECTION_ADMIN：能够阻止其它用户使用 KILL 语句终止连接。

tidb_enable_exchange_partition

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 该变量用于设置是否启用 exchange partitions with tables 特性。默认值为 ON，即默认开启该功能。
• 该变量自 v6.3.0 开始废弃，其取值将固定为默认值 ON，即默认开启 exchange partitions with tables。

tidb_enable_extended_stats

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 该变量指定 TiDB 是否收集扩展统计信息来指导优化器。

tidb_enable_external_ts_read 从 v6.4.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 当此变量设置为 ON 时，TiDB 会读取 tidb_external_ts 指定时间戳前的历史数据。

tidb_external_ts 从 v6.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 当 tidb_enable_external_ts_read 设置为 ON 时，TiDB 会依据该变量指定的时间戳读取历史数据。

tidb_restricted_read_only 从 v5.2.0 版本开始引入

• 作用域：GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：布尔型

• 默认值：OFF

• 可选值：OFF 和 ON

• tidb_restricted_read_only和 tidb_super_read_only 的作用相似。在大多数情况下，你只需要使用 tidb_super_read_only 即可。

• 拥有 SUPER 或 SYSTEM_VARIABLES_ADMIN 权限的用户可以修改该变量。如果 TiDB 开启了安全增强模式，你还需要额外的 RESTRICTED_VARIABLES_ADMIN 权限才能读取或修改该变量。

• tidb_restricted_read_only 的设置将影响 tidb_super_read_only 的值：

  • 当设置 tidb_restricted_read_only 为 ON 时，tidb_super_read_only 的将自动被设置为 ON。
  • 当设置 tidb_restricted_read_only 为 OFF 时，tidb_super_read_only 的值将不受影响。
  • 当 tidb_restricted_read_only 为 ON 时，tidb_super_read_only 的值无法设置为 OFF。

• 对于 TiDB 的 DBaaS 供应商，当 TiDB 为另一个数据库的下游数据库时，如果要将整个 TiDB 集群设置为只读模式，你需要开启安全增强模式 并将 tidb_restricted_read_only 设置为 ON，从而防止你的用户通过 tidb_super_read_only 将 TiDB 集群设置为可写。实现方法：首先开启安全增强模式，然后由你（作为 DBaaS 的控制面）使用一个 admin 用户控制 tidb_restricted_read_only（需要拥有 SYSTEM_VARIABLES_ADMIN 和 RESTRICTED_VARIABLES_ADMIN 权限），由你的数据库用户使用 root 用户控制 tidb_super_read_only（需要拥有 SUPER 权限）。

• 该变量可以控制整个集群的只读状态。开启后（即该值为 ON），整个集群中的 TiDB 服务器都将进入只读状态，只有 SELECT、USE、SHOW 等不会修改数据的语句才能被执行，其他如 INSERT、UPDATE 等语句会被拒绝执行。

• 该变量开启只读模式只保证整个集群最终进入只读模式，当变量修改状态还没被同步到其他 TiDB 服务器时，尚未同步的 TiDB 仍然停留在非只读模式。

• 在执行 SQL 语句之前，TiDB 会检查集群的只读标志。从 v6.2.0 起，在提交 SQL 语句之前，TiDB 也会检查该标志，从而防止在服务器被置于只读模式后某些长期运行的 auto commit 语句可能修改数据的情况。

• 在变量开启时，对于尚未提交的事务：

  • 如果有尚未提交的只读事务，可正常提交该事务。
  • 如果尚未提交的事务为非只读事务，在事务内执行写入的 SQL 语句会被拒绝。
  • 如果尚未提交的事务已经有数据改动，其提交也会被拒绝。

• 当集群开启只读模式后，所有用户（包括 SUPER 用户）都无法执行可能写入数据的 SQL 语句，除非该用户被显式地授予了 RESTRICTED_REPLICA_WRITER_ADMIN 权限。

tidb_enable_fast_analyze

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来控制是否启用统计信息快速分析功能。默认值 0 表示不开启。
• 快速分析功能开启后，TiDB 会随机采样约 10000 行的数据来构建统计信息。因此在数据分布不均匀或者数据量比较少的情况下，统计信息的准确度会比较低。这可能导致执行计划不优，比如选错索引。如果可以接受普通 ANALYZE 语句的执行时间，则推荐关闭快速分析功能。

tidb_enable_fast_table_check 从 v7.2.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用于控制是否使用基于校验和的方式来快速检查表中数据和索引的一致性。默认值 ON 表示该功能默认开启。
• 开启后，TiDB 执行 ADMIN CHECK [TABLE|INDEX] 语句的速度更快。

tidb_enable_foreign_key 从 v6.3.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：在 v6.6.0 之前版本中为 OFF，在 v6.6.0 及之后的版本中为 ON。
• 这个变量用于控制是否开启 FOREIGN KEY 特性。

tidb_enable_gc_aware_memory_track

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启可感知到垃圾回收的内存追踪 (GC-Aware memory track)。

tidb_enable_global_index 从 v7.6.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 该变量控制是否支持为分区表创建全局索引。启用此变量后，你可以通过在索引定义中添加 GLOBAL 选项创建不包含分区表达式中所有列的唯一索引。
• 从 v8.4.0 开始，该变量被废弃。其值将固定为默认值 ON，即默认启用全局索引。

tidb_enable_lazy_cursor_fetch 从 v8.3.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 可选值：OFF，ON
• 这个变量用于控制 Cursor Fetch 功能的行为。
  • 当开启 Cursor Fetch 且该变量设置为 OFF 时，TiDB 会在语句开始执行时将所有数据读取完成并保存至 TiDB 内存，在后续客户端读取的过程中会依据客户端指定的 FetchSize 返回给客户端。如果结果集过大，可能会触发落盘临时将结果写入硬盘。
  • 当开启 Cursor Fetch 且该变量设置为 ON 时，TiDB 不会一次把所有数据读取到 TiDB 节点，而是会随着客户端的读取不断将数据读到 TiDB 节点。
• 该变量控制的功能存在以下限制：
  • 不支持处于显式事务中的语句。
  • 当前仅支持包含且仅包含 TableReader、IndexReader、IndexLookUp、Projection、Selection 算子的执行计划。
  • 对于使用 Lazy Cursor Fetch 的语句，执行信息将不会出现在 statements summary 和慢查询日志中。
• 对于暂不支持的场景，其行为与将变量设置为 OFF 时一致。

tidb_enable_non_prepared_plan_cache

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 这个变量用来控制是否开启非 Prepare 语句执行计划缓存。
• 开启此功能可能会带来额外的内存和 CPU 开销，并不一定适用于所有场景，请根据具体的使用情况决定是否开启该功能。

tidb_enable_non_prepared_plan_cache_for_dml 从 v7.1.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来控制非 Prepare 语句执行计划缓存是否支持 DML 语句。

tidb_enable_gogc_tuner 从 v6.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 该变量来用控制是否开启 GOGC Tuner。

tidb_enable_historical_stats

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF。在 v8.2.0 之前，默认值为 ON。
• 这个变量用来控制是否开启历史统计信息。默认值为 OFF，表示默认关闭历史统计信息。

tidb_enable_historical_stats_for_capture

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来控制 PLAN REPLAYER CAPTURE 抓取的内容是否默认带历史统计信息。默认值为 OFF，表示默认不带历史统计信息。

tidb_enable_index_merge 从 v4.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：ON
• 这个变量用于控制是否开启 index merge 功能。

tidb_enable_index_merge_join

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 表示是否启用 IndexMergeJoin 算子。
• 该变量为 TiDB 内部变量，不推荐使用，否则可能会造成数据正确性问题。

tidb_enable_legacy_instance_scope 从 v6.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用于允许使用 SET SESSION 对 INSTANCE 作用域的变量进行设置，用法同 SET GLOBAL。
• 为了兼容之前的 TiDB 版本，该变量值默认为 ON。

tidb_enable_list_partition 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来设置是否开启 LIST (COLUMNS) TABLE PARTITION 特性。
• 从 v8.4.0 开始，该变量被废弃。其值将固定为默认值 ON，即默认启用 List 分区。

tidb_enable_local_txn

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 该变量用于一个未发布的特性，请勿修改该变量值。

tidb_enable_metadata_lock 从 v6.3.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来设置是否开启元数据锁特性。需要注意，在设置该变量时，集群中不能有 DDL 任务，以免造成非预期数据正确性、一致性问题。

tidb_enable_mutation_checker 从 v6.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用于设置是否开启 mutation checker。mutation checker 是一项在 DML 语句执行过程中进行的数据索引一致性校验，校验报错会回滚当前语句。开启该校验会导致 CPU 使用轻微上升。详见数据索引一致性报错。
• 对于新创建的 v6.0.0 及以上的集群，默认值为 ON。对于升级版本的集群，如果升级前是低于 v6.0.0 的版本，升级后默认值为 OFF。

tidb_enable_new_cost_interface 从 v6.2.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• TiDB v6.2.0 对代价模型的实现进行了代码层面的重构，这个变量用来控制是否使用重构后的代价模型 Cost Model Version 2。
• 重构后的代价模型使用完全一样的代价公式，因此不会引起计划选择的变动，此开关默认打开。
• 从 v6.1 升级至 v6.2 的用户，此开关保持升级前的 OFF 状态，此时建议直接打开；对于从 v6.1 之前版本升级至 v6.2 的用户，此开关默认为 ON。

tidb_enable_new_only_full_group_by_check 从 v6.1.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 该变量用于控制 TiDB 执行 ONLY_FULL_GROUP_BY 检查时的行为。有关 ONLY_FULL_GROUP_BY 的信息可以参考 MySQL 文档。在 v6.1 中 TiDB 对该项检查做了更严格正确的处理。
• 由于可能存在版本升级造成的兼容性问题，在 v6.1 中该变量默认值是 OFF，即默认关闭。

tidb_enable_noop_functions 从 v4.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：OFF
• 可选值：ON、OFF、WARN
• 默认情况下，用户尝试将某些语法用于尚未实现的功能时，TiDB 会报错。若将该变量值设为 ON，TiDB 则自动忽略此类功能不可用的情况，即不会报错。若用户无法更改 SQL 代码，可考虑将变量值设为 ON。
• 启用 noop 函数可以控制以下行为：
  • LOCK IN SHARE MODE 语法
  • SQL_CALC_FOUND_ROWS 语法
  • START TRANSACTION READ ONLY 和 SET TRANSACTION READ ONLY 语法
  • tx_read_only、transaction_read_only、offline_mode、super_read_only、read_only 以及 sql_auto_is_null 系统变量
  • GROUP BY <expr> ASC|DESC 语法

tidb_enable_noop_variables 从 v6.2.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 若该变量值为 OFF，TiDB 具有以下行为：
  • 使用 SET 设置 noop 的系统变量时会报 "setting *variable_name* has no effect in TiDB" 的警告。
  • SHOW [SESSION | GLOBAL] VARIABLES 的结果不显示 noop 的系统变量。
  • 使用 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 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：在 v7.0.0 之前版本中为 OFF，即默认关闭。在 v7.0.0 及之后的版本中为 ON，即默认开启。
• 这个变量用于控制 TiDB 对特殊集合算子 NOT IN 和 != ALL 引导的子查询产生的 ANTI JOIN 是否采用 Null Aware Hash Join 的执行方式。
• 从旧版本升级到 v7.0.0 及之后版本，该功能自动开启，即该变量的值修改为默认值 ON。

tidb_enable_outer_join_reorder 从 v6.1.0 版本开始引入

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：是

• 类型：布尔型

• 默认值：ON

• 自 v6.1.0 起，TiDB 的 Join Reorder 算法开始支持 Outer Join。该变量用于控制是否启用 Outer Join 的 Join Reorder。

• 对于从较低版本升级到当前版本的 TiDB：

  • 如果升级前 TiDB 的版本低于 v6.1.0，升级后该变量的默认值为 ON。
  • 如果升级前 TiDB 的版本等于或大于 v6.1.0，升级后该变量的默认值跟随升级前的设定值。

tidb_enable_inl_join_inner_multi_pattern 从 v7.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：ON。TiDB v8.3.0 及之前版本默认值为 OFF。
• 该变量用于控制当内表上有 Selection、Projection 或 Aggregation 算子时是否支持 Index Join。OFF 表示不支持。
• 如果将集群从 v7.0.0 之前版本升级至 v8.4.0 或之后的版本，该变量默认值为 OFF，即默认不支持 Index Join。

tidb_enable_instance_plan_cache 从 v8.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启 Instance Plan Cache 功能。该功能实现实例级执行计划缓存，允许同一个 TiDB 实例的所有会话共享执行计划缓存，从而提升内存利用率。开启该功能之前，建议关闭会话级别的 Prepare 语句执行计划缓存和非 Prepare 语句执行计划缓存。

tidb_enable_ordered_result_mode

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 指定是否对最终的输出结果进行自动排序。
• 例如，开启该变量后，TiDB 会将 SELECT a, MAX(b) FROM t GROUP BY a 处理为 SELECT a, MAX(b) FROM t GROUP BY a ORDER BY a, MAX(b)。

tidb_enable_paging 从 v5.4.0 版本开始引入

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：是

• 类型：布尔型

• 默认值：ON

• 这个变量用于控制是否使用分页 (paging) 方式发送 Coprocessor 请求。对于 [v5.4.0, v6.2.0) 区间的 TiDB 版本，该变量只对 IndexLookup 算子生效；对于 v6.2.0 以及之后的版本，该变量对全局生效。从 v6.4.0 版本开始，该变量默认值由 OFF 改成 ON。

• 适用场景：

  • 推荐在所有偏 OLTP 的场景下使用 paging。
  • 对于使用 IndexLookUp 和 Limit 并且 Limit 无法下推到 IndexScan 上的读请求，可能会出现读请求的延迟高、TiKV 的 Unified read pool CPU 使用率高的情况。在这种情况下，由于 Limit 算子只需要少部分数据，开启 tidb_enable_paging 能够减少处理数据的数量，从而降低延迟、减少资源消耗。
  • 对于 Dumpling 数据导出或者全表扫描这类的场景，开启 paging 后可以有效降低 TiDB 进程的内存消耗。

tidb_enable_parallel_apply 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启 Apply 算子并发，并发数由 tidb_executor_concurrency 变量控制。Apply 算子用来处理关联子查询且默认无并发，所以执行速度较慢。打开 Apply 并发开关可增加并发度，提高执行速度。目前默认关闭。

tidb_enable_parallel_hashagg_spill 从 v8.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制 TiDB 是否支持并行 HashAgg 进行落盘。当该变量设置为 ON 时，在任意并发条件下，HashAgg 算子都可以根据内存使用情况自动触发数据落盘，从而兼顾性能和数据处理量。因此，不推荐将此变量修改为 OFF。从 v8.2.0 开始，将该变量设置为 OFF 时会产生警告。该变量将在未来版本中废弃。

tidb_enable_pipelined_window_function

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 该变量指定是否对窗口函数采用流水线的执行算法。

tidb_enable_plan_cache_for_param_limit 从 v6.6.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制 Prepared Plan Cache 是否缓存 LIMIT 后面带变量 (LIMIT ?) 的执行计划。目前不支持缓存 LIMIT 后面带变量且变量值大于 10000 的执行计划。

tidb_enable_plan_cache_for_subquery 从 v7.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制 Prepared Plan Cache 是否缓存包含子查询的查询。

tidb_enable_plan_replayer_capture

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制是否开启 PLAN REPLAYER CAPTURE 功能。默认值 ON 代表开启 PLAN REPLAYER CAPTURE 功能。

tidb_enable_plan_replayer_continuous_capture 从 v7.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来控制是否开启 PLAN REPLAYER CONTINUOUS CAPTURE 功能。默认值 OFF 代表关闭功能。

tidb_enable_prepared_plan_cache 从 v6.1.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制是否开启 Prepared Plan Cache。开启后，对 Prepare、Execute 请求的执行计划会进行缓存，以便在后续执行时跳过查询计划优化这个步骤，获得性能上的提升。
• 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (prepared-plan-cache.enabled) 进行配置，升级到 v6.1.0 时会自动继承原有设置。

tidb_enable_prepared_plan_cache_memory_monitor 从 v6.4.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制是否统计 Prepared Plan Cache 中所缓存的执行计划占用的内存。具体可见 Prepared Plan Cache 的内存管理。

tidb_enable_pseudo_for_outdated_stats 从 v5.3.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 这个变量用来控制优化器在一张表上的统计信息过期时的行为。
• 统计信息过期的判断标准：最近一次对某张表执行 ANALYZE 获得统计信息后，该表数据被修改的行数大于该表总行数的 80%，便可判定该表的统计信息已过期。该比例可通过 pseudo-estimate-ratio 配置参数调整。
• 默认情况下（即该变量值为 OFF 时），某张表上的统计信息过期后，优化器仍会使用该表上的统计信息。将该变量值设为 ON 时，当统计信息过期后，优化器认为该表上除总行数以外的统计信息不再可靠，转而使用 pseudo 统计信息。
• 如果表数据修改较频繁，没有及时对表执行 ANALYZE，但又希望执行计划保持稳定，推荐将该变量值设为 OFF。

tidb_enable_rate_limit_action

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量控制是否为读数据的算子开启动态内存控制功能。读数据的算子默认启用 tidb_distsql_scan_concurrency 所允许的最大线程数来读取数据。当单条 SQL 语句的内存使用每超过 tidb_mem_quota_query 一次，读数据的算子会停止一个线程。
• 当读数据的算子只剩 1 个线程且当单条 SQL 语句的内存使用继续超过 tidb_mem_quota_query 时，该 SQL 语句会触发其它的内存控制行为，例如落盘。
• 该变量在单条查询仅涉及读数据的情况下，对内存控制效果较好。若还存在额外的计算操作（如连接、聚合等），打开该变量可能会导致内存不受 tidb_mem_quota_query 控制，加剧 OOM 风险。

tidb_enable_resource_control 从 v6.6.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：ON
• 类型：布尔型
• 该变量是资源管控特性的开关。该变量设置为 ON 时，集群支持应用按照资源组做资源隔离。

tidb_enable_reuse_chunk 从 v6.4.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 可选值：OFF，ON
• 该变量用于控制 TiDB 是否启用 Chunk 对象缓存。如果为 ON，则优先使用缓存中的 Chunk 对象，缓存中找不到申请的对象时才会从系统内存中申请。如果为 OFF，则直接从系统内存中申请 Chunk 对象。

tidb_enable_shared_lock_promotion 从 v8.3.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 该变量用于控制是否启用共享锁升级为排他锁的功能。TiDB 默认不支持 SELECT LOCK IN SHARE MODE，当该变量值为 ON 时，TiDB 会尝试将 SELECT LOCK IN SHARE MODE 语句升级为 SELECT FOR UPDATE 并真正加悲观锁。该变量默认值为 OFF，表示不启用共享锁升级为排他锁的功能。
• 无论 tidb_enable_noop_functions 是否开启，启用该变量都会对 SELECT LOCK IN SHARE MODE 语句生效。

tidb_enable_slow_log

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用于控制是否开启 slow log 功能。

tidb_enable_stats_owner 从 v8.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 默认值：ON
• 可选值：OFF、ON
• 用于设置该 TiDB 实例是否可以运行统计信息自动更新任务。若当前 TiDB 集群中只有一台 TiDB 实例，则不能禁止该实例运行统计信息自动更新，即不能设置为 OFF。

tidb_enable_stmt_summary 从 v3.0.4 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制是否开启 statement summary 功能。如果开启，SQL 的耗时等执行信息将被记录到系统表 information_schema.STATEMENTS_SUMMARY 中，用于定位和排查 SQL 性能问题。

tidb_enable_strict_double_type_check 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制是否可以用 DOUBLE 类型的无效定义创建表。该设置的目的是提供一个从 TiDB 早期版本升级的方法，因为早期版本在验证类型方面不太严格。
• 该变量的默认值 ON 与 MySQL 兼容。

例如，由于无法保证浮点类型的精度，现在将 DOUBLE(10) 类型视为无效。将 tidb_enable_strict_double_type_check 更改为 OFF 后，将会创建表。如下所示：

CREATE TABLE t1 (id int, c double(10));
ERROR 1149 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use
SET tidb_enable_strict_double_type_check = 'OFF';
Query OK, 0 rows affected (0.00 sec)
CREATE TABLE t1 (id int, c double(10));
Query OK, 0 rows affected (0.09 sec)

tidb_enable_table_partition

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：ON
• 类型：枚举型
• 从 v8.4.0 开始，该变量被废弃。其值将固定为默认值 ON，即默认启用分区表。

tidb_enable_telemetry 从 v4.0.2 版本开始引入，从 v8.1.0 版本开始废弃

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 在 v8.1.0 之前，这个变量用于动态地控制 TiDB 遥测功能是否开启。

tidb_enable_tiflash_read_for_write_stmt 从 v6.3.0 版本开始引入

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：布尔型

• 默认值：ON

• 这个变量用于控制包含增删改的 SQL 语句中的读取操作能否下推到 TiFlash，比如：

  • INSERT INTO SELECT 语句中的 SELECT 查询（典型应用场景为 TiFlash 查询结果物化）
  • UPDATE 和 DELETE 语句中的 WHERE 条件过滤

• 从 v7.1.0 开始，该变量废弃。当 tidb_allow_mpp = ON 时，优化器将根据 SQL 模式及 TiFlash 副本的代价估算自行决定是否将查询下推至 TiFlash。需要注意的是，只有当前会话的 SQL 模式为非严格模式（即 sql_mode 值不包含 STRICT_TRANS_TABLES 和 STRICT_ALL_TABLES）时，TiDB 才允许将包含增删改的 SQL 语句（如 INSERT INTO SELECT）中的读取操作下推至 TiFlash。

tidb_enable_tmp_storage_on_oom

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 设置是否在单条 SQL 语句的内存使用超出系统变量 tidb_mem_quota_query 限制时为某些算子启用临时磁盘。
• 在 v6.3.0 之前这个开关可通过 TiDB 配置文件中的 oom-use-tmp-storage 项进行配置。在升级到 v6.3.0 及更新的版本后，集群会自动使用原 oom-use-tmp-storage 的值来初始化该开关，配置文件中 oom-use-tmp-storage 的新设置不再影响该开关。

tidb_enable_top_sql 从 v5.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启 Top SQL 特性。

tidb_enable_tso_follower_proxy 从 v5.3.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启 TSO Follower Proxy 特性。当该值为 OFF 时，TiDB 仅会从 PD leader 获取 TSO。当该值为 ON 时，TiDB 在获取 TSO 时会将请求均匀地发送到所有 PD 节点上，因此 PD follower 也可以处理 TSO 请求，从而减轻 PD leader 的 CPU 压力。
• 适合开启 TSO Follower Proxy 的场景：
  • PD leader 因高压力的 TSO 请求而达到 CPU 瓶颈，导致 TSO RPC 请求的延迟较高。
  • 集群中的 TiDB 实例数量较多，且调高 tidb_tso_client_batch_max_wait_time 并不能缓解 TSO RPC 请求延迟高的问题。

tidb_enable_unsafe_substitute 从 v6.3.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否对生成列中表达式替换使用不安全的替换方式。默认值为 OFF，即默认关闭不安全的替换方式。详情见生成列。

tidb_enable_vectorized_expression 从 v4.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：ON
• 这个变量用于控制是否开启向量化执行。

tidb_enable_window_function

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制是否开启窗口函数的支持。
• 由于窗口函数会使用一些保留关键字，可能导致原先可以正常执行的 SQL 语句在升级 TiDB 后无法被解析语法，此时可以将 tidb_enable_window_function 设置为 OFF。

tidb_enable_row_level_checksum 从 v7.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用于控制是否开启 TiCDC 单行数据正确性校验功能。
• 你可以使用 TIDB_ROW_CHECKSUM() 函数查询行数据的 Checksum 值。

tidb_enforce_mpp 从 v5.1 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF（表示关闭）。如需修改此变量的默认值，请配置 performance.enforce-mpp 参数。
• 这个变量用于控制是否忽略优化器代价估算，强制使用 TiFlash 的 MPP 模式执行查询，可以设置的值包括：
  • 0 或 OFF，代表不强制使用 MPP 模式（默认）
  • 1 或 ON，代表将忽略代价估算，强制使用 MPP 模式。注意：只有当 tidb_allow_mpp=true 时该设置才生效。

MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数据交换并提供高性能、高吞吐的 SQL 算法。MPP 模式选择的详细说明参见控制是否选择 MPP 模式。

tidb_evolve_plan_baselines 从 v4.0 版本开始引入

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：布尔型

• 默认值：OFF

• 这个变量用于控制是否启用自动演进绑定功能。该功能的详细介绍和使用方法可以参考自动演进绑定。

• 为了减少自动演进对集群的影响，可以进行以下配置：

  • 设置 tidb_evolve_plan_task_max_time，限制每个执行计划运行的最长时间，其默认值为 600s；
  • 设置tidb_evolve_plan_task_start_time 和 tidb_evolve_plan_task_end_time，限制运行演进任务的时间窗口，默认值分别为 00:00 +0000 和 23:59 +0000。

tidb_evolve_plan_task_end_time 从 v4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：时间
• 默认值：23:59 +0000
• 这个变量用来设置一天中允许自动演进的结束时间。

tidb_evolve_plan_task_max_time 从 v4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：600
• 范围：[-1, 9223372036854775807]
• 单位：秒
• 该变量用于限制自动演进功能中，每个执行计划运行的最长时间。

tidb_evolve_plan_task_start_time 从 v4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：时间
• 默认值：00:00 +0000
• 这个变量用来设置一天中允许自动演进的开始时间。

tidb_executor_concurrency 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：5
• 范围：[1, 256]
• 单位：线程

该变量用来统一设置各个 SQL 算子的并发度，包括：

• index lookup
• index lookup join
• hash join
• hash aggregation（partial 和 final 阶段）
• window
• projection
• sort

tidb_executor_concurrency 整合了已有的系统变量，方便管理。这些变量所列如下：

• tidb_index_lookup_concurrency
• tidb_index_lookup_join_concurrency
• tidb_hash_join_concurrency
• tidb_hashagg_partial_concurrency
• tidb_hashagg_final_concurrency
• tidb_projection_concurrency
• tidb_window_concurrency

v5.0 后，用户仍可以单独修改以上系统变量（会有废弃警告），且修改只影响单个算子。后续通过 tidb_executor_concurrency 的修改也不会影响该算子。若要通过 tidb_executor_concurrency 来管理所有算子的并发度，需要将以上所列变量的值设置为 -1。

对于从 v5.0 之前的版本升级到 v5.0 的系统，如果用户对上述所列变量的值没有做过改动（即 tidb_hash_join_concurrency 值为 5，其他值为 4），则会自动转为使用 tidb_executor_concurrency 来统一管理算子并发度。如果用户对上述变量的值做过改动，则沿用之前的变量对相应的算子做并发控制。

tidb_expensive_query_time_threshold

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：60
• 范围：[10, 2147483647]
• 单位：秒
• 这个变量用来控制打印 expensive query 日志的阈值时间，默认值是 60 秒。expensive query 日志和慢日志的差别是，慢日志是在语句执行完后才打印，expensive query 日志可以把正在执行中的语句且执行时间超过阈值的语句及其相关信息打印出来。

tidb_expensive_txn_time_threshold 从 v7.2.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：600
• 范围：[60, 2147483647]
• 单位：秒
• 这个变量用来控制打印 expensive transaction 日志的阈值时间，默认值是 600 秒。expensive transaction 日志会将尚未 COMMIT 或 ROLLBACK 且持续时间超过该阈值的事务的相关信息打印出来。

tidb_force_priority

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：NO_PRIORITY
• 可选值：NO_PRIORITY、LOW_PRIORITY、DELAYED、HIGH_PRIORITY
• 这个变量用于改变 TiDB server 上执行的语句的默认优先级。例如，你可以通过设置该变量来确保正在执行 OLAP 查询的用户优先级低于正在执行 OLTP 查询的用户。
• 默认值 NO_PRIORITY 表示不强制改变执行语句的优先级。

tidb_gc_concurrency 从 v5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：-1
• 范围：-1 或 [1, 256]
• 单位：线程
• 该变量用于控制垃圾回收 (GC) 过程中 Resolve Locks（清理锁）的并发线程数。
• 从 v8.3.0 开始，该变量也用于控制 GC 过程中 Delete Range（删除区间）的并发线程数。
• 默认情况下，该变量值为 -1，TiDB 将根据负载情况自动决定适当的线程数。
• 当设置为 [1, 256] 之间的数时：
  • Resolve Locks（清理锁）直接使用该变量设定值作为线程数。
  • Delete Range（删除区间）使用该变量设定值的 1/4 作为线程数。

tidb_gc_enable 从 v5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用于控制是否启用 TiKV 的垃圾回收 (GC) 机制。如果不启用 GC 机制，系统将不再清理旧版本的数据，因此会有损系统性能。

tidb_gc_life_time 从 v5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：Duration
• 默认值：10m0s
• 范围：[10m0s, 8760h0m0s]
• 这个变量用于指定每次进行垃圾回收 (GC) 时保留数据的时限。变量值为 Go 的 Duration 字符串格式。每次进行 GC 时，将以当前时间减去该变量的值作为 safe point。

tidb_gc_max_wait_time 从 v6.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：86400
• 范围：[600, 31536000]
• 单位：秒
• 这个变量用于指定活跃事务阻碍 GC safe point 推进的最大时间。每次进行 GC 时，默认 GC safe point 不会超过正在执行中的事务的开始时间。如果活跃事务运行时间未超过该值，GC safe point 会一直被阻塞不更新，直到活跃事务运行时间超过该值 safe point 才会正常推进。

tidb_gc_run_interval 从 v5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：Duration
• 默认值：10m0s
• 范围：[10m0s, 8760h0m0s]
• 这个变量用于指定垃圾回收 (GC) 运行的时间间隔。变量值为 Go 的 Duration 字符串格式，如"1h30m"、"15m"等。

tidb_gc_scan_lock_mode 从 v5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：LEGACY
• 可设置为：PHYSICAL，LEGACY
  • LEGACY：使用旧的扫描方式，即禁用 Green GC。
  • PHYSICAL：使用物理扫描方式，即启用 Green GC。
• 这个变量用于指定垃圾回收 (GC) 的 Resolve Locks（清理锁）步骤中扫描锁的方式。当变量值设置为 LEGACY 时，TiDB 以 Region 为单位进行扫描。当变量值设置为 PHYSICAL 时，每个 TiKV 节点分别绕过 Raft 层直接扫描数据，可以有效地缓解在启用 Hibernate Region 功能时，GC 唤醒全部 Region 的影响，从而提升 Resolve Locks（清理锁）这个步骤的执行速度。

tidb_general_log

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来设置是否在日志里记录所有的 SQL 语句。该功能默认关闭。如果系统运维人员在定位问题过程中需要追踪所有 SQL 记录，可考虑开启该功能。
• 在 TiDB 配置项 log.level 为 "info" 或 "debug" 时，通过查询 "GENERAL_LOG" 字符串可以定位到该功能在日志中的所有记录。日志会记录以下内容：
  • conn：当前会话对应的 ID
  • user：当前会话用户
  • schemaVersion：当前 schema 版本
  • txnStartTS：当前事务的开始时间戳
  • forUpdateTS：事务模式为悲观事务时，SQL 语句的当前时间戳。悲观事务内发生写冲突时，会重试当前执行语句，该时间戳会被更新。重试次数由 max-retry-count 配置。事务模式为乐观事务时，该条目与 txnStartTS 等价。
  • isReadConsistency：当前事务隔离级别是否是读已提交 (RC)
  • current_db：当前数据库名
  • txn_mode：事务模式。可选值：OPTIMISTIC（乐观事务模式），或 PESSIMISTIC（悲观事务模式）
  • sql：当前查询对应的 SQL 语句

tidb_non_prepared_plan_cache_size

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：100
• 范围：[1, 100000]
• 这个变量用来控制非 Prepare 语句执行计划缓存最多能够缓存的计划数量。

tidb_generate_binary_plan 从 v6.2.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 这个变量用于指定是否在 slow log 和 statement summary 里包含以二进制格式编码的执行计划。
• 开启该变量后，即可在 TiDB Dashboard 中查看查询的图形化执行计划。注意，TiDB Dashboard 只显示变量开启时产生的查询的执行计划。
• 用 SELECT tidb_decode_binary_plan('xxx...') SQL 语句可以从编码后的执行计划解析出具体的执行计划。

tidb_gogc_tuner_max_value 从 v7.5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：500
• 范围：[10, 2147483647]
• 该变量用来控制 GOGC Tuner 可调节 GOGC 的最大值。

tidb_gogc_tuner_min_value 从 v7.5.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：100
• 范围：[10, 2147483647]
• 该变量用来控制 GOGC Tuner 可调节 GOGC 的最小值。

tidb_gogc_tuner_threshold 从 v6.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：0.6
• 范围：[0, 0.9)
• 这个变量用来控制 GOGC Tuner 自动调节的最大内存阈值，超过阈值后 GOGC Tuner 会停止工作。

tidb_guarantee_linearizability 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 此变量控制异步提交 (Async Commit) 中提交时间戳的计算方式。默认情况下（使用 ON 值），两阶段提交从 PD 服务器请求一个新的时间戳，并使用该时间戳计算最终提交的时间戳，这样可保证所有并发事务可线性化。
• 如果将该变量值设为 OFF，从 PD 获取时间戳的操作会被省掉，这种情况下只保证因果一致性但不保证线性一致性。详情请参考 PingCAP 博文 Async Commit 原理介绍。
• 对于需要只保证因果一致性的场景，可将此变量设为 OFF 以提升性能。

tidb_hash_exchange_with_new_collation

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 该值表示是否在开启 new collation 的集群里生成 MPP hash partition exchange 算子。true 表示生成此算子，false表示不生成。
• 该变量为 TiDB 内部变量，不推荐设置该变量。

tidb_hash_join_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：-1
• 范围：[1, 256]
• 单位：线程
• 这个变量用来设置 hash join 算法的并发度。
• 默认值 -1 表示使用 tidb_executor_concurrency 的值。

tidb_hash_join_version 从 v8.4.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：枚举型
• 默认值：legacy
• 可选值：legacy、optimized
• 控制 TiDB 是否使用 Hash Join 算子的优化版。默认值为 legacy，代表不使用优化版。若设置为 optimized，TiDB 在执行 Hash Join 算子时将使用其优化版，以提升 Hash Join 性能。

tidb_hashagg_final_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：-1
• 范围：[1, 256]
• 单位：线程
• 这个变量用来设置并行 hash aggregation 算法 final 阶段的执行并发度。对于聚合函数参数不为 distinct 的情况，HashAgg 分为 partial 和 final 阶段分别并行执行。
• 默认值 -1 表示使用 tidb_executor_concurrency 的值。

tidb_hashagg_partial_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：-1
• 范围：[1, 256]
• 单位：线程
• 这个变量用来设置并行 hash aggregation 算法 partial 阶段的执行并发度。对于聚合函数参数不为 distinct 的情况，HashAgg 分为 partial 和 final 阶段分别并行执行。
• 默认值 -1 表示使用 tidb_executor_concurrency 的值。

tidb_historical_stats_duration 从 v6.6.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：Duration
• 默认值：168h，即 7 天
• 这个变量用来控制历史统计信息在存储中的保留时间。

tidb_idle_transaction_timeout 从 v7.6.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 范围：[0, 31536000]
• 单位：秒
• 这个变量用来控制用户会话中事务的空闲超时。当用户会话处于事务状态且空闲时间超过该变量设定的值时，会话会被 Kill 掉。用户会话空闲是指没有正在执行的请求，处于等待请求的状态。
• 默认值 0 表示没有时间限制。

tidb_ignore_prepared_cache_close_stmt 从 v6.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来设置是否忽略关闭 Prepared Statement 的指令。
• 如果变量值设为 ON，Binary 协议的 COM_STMT_CLOSE 信号和文本协议的 DEALLOCATE PREPARE 语句都会被忽略。

tidb_index_join_batch_size

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：25000
• 范围：[1, 2147483647]
• 单位：行
• 这个变量用来设置 index lookup join 操作的 batch 大小，AP 类应用适合较大的值，TP 类应用适合较小的值。

tidb_index_join_double_read_penalty_cost_rate 从 v6.6.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：浮点数
• 默认值：0
• 范围：[0, 18446744073709551615]
• 这个变量用来设置是否给选择 index join 增加一些惩罚性的代价，以降低优化器选择 index join 操作的倾向，从而增加选择其他 join 方式的倾向，例如如选择 hash join 和 tiflash join 等。
• 优化器选择 index join 可能触发较多的回表请求，造成较多的资源开销，此时可以通过设置这个变量，来减少优化器选择 index join 的倾向。
• 这个变量只有在 tidb_cost_model_version 设置为 2 时生效。

tidb_index_lookup_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：-1
• 范围：[1, 256]
• 单位：线程
• 这个变量用来设置 index lookup 操作的并发度，AP 类应用适合较大的值，TP 类应用适合较小的值。
• 默认值 -1 表示使用 tidb_executor_concurrency 的值。

tidb_index_lookup_join_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：-1
• 范围：[1, 256]
• 单位：线程
• 这个变量用来设置 index lookup join 算法的并发度。
• 默认值 -1 表示使用 tidb_executor_concurrency 的值。

tidb_index_merge_intersection_concurrency 从 v6.5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 默认值：-1
• 范围：[1, 256]
• 这个变量用来设置索引合并进行交集操作时的最大并发度，仅在以动态裁剪模式访问分区表时有效。实际并发度为 tidb_index_merge_intersection_concurrency 与分区表分区数目两者中较小的值。
• 默认值 -1 表示使用 tidb_executor_concurrency 的值。

tidb_index_lookup_size

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：20000
• 范围：[1, 2147483647]
• 单位：行
• 这个变量用来设置 index lookup 操作的 batch 大小，AP 类应用适合较大的值，TP 类应用适合较小的值。

tidb_index_serial_scan_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：1
• 范围：[1, 256]
• 单位：线程
• 这个变量用来设置顺序 scan 操作的并发度，AP 类应用适合较大的值，TP 类应用适合较小的值。

tidb_init_chunk_size

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：32
• 范围：[1, 32]
• 单位：行
• 这个变量用来设置执行过程中初始 chunk 的行数。默认值是 32，可设置的范围是 1～32。chunk 行数直接影响单个查询所需的内存。可以按照查询中所有的列的总宽度和 chunk 行数来粗略估算单个 chunk 所需内存，并结合执行器的并发数来粗略估算单个查询所需内存总量。建议单个 chunk 内存总量不要超过 16 MiB。

tidb_instance_plan_cache_reserved_percentage 从 v8.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：浮点型
• 默认值：0.1
• 范围：[0, 1]
• 这个变量用于控制内存驱逐后 Instance Plan Cache 的空闲内存百分比。当 Instance Plan Cache 使用的内存达到 tidb_instance_plan_cache_max_size 设置的上限时，TiDB 会按照 Least Recently Used (LRU) 算法开始驱逐内存中的执行计划，直到空闲内存比例超过 tidb_instance_plan_cache_reserved_percentage 设定的值。

tidb_instance_plan_cache_max_size 从 v8.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：125829120（即 120 MiB）
• 单位：字节
• 这个变量用于设置 Instance Plan Cache 的最大内存使用量。

tidb_isolation_read_engines 从 v4.0 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：是
• 默认值：tikv,tiflash,tidb
• 这个变量用于设置 TiDB 在读取数据时可以使用的存储引擎列表。

tidb_last_ddl_info 从 v6.0.0 版本开始引入

• 作用域：SESSION
• 默认值：""
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 该变量为只读变量，TiDB 内部使用该变量获取当前会话中上一个 DDL 操作的信息。
  • "query"：上一个 DDL 查询字符串。
  • "seq_num"：每个 DDL 操作的序列号，用于标识 DDL 操作的顺序。

tidb_last_query_info 从 v4.0.14 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 默认值：""
• 这是一个只读变量。用于在 TiDB 内部查询上一条 DML 语句的事务信息。查询的事务信息包括：
  • txn_scope：事务的作用域，可能为 global 或 local。
  • start_ts：事务开始的时间戳。
  • for_update_ts：先前执行的 DML 语句的 for_update_ts 信息。这是 TiDB 用于测试的内部术语。通常，你可以忽略此信息。
  • error：错误消息（如果有）。
  • ru_consumption：执行语句的 RU 消耗。

tidb_last_txn_info 从 v4.0.9 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 此变量用于获取当前会话中最后一个事务的信息。这是一个只读变量。事务信息包括：
  • 事务的范围
  • 开始时间戳和提交时间戳
  • 事务的提交模式，可能是两阶段提交，一阶段提交，或者异步提交
  • 事务从异步提交或一阶段提交到两阶段提交的回退信息
  • 遇到的错误

tidb_last_plan_replayer_token 从 v6.3.0 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：字符串
• 这个变量是一个只读变量，用于获取当前会话中最后一个 PLAN REPLAYER dump 的结果。

tidb_load_based_replica_read_threshold 从 v7.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值："1s"
• 范围：[0s, 1h]
• 类型：字符串
• 这个变量用来设置基于负载的 replica read 的触发阈值。当 leader 节点的预估排队时间超过阈值时，TiDB 会优先从 follower 节点读取数据。格式为时间，例如 "100ms" 或 "1s"。详情见 TiDB 热点问题处理。

tidb_load_binding_timeout 从 v8.0.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：200
• 范围：(0, 2147483647]
• 单位：毫秒
• 这个变量用来控制加载 binding 的超时时间。当加载 binding 的执行时间超过该值时，会停止加载。

tidb_lock_unchanged_keys 从 v7.1.1 和 v7.3.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 该变量控制在以下场景是否对某些 key 加锁。设置为 ON 时，都加锁，设置为 OFF 时，都不加锁。
  • 在 INSERT IGNORE 语句和 REPLACE 语句中值重复的 key。在 v6.1.6 之前版本中，这些 key 不加锁。这个问题已在 #42121 修复。
  • 在 UPDATE 语句中值没有改变的唯一索引 key。在 v6.5.2 之前版本中，这些 key 不加锁。这个问题已在 #36438 修复。
• 为保证事务行为的一致性和合理性，不推荐修改该值。如果在升级 TiDB 后因为这两项修复导致严重的性能问题，且可以接受不加锁的行为（见上述 Issue），可以将该变量设置为 OFF。

tidb_log_file_max_days 从 v5.3.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 范围：[0, 2147483647]
• 这个变量可以调整当前 TiDB 实例上日志的最大保留天数。默认值是实例配置文件中指定的值，见配置项 max-days。此变量只影响当前 TiDB 实例上的配置，重启后丢失，且配置文件不受影响。

tidb_low_resolution_tso

• 作用域：SESSION | GLOBAL
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来设置是否启用低精度 TSO 特性。开启该功能之后，TiDB 使用缓存 Timestamp 来读取数据。缓存 Timestamp 默认每 2 秒更新一次。从 v8.0.0 开始，你可以通过 tidb_low_resolution_tso_update_interval 配置缓存 Timestamp 的更新时间间隔。
• 主要场景是在可以容忍读到旧数据的情况下，降低小的只读事务获取 TSO 的开销。
• 从 v8.3.0 版本开始，该变量支持 GLOBAL 作用域。

tidb_low_resolution_tso_update_interval 从 v8.0.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：2000
• 范围：[10, 60000]
• 这个变量用来设置低精度 TSO 特性中使用的缓存 Timestamp 的更新时间间隔，单位为毫秒。
• 该变量只在低精度 TSO 特性 tidb_low_resolution_tso 启用时有效。

tidb_nontransactional_ignore_error 从 v6.1.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来设置是否在非事务语句中立刻返回错误。当设为 OFF 时，在碰到第一个报错的 batch 时，非事务 DML 语句即中止，取消其后的所有 batch，返回错误。当设为 ON 时，当某个 batch 执行报错时，其后的 batch 会继续执行，直到所有 batch 执行完毕，返回结果时把这些错误合并后返回。

tidb_max_auto_analyze_time 从 v6.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：43200
• 范围：[0, 2147483647]
• 单位：秒
• 这个变量用于指定自动 ANALYZE 的最大执行时间。当执行时间超出指定的时间时，自动 ANALYZE 会被终止。当该变量值为 0 时，自动 ANALYZE 没有最大执行时间的限制。

tidb_max_bytes_before_tiflash_external_group_by 从 v7.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：-1
• 范围：[-1, 9223372036854775807]
• 这个变量用于指定 TiFlash 中带有 GROUP BY 的 Hash Aggregation 算子的最大内存使用量，单位为 byte，超过该值之后 TiFlash 会触发 Hash Aggregation 算子的落盘。当该变量值为 -1 时，TiDB 不传递该变量给 TiFlash。只有该变量值大于等于 0 时，TiDB 才会传递该变量给 TiFlash。该变量为 0 时表示内存使用无限制，即 TiFlash Hash Aggregation 算子不会触发落盘。详情见 TiFlash 数据落盘。

tidb_max_bytes_before_tiflash_external_join 从 v7.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：-1
• 范围：[-1, 9223372036854775807]
• 这个变量用于指定 TiFlash 中带等值关联条件的 Hash Join 算子的最大内存使用量，单位为 byte，超过该值之后 TiFlash 会触发 Hash Join 算子的落盘。当该变量值为 -1 时，TiDB 不传递该变量给 TiFlash。只有该变量值大于等于 0 时，TiDB 才会传递该变量给 TiFlash。该变量为 0 时表示内存使用无限制，即 TiFlash Hash Join 算子不会触发落盘。详情见 TiFlash 数据落盘。

tidb_max_bytes_before_tiflash_external_sort 从 v7.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：-1
• 范围：[-1, 9223372036854775807]
• 这个变量用于指定 TiFlash 中带 topN 和 sort 算子的最大内存使用量，单位为 byte，超过该值之后 TiFlash 会触发 topN 和 sort 算子的落盘。当该变量值为 -1 时，TiDB 不传递该变量给 TiFlash。只有该变量值大于等于 0 时，TiDB 才会传递该变量给 TiFlash。该变量为 0 时表示内存使用无限制，即 TiFlash topN 和 sort 算子不会触发落盘。详情见 TiFlash 数据落盘。

tidb_max_chunk_size

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：1024
• 范围：[32, 2147483647]
• 单位：行
• 这个变量用来设置执行过程中一个 chunk 最大的行数，设置过大可能引起缓存局部性的问题，建议该变量不要超过 65536。chunk 行数直接影响单个查询所需的内存。可以按照查询中所有的列的总宽度和 chunk 行数来粗略估算单个 chunk 所需内存，并结合执行器的并发数来粗略估算单个查询所需内存总量。建议单个 chunk 内存总量不要超过 16 MiB。当查询涉及数据量较大、单个 chunk 无法处理所有数据时，TiDB 会进行多次处理，每次处理时将 chunk 行数翻倍，从 tidb_init_chunk_size 开始，直到 chunk 行数达到最大值 tidb_max_chunk_size。

tidb_max_delta_schema_count

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：1024
• 范围：[100, 16384]
• 这个变量用来设置缓存 schema 版本信息（对应版本修改的相关 table IDs）的个数限制，可设置的范围 100 - 16384。此变量在 2.1.18 及之后版本支持。

tidb_max_paging_size 从 v6.3.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：50000
• 范围：[1, 9223372036854775807]
• 单位：行
• 这个变量用来设置 coprocessor 协议中 paging size 的最大的行数。请合理设置该值，设置过小，TiDB 与 TiKV 的 RPC 交互会更频繁；设置过大，导数据和全表扫等特定场景会占用更多内存。该变量的默认值对于 OLTP 场景较友好，如果业务只使用了 TiKV 作为存储引擎，当执行偏 OLAP 的负载时，可以考虑将变量值调大，有可能获得更好的性能。

tidb_max_tiflash_threads 从 v6.1.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：-1
• 范围：[-1, 256]
• 单位：线程
• TiFlash 中 request 执行的最大并发度。默认值为 -1，表示该系统变量无效，此时最大并发度取决于 TiFlash 配置项 profiles.default.max_threads 的设置。0 表示由 TiFlash 系统自动设置该值。

tidb_mem_oom_action 从 v6.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：CANCEL
• 可选值：CANCEL，LOG
• 该变量控制当单个查询使用的内存超过限制 (tidb_mem_quota_query) 且不能再利用临时磁盘时，TiDB 所采取的操作。详情见 TiDB 内存控制。
• 该变量默认值为 CANCEL，但在 TiDB v4.0.2 及之前的版本中，默认值为 LOG。
• 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (oom-action) 进行配置，升级到 v6.1.0 时会自动继承原有设置。

tidb_mem_quota_analyze 从 v6.1.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：-1
• 单位：字节
• 取值范围：[-1, 9223372036854775807]
• 这个变量用来控制 TiDB 更新统计信息时的最大总内存占用，包括用户执行的 ANALYZE TABLE 和 TiDB 后台自动执行的统计信息更新任务。当总的内存占用超过这个阈值时，用户执行的 ANALYZE 会被终止退出，并通过错误信息提示用户尝试更小的采样率或稍后重试。如果 TiDB 后台自动执行的统计信息更新任务因内存超限而退出，且使用的采样率高于默认值，则会使用默认采样率重试一次。当该变量值为负数或零时，TiDB 不对更新统计信息的前后台任务进行内存限制。

tidb_mem_quota_apply_cache 从 v5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：33554432 (32 MiB)
• 范围：[0, 9223372036854775807]
• 单位：字节
• 这个变量用来设置 Apply 算子中局部 Cache 的内存使用阈值。
• Apply 算子中局部 Cache 用来加速 Apply 算子的计算，该变量可以设置 Apply Cache 的内存使用阈值。设置变量值为 0 可以关闭 Apply Cache 功能。

tidb_mem_quota_binding_cache 从 v6.0.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：67108864 (64 MiB)
• 范围：[0, 2147483647]
• 单位：字节
• 这个变量用来设置存放 binding 的缓存的内存使用阈值。
• 如果一个系统创建或者捕获了过多的绑定，导致绑定所使用的内存空间超过该阈值，TiDB 会在日志中增加警告日志进行提示。这种情况下，缓存无法存放所有可用的绑定，并且无法保证哪些绑定存在于缓存中，因此，可能存在一些查询无法使用可用绑定的情况。此时，可以调大该变量的值，从而保证所有可用绑定都能正常使用。修改变量值以后，需要执行命令 admin reload bindings 重新加载绑定，确保变更生效。

tidb_mem_quota_query

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：1073741824 (1 GiB)
• 范围：[-1, 9223372036854775807]
• 单位：字节
• 在 v6.1.0 之前的版本中，作用域为 SESSION。v6.1.0 及之后的版本，作用域变更为 SESSION | GLOBAL。
• 在 v6.5.0 之前的版本中，该变量用来设置单条查询的内存使用限制，如果单条查询执行过程中使用的内存量超过该阈值，会触发系统变量 tidb_mem_oom_action 中指定的行为。
• 在 v6.5.0 及之后的版本中，该变量用来设置单个会话整体的内存使用限制，如果某个会话执行过程中使用的内存量超过该阈值，会触发系统变量 tidb_mem_oom_action 中指定的行为。需要注意的是，自 v6.5.0 版本开始，会话的内存使用量包含会话中事务所消耗的内存。v6.5.0 及之后版本对事务内存的控制行为有所变化，详见 txn-total-size-limit。
• 当变量值为 0 或 -1 时，表示内存阈值为正无穷。此外，当变量值小于 128 时，将默认被设置为 128。

tidb_memory_debug_mode_alarm_ratio

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：浮点型
• 默认值：0
• 该变量表示在 TiDB memory debug 模式下，允许的内存统计误差值。
• 该变量用于 TiDB 内部测试，不推荐修改该变量值。

tidb_memory_debug_mode_min_heap_inuse

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：0
• 该变量用于 TiDB 内部测试，不推荐修改该变量值，因为开启后会影响 TiDB 的性能。
• 配置此参数后，TiDB 会进入 memory debug 模式进行内存追踪准确度的分析。TiDB 会在后续执行 SQL 语句的过程中频繁触发 GC，并将实际内存使用和内存统计值做对比。若当前内存使用大于 tidb_memory_debug_mode_min_heap_inuse 且内存统计误差超过 tidb_memory_debug_mode_alarm_ratio，则会输出相关内存信息到日志和文件中。

tidb_memory_usage_alarm_ratio

• 作用域：GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：否

• 类型：浮点数

• 默认值：0.7

• 范围：[0.0, 1.0]

• 这个变量用于设置触发 tidb-server 内存告警的内存使用比率。默认情况下，当 TiDB 内存使用量超过总内存的 70% 且满足报警条件时，TiDB 会打印报警日志。

• 当配置该变量的值为 0 或 1 时，表示关闭内存阈值报警功能。

• 当配置该变量为 0 到 1 之间的值时，表示开启内存阈值报警功能：

  • 如果系统变量 tidb_server_memory_limit 等于 0，则内存报警阈值为 tidb_memory_usage_alarm_ratio * 系统内存大小。
  • 如果系统变量 tidb_server_memory_limit 被设置为大于 0，则内存报警阈值为 tidb_memory_usage_alarm_ratio * tidb_server_memory_limit。

tidb_memory_usage_alarm_keep_record_num 从 v6.4.0 版本开始引入

• 作用域：GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：5
• 范围：[1, 10000]
• 当 tidb-server 内存占用超过内存报警阈值并触发报警时，TiDB 默认只保留最近 5 次报警时所生成的状态文件。你可以通过该变量调整该次数。

tidb_merge_join_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：1
• 取值范围：[1, 256]
• 设置 MergeJoin 算子执行查询时的并发度。
• 不推荐设置该变量，修改该变量值可能会造成数据正确性问题。

tidb_merge_partition_stats_concurrency

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 默认值：1
• 这个变量用于 TiDB analyze 分区表时，对分区表统计信息进行合并时的并发度。

tidb_enable_async_merge_global_stats 从 v7.5.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON。从 v7.5.0 之前版本升级到 v7.5.0 或之后版本时，默认值为 OFF。
• 这个变量用于设置 TiDB 使用异步方式合并统计信息，以避免 OOM 问题。

tidb_metric_query_range_duration 从 v4.0 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：60
• 范围：[10, 216000]
• 单位：秒
• 这个变量设置了查询 METRIC_SCHEMA 时生成的 Prometheus 语句的 range duration。

tidb_metric_query_step 从 v4.0 版本开始引入

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：否
• 类型：整数型
• 默认值：60
• 范围：[10, 216000]
• 单位：秒
• 这个变量设置了查询 METRIC_SCHEMA 时生成的 Prometheus 语句的 step。

tidb_min_paging_size 从 v6.2.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：128
• 范围：[1, 9223372036854775807]
• 单位：行
• 这个变量用来设置 coprocessor 协议中 paging size 的最小的行数。请合理设置该值，设置过小，TiDB 与 TiKV 的 RPC 交互会更频繁；设置过大，IndexLookup 带 Limit 场景会出现性能下降。该变量的默认值对于 OLTP 场景较友好，如果业务只使用了 TiKV 作为存储引擎，当执行偏 OLAP 的负载时，可以考虑将变量值调大，有可能获得更好的性能。

开启 tidb_enable_paging 时，tidb_min_paging_size 和 tidb_max_paging_size 对 TPCH 的性能影响如上图所示，纵轴是执行时间，越小越好。

tidb_mpp_store_fail_ttl

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：Duration
• 默认值：60s
• 刚重启的 TiFlash 可能不能正常提供服务。为了防止查询失败，TiDB 会限制 tidb-server 向刚重启的 TiFlash 节点发送查询。这个变量表示刚重启的 TiFlash 不被发送请求的时间范围。

tidb_multi_statement_mode 从 v4.0.11 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：枚举型
• 默认值：OFF
• 可选值：OFF，ON，WARN
• 该变量用于控制是否在同一个 COM_QUERY 调用中执行多个查询。
• 为了减少 SQL 注入攻击的影响，TiDB 目前默认不允许在同一 COM_QUERY 调用中执行多个查询。该变量可用作早期 TiDB 版本的升级路径选项。该变量值与是否允许多语句行为的对照表如下：

• go-sql-driver (multiStatements)
• Connector/J (allowMultiQueries)
• PHP mysqli (mysqli_multi_query)

tidb_opt_agg_push_down

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 这个变量用来设置优化器是否执行聚合函数下推到 Join，Projection 和 UnionAll 之前的优化操作。当查询中聚合操作执行很慢时，可以尝试设置该变量为 ON。

tidb_opt_broadcast_cartesian_join

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：1
• 范围：[0, 2]
• 表示是否允许 Broadcast Cartesian Join 算法。
• 值为 0 时表示不允许使用 Broadcast Cartesian Join 算法。值为 1 时表示根据 tidb_broadcast_join_threshold_count 的行数阈值确定是否允许使用 Broadcast Cartesian Join 算法。值为 2 时表示总是允许 Broadcast Cartesian Join 算法，即使表的大小超过了该阈值。
• 该变量是 TiDB 内部使用的变量，不推荐修改该变量的值。

tidb_opt_concurrency_factor

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：浮点数
• 范围：[0, 18446744073709551615]
• 默认值：3.0
• 表示在 TiDB 中开启一个 Golang goroutine 的 CPU 开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。

tidb_opt_copcpu_factor

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：浮点数
• 范围：[0, 18446744073709551615]
• 默认值：3.0
• 表示 TiKV 协处理器处理一行数据的 CPU 开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。

tidb_opt_correlation_exp_factor

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：1
• 范围：[0, 2147483647]
• 当交叉估算方法不可用时，会采用启发式估算方法。这个变量用来控制启发式方法的行为。当值为 0 时不用启发式估算方法，大于 0 时，该变量值越大，启发式估算方法越倾向 index scan，越小越倾向 table scan。

tidb_opt_correlation_threshold

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：浮点数
• 默认值：0.9
• 范围：[0, 1]
• 这个变量用来设置优化器启用交叉估算 row count 方法的阈值。如果列和 handle 列之间的顺序相关性超过这个阈值，就会启用交叉估算方法。
• 交叉估算方法可以简单理解为，利用这个列的直方图来估算 handle 列需要扫的行数。

tidb_opt_cpu_factor

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：浮点数
• 范围：[0, 2147483647]
• 默认值：3.0
• 表示 TiDB 处理一行数据的 CPU 开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。

tidb_opt_derive_topn 从 v7.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 表示是否开启从窗口函数中推导 TopN 或 Limit 的优化规则。

tidb_opt_desc_factor

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：浮点数
• 范围：[0, 18446744073709551615]
• 默认值：3.0
• 表示降序扫描时，TiKV 在磁盘上扫描一行数据的开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。

tidb_opt_disk_factor

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：浮点数
• 范围：[0, 18446744073709551615]
• 默认值：1.5
• 表示 TiDB 往临时磁盘读写一个字节数据的 I/O 开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。

tidb_opt_distinct_agg_push_down

• 作用域：SESSION
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 这个变量用来设置优化器是否执行带有 Distinct 的聚合函数（比如 select count(distinct a) from t）下推到 Coprocessor 的优化操作。当查询中带有 Distinct 的聚合操作执行很慢时，可以尝试设置该变量为 1。

在以下示例中，tidb_opt_distinct_agg_push_down 开启前，TiDB 需要从 TiKV 读取所有数据，并在 TiDB 侧执行 distinct。tidb_opt_distinct_agg_push_down 开启后，distinct a 被下推到了 Coprocessor，在 HashAgg_5 里新增里一个 group by 列 test.t.a。

mysql> desc select count(distinct a) from test.t;
+-------------------------+----------+-----------+---------------+------------------------------------------+
| id                      | estRows  | task      | access object | operator info                            |
+-------------------------+----------+-----------+---------------+------------------------------------------+
| StreamAgg_6             | 1.00     | root      |               | funcs:count(distinct test.t.a)->Column#4 |
| └─TableReader_10        | 10000.00 | root      |               | data:TableFullScan_9                     |
|   └─TableFullScan_9     | 10000.00 | cop[tikv] | table:t       | keep order:false, stats:pseudo           |
+-------------------------+----------+-----------+---------------+------------------------------------------+
3 rows in set (0.01 sec)

mysql> set session tidb_opt_distinct_agg_push_down = 1;
Query OK, 0 rows affected (0.00 sec)

mysql> desc select count(distinct a) from test.t;
+---------------------------+----------+-----------+---------------+------------------------------------------+
| id                        | estRows  | task      | access object | operator info                            |
+---------------------------+----------+-----------+---------------+------------------------------------------+
| HashAgg_8                 | 1.00     | root      |               | funcs:count(distinct test.t.a)->Column#3 |
| └─TableReader_9           | 1.00     | root      |               | data:HashAgg_5                           |
|   └─HashAgg_5             | 1.00     | cop[tikv] |               | group by:test.t.a,                       |
|     └─TableFullScan_7     | 10000.00 | cop[tikv] | table:t       | keep order:false, stats:pseudo           |
+---------------------------+----------+-----------+---------------+------------------------------------------+
4 rows in set (0.00 sec)

tidb_opt_enable_correlation_adjustment

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制优化器是否开启交叉估算。

tidb_opt_enable_hash_join 从 v6.5.6、v7.1.2 和 v7.4.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：ON
• 控制优化器是否会选择表的哈希连接。默认打开 (ON)。设置为 OFF 时，优化器在生成执行计划时会避免选择表的哈希连接，除非没有其他连接方式可用。
• 如果同时使用了 tidb_opt_enable_hash_join 和 HASH_JOIN Hint，则 HASH_JOIN Hint 优先级更高。即使 tidb_opt_enable_hash_join 被设置为 OFF，如果在查询中指定了 HASH_JOIN Hint，TiDB 优化器仍然会强制执行哈希连接计划。

tidb_opt_enable_non_eval_scalar_subquery 从 v7.3.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：否
• 类型：布尔型
• 默认值：OFF
• 这个变量用来控制 EXPLAIN 语句是否禁止提前执行可以在优化阶段展开的常量子查询。该变量设置为 OFF 时，EXPLAIN 语句会在优化阶段提前展开子查询。该变量设置为 ON 时，EXPLAIN 语句不会在优化阶段展开子查询。更多信息请参考禁止子查询提前展开。

tidb_opt_enable_late_materialization 从 v7.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制是否启用 TiFlash 延迟物化功能。注意在 TiFlash Fast Scan 模式下，延迟物化功能暂不可用。
• 当设置该变量为 OFF 关闭 TiFlash 延迟物化功能时，如果 SELECT 语句中包含过滤条件（WHERE 子句），TiFlash 会先扫描查询所需列的全部数据后再进行过滤。当设置该变量为 ON 开启 TiFlash 延迟物化功能时，TiFlash 会先扫描下推到 TableScan 算子的过滤条件相关的列数据，过滤得到符合条件的行后，再扫描这些行的其他列数据，继续后续计算，从而减少 IO 扫描和数据处理的计算量。

tidb_opt_enable_mpp_shared_cte_execution 从 v7.2.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 该变量控制非递归的公共表表达式 (CTE) 是否可以在 TiFlash MPP 执行。默认情况下，未开启该变量时，CTE 在 TiDB 执行，相较于开启该功能，执行性能有较大差距。

tidb_opt_enable_fuzzy_binding 从 v7.6.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 该变量控制是否开启跨数据库绑定执行计划功能。

tidb_opt_fix_control 从 v6.5.3 和 v7.1.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：字符串
• 默认值：""
• 这个变量用来控制优化器的一些内部行为。
• 一部分优化器行为的选择依赖用户场景或 SQL 编写方式。通过设置该变量，你可以更细粒度地控制优化器的行为，并且避免集群升级后优化器行为变化导致的性能回退。
• 详细介绍请参考 Optimizer Fix Controls。

tidb_opt_force_inline_cte 从 v6.3.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 这个变量用来控制是否强制 inline CTE。默认值为 OFF，即默认不强制 inline CTE。注意，此时依旧可以通过 MERGE() hint 来开启个别 CTE 的 inline。如果设置为 ON，则当前 session 中所有查询的 CTE（递归 CTE 除外）都会 inline。

tidb_opt_advanced_join_hint 从 v7.0.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：ON
• 这个变量用来控制包括 HASH_JOIN() Hint、MERGE_JOIN() Hint 等用于控制连接算法的 Join Method Hint 是否会影响 Join Reorder 的优化过程，包括 LEADING() Hint 的使用。默认值为 ON，即默认不影响。如果设置为 OFF，在一些同时使用 Join Method Hint 和 LEADING() Hint 的场景下可能会产生冲突。

tidb_opt_insubq_to_join_and_agg

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：是

• 类型：布尔型

• 默认值：ON

• 这个变量用来设置是否开启优化规则：将子查询转成 join 和 aggregation。

  例如，打开这个优化规则后，会将下面子查询做如下变化：

  select * from t where t.a in (select aa from t1);
  

  将子查询转成如下 join：

  select t.* from t, (select aa from t1 group by aa) tmp_t where t.a = tmp_t.aa;
  

  如果 t1 在列 aa 上有 unique 且 not null 的限制，可以直接改写为如下，不需要添加 aggregation。

  select t.* from t, t1 where t.a=t1.aa;
  

tidb_opt_join_reorder_threshold

• 作用域: SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：0
• 范围：[0, 2147483647]
• 这个变量用来控制 TiDB Join Reorder 算法的选择。当参与 Join Reorder 的节点个数大于该阈值时，TiDB 选择贪心算法，小于该阈值时 TiDB 选择动态规划 (dynamic programming) 算法。
• 目前对于 OLTP 的查询，推荐保持默认值。对于 OLAP 的查询，推荐将变量值设为 10~15 来获得 AP 场景下更好的连接顺序。

tidb_opt_limit_push_down_threshold

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：整数型
• 默认值：100
• 范围：[0, 2147483647]
• 这个变量用来设置将 Limit 和 TopN 算子下推到 TiKV 的阈值。
• 如果 Limit 或者 TopN 的取值小于等于这个阈值，则 Limit 和 TopN 算子会被强制下推到 TiKV。该变量可以解决部分由于估算误差导致 Limit 或者 TopN 无法被下推的问题。

tidb_opt_memory_factor

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：浮点数
• 范围：[0, 2147483647]
• 默认值：0.001
• 表示 TiDB 存储一行数据的内存开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。

tidb_opt_mpp_outer_join_fixed_build_side 从 v5.1.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：布尔型
• 默认值：OFF
• 当该变量值为 ON 时，左连接始终使用内表作为构建端，右连接始终使用外表作为构建端。将该变量值设为 OFF 后，外连接可以灵活选择任意一边表作为构建端。

tidb_opt_network_factor

• 作用域：SESSION | GLOBAL
• 是否持久化
• 是否受 Hint SET_VAR 控制：是
• 类型：浮点数
• 范围：[0, 2147483647]
• 默认值：1.0
• 表示传输 1 比特数据的网络净开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。

tidb_opt_objective 从 v7.4.0 版本开始引入

• 作用域：SESSION | GLOBAL
• 是否持久化到集群：是
• 是否受 Hint SET_VAR 控制：是
• 类型：枚举型
• 默认值：moderate
• 可选值：moderate、determinate
• 该变量用于设置优化器优化目标。moderate 与 TiDB v7.4.0 之前版本的默认行为保持一致，优化器会利用更多信息尝试生成更优的计划。determinate 则倾向于保守，保持执行计划稳定。
• 实时统计信息是 TiDB 在运行时根据 DML 语句自动更新的表的总行数以及修改的行数。该变量保持默认值 moderate 时，TiDB 会基于实时统计信息来生成执行计划。该变量设为 determinate 后，TiDB 在生成执行计划时将不再使用实时统计信息，这会让执行计划相对稳定。
• 对于长期稳定的 OLTP 业务，或者如果用户对系统已有的执行计划非常确定，则推荐使用 determinate 模式减少执行计划跳变的可能。同时还可以结合 LOCK STATS 来阻止统计信息的更新，进一步稳定执行计划。

tidb_opt_ordering_index_selectivity_ratio 从 v8.0.0 版本开始引入

• 作用域：SESSION | GLOBAL

• 是否持久化到集群：是

• 是否受 Hint SET_VAR 控制：是

• 类型：浮点数

• 默认值：-1

• 范围：[-1, 1]

• 当一个索引满足 SQL 语句中的 ORDER BY 和 LIMIT 子句，但有部分过滤条件未被该索引覆盖时，该系统变量用于控制该索引的估算行数。

• 该变量适用的场景与系统变量 tidb_opt_ordering_index_selectivity_threshold 相同。

• 与 tidb_opt_ordering_index_selectivity_threshold 的实现不同，该变量采用范围内符合条件的可能行数的比率或百分比。

• 取值为 -1（默认值）或小于 0 时，禁用此变量。取值在 0 到 1 之间时，对应 0% 到 100% 的比率（例如，0.5 对应 50%）。

• 在以下示例中，表 t 共有 1,000,000 行数据。示例使用相同查询，但应用了不同的 tidb_opt_ordering_index_selectivity_ratio 值。示例中的查询包含一个 WHERE 子句谓词，该谓词匹配少量行（1,000,000 中的 9,000 行）。存在一个支持 ORDER BY a 的索引（索引 ia），但是对 b 的过滤不在此索引中。根据实际的数据分布，满足 WHERE 子句和 LIMIT 1 的行可能在扫描非过滤索引时作为第一行访问到，也可能在几乎处理满足所有行后才找到。

• 每个示例中都使用了一个索引 hint，用于展示对 estRows 的影响。最终计划选择取决于是否存在代价更低的其他计划。

• 第一个示例使用默认值 -1，使用现有的估算公式。默认行为是，在找到符合条件的行之前，会扫描一小部分行进行估算。

  > SET SESSION tidb_opt_ordering_index_selectivity_ratio = -1;
  
  > EXPLAIN SELECT * FROM t USE INDEX (ia) WHERE b <= 9000 ORDER BY a LIMIT 1;
  +-----------------------------------+---------+-----------+-----------------------+---------------------------------+
  | id                                | estRows | task      | access object         | operator info                   |
  +-----------------------------------+---------+-----------+-----------------------+---------------------------------+
  | Limit_12                          | 1.00    | root      |                       | offset:0, count:1               |
  | └─Projection_22                   | 1.00    | root      |                       | test.t.a, test.t.b, test.t.c    |
  |   └─IndexLookUp_21                | 1.00    | root      |                       |                                 |
  |     ├─IndexFullScan_18(Build)     | 109.20  | cop[tikv] | table:t, index:ia(a)  | keep order:true                 |
  |     └─Selection_20(Probe)         | 1.00    | cop[tikv] |                       | le(test.t.b, 9000)              |
  |       └─TableRowIDScan_19         | 109.20  | cop[tikv] | table:t               | keep order:false                |
  +-----------------------------------+---------+-----------+-----------------------+---------------------------------+
  

• 第二个示例使用 0，假设在找到符合条件的行之前，将扫描 0% 的行。

  > SET SESSION tidb_opt_ordering_index_selectivity_ratio = 0;
  
  > EXPLAIN SELECT * FROM t USE INDEX (ia) WHERE b <= 9000 ORDER BY a LIMIT 1;
  +-----------------------------------+---------+-----------+-----------------------+---------------------------------+
  | id                                | estRows | task      | access object         | operator info                   |
  +-----------------------------------+---------+-----------+-----------------------+---------------------------------+
  | Limit_12                          | 1.00    | root      |                       | offset:0, count:1               |
  | └─Projection_22                   | 1.00    | root      |                       | test.t.a, test.t.b, test.t.c    |
  |   └─IndexLookUp_21                | 1.00    | root      |                       |                                 |
  |     ├─IndexFullScan_18(Build)     | 1.00    | cop[tikv] | table:t, index:ia(a)  | keep order:true                 |
  |     └─Selection_20(Probe)         | 1.00    | cop[tikv] |                       | le(test.t.b, 9000)              |
  |       └─TableRowIDScan_19         | 1.00    | cop[tikv] | table:t               | keep order:false                |
  +-----------------------------------+---------+-----------+-----------------------+---------------------------------+
  

• 第三个示例使用 0.1，假设在找到符合条件的行之前，将扫描 10% 的行。这个条件的过滤性较强，只有 1% 的行符合条件，因此最坏情况是找到这 1% 之前需要扫描 99% 的行。99% 中的 10% 大约是 9.9%，该数值会反映在 estRows 中。

  > SET SESSION tidb_opt_ordering_index_selectivity_ratio = 0.1;
  
  > EXPLAIN SELECT * FROM t USE INDEX (ia) WHERE b <= 9000 ORDER BY a LIMIT 1;
  +-----------------------------------+----------+-----------+-----------------------+---------------------------------+
  | id                                | estRows  | task      | access object         | operator info                   |
  +-----------------------------------+----------+-----------+-----------------------+---------------------------------+
  | Limit_12                          | 1.00     | root      |                       | offset:0, count:1               |
  | └─Projection_22                   | 1.00     | root      |                       | test.t.a, test.t.b, test.t.c    |
  |   └─IndexLookUp_21                | 1.00     | root      |                       |                                 |
  |     ├─IndexFullScan_18(Build)     | 99085.21 | cop[tikv] | table:t, index:ia(a)  | keep order:true                 |
  |     └─Selection_20(Probe)         | 1.00     | cop[tikv] |                       | le(test.t.b, 9000)              |
  |       └─TableRowIDScan_19         | 99085.21 | cop[tikv] | table:t               | keep order:false                |
  +-----------------------------------+----------+-----------+-----------------------+---------------------------------+
  

• 第四个示例使用 1.0，假设在找到符合条件的行之前，将扫描 100% 的行。

  > SET SESSION tidb_opt_ordering_index_selectivity_ratio = 1;
  
  > EXPLAIN SELECT * FROM t USE INDEX (ia) WHERE b <= 9000 ORDER BY a LIMIT 1;
  +-----------------------------------+-----------+-----------+-----------------------+---------------------------------+
  | id                                | estRows   | task      | access object         | operator info                   |
  +-----------------------------------+-----------+-----------+-----------------------+---------------------------------+
  | Limit_12                          | 1.00      | root      |                       | offset:0, count:1               |
  | └─Projection_22                   | 1.00      | root      |                       | test.t.a, test.t.b, test.t.c    |
  |   └─IndexLookUp_21                | 1.00      | root      |                       |                                 |
  |     ├─IndexFullScan_18(Build)     | 990843.14 | cop[tikv] | table:t, index:ia(a)  | keep order:true                 |
  |     └─Selection_20(Probe)         | 1.00      | cop[tikv] |                       | le(test.t.b, 9000)              |
  |       └─TableRowIDScan_19         | 990843.14 | cop[tikv] | table:t               | keep order:false                |
  +-----------------------------------+-----------+-----------+-----------------------+---------------------------------+
  

• 第五个示例也使用 1.0，但是增加了一个对 a 的谓词，限制了最坏情况下的扫描范围，因为 WHERE a <= 9000 匹配了索引，大约有 9,000 行符合条件。考虑到 b 上的过滤谓词不在索引中，所有大约 9,000 行在找到符合 b <= 9000 的行之前都会被扫描。

  > SET SESSION tidb_opt_ordering_index_selectivity_ratio = 1;
  
  > EXPLAIN SELECT * FROM t USE INDEX (ia) WHERE a <= 9000 AND b <= 9000 ORDER BY a LIMIT 1;
  +------------------------------------+---------+-----------+-----------------------+------------------------------------+
  | id                                 | estRows | task      | access object         | operator info                      |
  +------------------------------------+---------+-----------+-----------------------+------------------------------------+
  | Limit_12                           | 1.00    | root      |                       | offset:0, count:1                  |
  | └─Projection_22                    | 1.00    | root      |                       | test.t.a, test.t.b, test.t.c       |
  |   └─IndexLookUp_21                 | 1.00    | root      |                       |                                    |
  |     ├─IndexRangeScan_18(Build)     | 9074.99 | cop[tikv] | table:t, index:ia(a)  | range:[-inf,9000], keep order:true |
  |     └─Selection_20(Probe)          | 1.00    | cop[tikv] |                       | le(test.t.b, 9000)                 |
  |       └─TableRowIDScan_19          | 9074.99 | cop[tikv] | table:t               | keep order:false                   |
  +------------------------------------+---------+-----------+-----------------------+------------------------------------+