系统变量
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;
变量参考
allow_auto_random_explicit_insert 从 v4.0.3 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 是否允许在
INSERT语句中显式指定含有AUTO_RANDOM属性的列的值。
auto_increment_increment
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
1 - 范围：
[1, 65535] - 控制
AUTO_INCREMENT自增值字段的自增步长和AUTO_RANDOMID 的分配规则。该变量常与auto_increment_offset一起使用。
auto_increment_offset
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
1 - 范围：
[1, 65535] - 控制
AUTO_INCREMENT自增值字段的初始值和AUTO_RANDOMID 的分配规则。该变量常与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
- 是否持久化到集群：是
- 默认值：
ON - 用于设置在非显式事务时是否自动提交事务。更多信息，请参见事务概述。
block_encryption_mode
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：枚举型
- 默认值：
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
- 是否持久化到集群：是
- 默认值：
utf8mb4 - 这个变量表示从客户端发出的数据所用的字符集。有关更多 TiDB 支持的字符集和排序规则，参阅字符集和排序规则文档。如果需要更改字符集，建议使用
SET NAMES语句。
character_set_connection
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
utf8mb4 - 若没有为字符串常量指定字符集，该变量表示这些字符串常量所使用的字符集。
character_set_database
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
utf8mb4 - 该变量表示当前默认在用数据库的字符集，不建议设置该变量。选择新的默认数据库后，服务器会更改该变量的值。
character_set_results
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
utf8mb4 - 该变量表示数据发送至客户端时所使用的字符集。
character_set_server
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
utf8mb4 - 当
CREATE SCHEMA中没有指定字符集时，该变量表示这些新建的表结构所使用的字符集。
collation_connection
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
utf8mb4_bin - 该变量表示连接中所使用的排序规则。与 MySQL 中的
collation_connection一致。
collation_database
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
utf8mb4_bin - 该变量表示当前数据库默认所使用的排序规则。与 MySQL 中的
collation_database一致。不建议设置此变量，当前使用的数据库变动时，此变量会被 TiDB 修改。
collation_server
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
utf8mb4_bin - 该变量表示创建数据库时默认的排序规则。
cte_max_recursion_depth
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
1000 - 范围：
[0, 4294967295] - 这个变量用于控制公共表表达式的最大递归深度。
datadir
- 作用域：NONE
- 默认值：/tmp/tidb
- 这个变量表示数据存储的位置，位置可以是本地路径。如果数据存储在 TiKV 上，则可以是指向 PD 服务器的路径。
- 如果变量值的格式为
ip_address:port，表示 TiDB 在启动时连接到的 PD 服务器。
ddl_slow_threshold
- 作用域：GLOBAL
- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
- 默认值：
300 - 单位：毫秒
- 耗时超过该阈值的 DDL 操作会被输出到日志。
default_authentication_plugin
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
mysql_native_password - 可选值：
mysql_native_password，caching_sha2_password - 服务器和客户端建立连接时，这个变量用于设置服务器对外通告的默认身份验证方式。如要了解该变量的其他可选值，参见可用的身份验证插件。
default_week_format
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：整数
- 默认值：
0 - 取值范围：
[0, 7] - 设置
WEEK()函数使用的周格式。
error_count
- 作用域：NONE
- 类型：整数
- 表示上一条生成消息的 SQL 语句中的错误数。该变量为只读变量。
foreign_key_checks
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 为保持兼容，TiDB 对外键检查返回
OFF。
group_concat_max_len
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：整数
- 默认值：
1024 - 取值范围：
[4, 18446744073709551615] - 表示
GROUP_CONCAT()函数缓冲区的最大长度。
have_openssl
- 作用域：NONE
- 默认值：
DISABLED - 用于 MySQL 兼容性的只读变量。当服务器启用 TLS 时，服务器将其设置为
YES。
have_ssl
- 作用域：NONE
- 默认值：
DISABLED - 用于 MySQL 兼容性的只读变量。当服务器启用 TLS 时，服务器将其设置为
YES。
hostname
- 作用域：NONE
- 默认值：（系统主机名）
- 这个变量一个只读变量，表示 TiDB server 的主机名。
identity 从 v5.3.0 版本开始引入
- 该变量为变量
last_insert_id的别名。
init_connect
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：""
- 用户首次连接到 TiDB 服务器时，
init_connect特性允许 TiDB 自动执行一条或多条 SQL 语句。如果你有CONNECTION_ADMIN或者SUPER权限，这些 SQL 语句将不会被自动执行。如果这些语句执行报错，你的用户连接将被终止。
innodb_lock_wait_timeout
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
50 - 范围：
[1, 3600] - 单位：秒
- 悲观事务语句等锁时间。
interactive_timeout
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
28800 - 范围：
[1, 31536000] - 单位：秒
- 该变量表示交互式用户会话的空闲超时。交互式用户会话是指使用
CLIENT_INTERACTIVE选项调用mysql_real_connect()API 建立的会话（例如：MySQL shell 和 MySQL client）。该变量与 MySQL 完全兼容。
last_insert_id 从 v5.3.0 版本开始引入
- 返回由 INSERT 语句产生的最新
AUTO_INSCRENT或者AUTO_RANDOM值，与LAST_INSERT_ID()的返回的结果相同。与 MySQL 中的last_insert_id一致。 - 作用域：SESSION
- 默认值：
0
last_plan_from_binding 从 v4.0 版本开始引入
- 作用域：SESSION
- 默认值：
OFF - 该变量用来显示上一条执行的语句所使用的执行计划是否来自 binding 的执行计划。
last_plan_from_cache 从 v4.0 版本开始引入
- 作用域：SESSION
- 默认值：
OFF - 这个变量用来显示上一个
execute语句所使用的执行计划是不是直接从 plan cache 中取出来的。
license
- 作用域：NONE
- 默认值：
Apache License 2.0 - 这个变量表示 TiDB 服务器的安装许可证。
log_bin
- 作用域：NONE
- 类型：布尔型
- 默认值：
OFF - 该变量表示是否使用 TiDB Binlog。
max_connections
- 作用域：GLOBAL
- 是否持久化到集群：否
- 类型：整数
- 默认值：
151 - 取值范围：
[0, 100000] - 该变量表示 TiDB 实例允许的最大连接数。该变量为 noop 变量，设置该变量值无效。若要设置 TiDB 实例允许的最大连接数，可通过 TiDB 配置文件设置
max-server-connections。 - 该变量值为
0时表示无限制。
max_execution_time
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
0 - 范围：
[0, 2147483647] - 单位：毫秒
- 语句最长执行时间。默认值 (0) 表示无限制。
max_allowed_packet 从 v6.1.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：67108864
- 取值范围：
[1024, 1073741824]，且应当为 1024 的整数倍；若取值无法被 1024 整除，则会提示 warning 并向下取整。例如设置为 1025 时，则 TiDB 中的实际取值为 1024。 - 服务器端和客户端在一次传送数据包的过程中所允许最大的数据包大小，单位为字节。
- 在
SESSION作用域下，该变量为只读变量。 - 该变量的行为与 MySQL 兼容。
max_prepared_stmt_count
- 作用域：GLOBAL
- 是否持久化到集群：是
- 类型：整数
- 默认值：
-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)
plugin_dir
- 作用域：GLOBAL
- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
- 默认值：""
- 指定加载插件的目录。
plugin_load
- 作用域：GLOBAL
- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
- 默认值：""
- 指定 TiDB 启动时加载的插件，多个插件之间用逗号（,）分隔。
port
- 作用域：NONE
- 默认值：
4000 - 范围：
[0, 65535] - 使用 MySQL 协议时 tidb-server 监听的端口。
rand_seed1
- 作用域：SESSION
- 默认值：
0 - 范围：
[0, 2147483647] - 该变量用于为 SQL 函数
RAND()中使用的随机值生成器添加种子。 - 该变量的行为与 MySQL 兼容。
rand_seed2
- 作用域：SESSION
- 默认值：
0 - 范围：
[0, 2147483647] - 该变量用于为 SQL 函数
RAND()中使用的随机值生成器添加种子。 - 该变量的行为与 MySQL 兼容。
require_secure_transport 从 v6.1.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 该变量控制是否所有 TiDB 的连接都在本地 socket 上进行通信，或使用 TLS。详情见为 TiDB 客户端服务端间通信开启加密传输。
- 该变量设置为
ON时，必须使用开启 TLS 的会话连接到 TiDB，防止在 TLS 配置不正确时出现锁定的情况。 - 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (
security.require-secure-transport) 进行配置，升级到 v6.1.0 时会自动继承原有设置。
skip_name_resolve 从 v5.2.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 该变量控制
tidb-server实例是否将主机名作为连接握手的一部分来解析。 - 当 DNS 不可靠时，可以启用该变量来提高网络性能。
socket
- 作用域：NONE
- 默认值：""
- 使用 MySQL 协议时，tidb-server 所监听的本地 unix 套接字文件。
sql_log_bin
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
ON - 表示是否将更改写入 TiDB Binlog。
sql_mode
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
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_select_limit 从 v4.0.2 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
18446744073709551615 - 范围：
[0, 18446744073709551615] - 单位：行
SELECT语句返回的最大行数。
ssl_ca
- 作用域：NONE
- 默认值：""
- 证书颁发机构 (CA) 文件的位置。若文件不存在，则变量值为空。该变量的值由 TiDB 配置项
ssl-ca定义。
ssl_cert
- 作用域：NONE
- 默认值：""
- 用于 SSL/TLS 连接的证书文件的位置。若文件不存在，则变量值为空。该变量的值由 TiDB 配置项
ssl-cert定义。
ssl_key
- 作用域：NONE
- 默认值：""
- 用于 SSL/TLS 连接的私钥文件的位置。若文件不存在，则变量值为空。该变量的值由 TiDB 配置项
ssl-key定义。
system_time_zone
- 作用域：NONE
- 默认值：（随系统）
- 该变量显示首次引导启动 TiDB 时的系统时区。另请参阅
time_zone。
tidb_allow_batch_cop 从 v4.0 版本开始引入
作用域：SESSION | GLOBAL
是否持久化到集群：是
默认值：
1范围：
[0, 2]这个变量用于控制 TiDB 向 TiFlash 发送 coprocessor 请求的方式，有以下几种取值：
- 0：从不批量发送请求
- 1：aggregation 和 join 的请求会进行批量发送
- 2：所有的 cop 请求都会批量发送
tidb_allow_fallback_to_tikv 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：""
- 这个变量表示将 TiKV 作为备用存储引擎的存储引擎列表。当该列表中的存储引擎发生故障导致 SQL 语句执行失败时，TiDB 会使用 TiKV 作为存储引擎再次执行该 SQL 语句。目前支持设置该变量为 "" 或者 "tiflash"。如果设置该变量为 "tiflash"，当 TiFlash 返回超时错误（对应的错误码为 ErrTiFlashServerTimeout）时，TiDB 会使用 TiKV 作为存储引擎再次执行该 SQL 语句。
tidb_allow_function_for_expression_index 从 v5.2.0 版本开始引入
- 作用域：NONE
- 默认值：
lower, md5, reverse, tidb_shard, upper, vitess_hash - 这个变量用于显示创建表达式索引所允许使用的函数。
tidb_allow_mpp 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用于控制是否使用 TiFlash 的 MPP 模式执行查询，可以设置的值包括：
- 0 或 OFF，代表从不使用 MPP 模式
- 1 或 ON，代表由优化器根据代价估算选择是否使用 MPP 模式（默认）
MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数据交换并提供高性能、高吞吐的 SQL 算法。MPP 模式选择的详细说明参见控制是否选择 MPP 模式。
tidb_allow_remove_auto_inc 从 v2.1.18 和 v3.0.4 版本开始引入
- 作用域：SESSION
- 默认值：
OFF - 这个变量用来控制是否允许通过
ALTER TABLE MODIFY或ALTER TABLE CHANGE来移除某个列的AUTO_INCREMENT属性。默认 (OFF) 为不允许。
tidb_analyze_version 从 v5.1.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
2 - 范围：
[1, 2] - 这个变量用于控制 TiDB 收集统计信息的行为。
- 在 v5.3.0 及之后的版本中，该变量的默认值为
2，具体可参照统计信息简介文档。如果从 v5.3.0 之前版本的集群升级至 v5.3.0 及之后的版本，tidb_analyze_version的默认值不发生变化。
tidb_auto_analyze_end_time
作用域：GLOBAL
是否持久化到集群：是
默认值：
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_ratio
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
0.5 - 这个变量用来设置 TiDB 在后台自动执行
ANALYZE TABLE更新统计信息的阈值。0.5指的是当表中超过 50% 的行被修改时，触发自动 ANALYZE 更新。可以指定tidb_auto_analyze_start_time和tidb_auto_analyze_end_time来限制自动 ANALYZE 的时间
tidb_auto_analyze_start_time
作用域：GLOBAL
是否持久化到集群：是
默认值：
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_max_auto_analyze_time 从 v6.1.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
43200 - 范围：
[0, 2147483647] - 单位：秒
- 这个变量用于指定自动 ANALYZE 的最大执行时间。当执行时间超出指定的时间时，自动 ANALYZE 会被终止。当该变量值为 0 时，自动 ANALYZE 没有最大执行时间的限制。
tidb_backoff_lock_fast
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
10 - 范围：
[1, 2147483647] - 这个变量用来设置读请求遇到锁的 backoff 时间。
tidb_backoff_weight
作用域：SESSION | GLOBAL
是否持久化到集群：是
默认值：
2范围：
[0, 2147483647]这个变量用来给 TiDB 的
backoff最大时间增加权重，即内部遇到网络或其他组件 (TiKV, PD) 故障时，发送重试请求的最大重试时间。可以通过这个变量来调整最大重试时间，最小值为 1。例如，TiDB 向 PD 取 TSO 的基础超时时间是 15 秒，当
tidb_backoff_weight = 2时，取 TSO 的最大超时时间为：基础时间 * 2 等于 30 秒。在网络环境较差的情况下，适当增大该变量值可以有效缓解因为超时而向应用端报错的情况；而如果应用端希望更快地接到报错信息，则应该尽量减小该变量的值。
tidb_batch_commit
- 作用域：SESSION
- 是否持久化到集群：否
- 类型：布尔型
- 默认值：
OFF - 该变量控制是否启用已废弃的 batch-commit 特性。当该变量开启时，事务可能会通过分组一些语句被拆分为多个事务，并被非原子地提交。不推荐使用这种方式。
tidb_batch_delete
- 作用域：SESSION
- 是否持久化到集群：否
- 类型：布尔型
- 默认值：
OFF - 该变量控制是否启用已废弃的 batch-dml 特性中的 batch-delete 特性。当该变量开启时，
DELETE语句可能会被拆分为多个事务，并被非原子地提交。要使该特性生效，还需要开启tidb_enable_batch_dml并将tidb_dml_batch_size的值设置为正数。不推荐使用这种方式。
tidb_batch_insert
- 作用域：SESSION
- 是否持久化到集群：否
- 类型：布尔型
- 默认值：
OFF - 该变量控制是否启用已废弃的 batch-dml 特性中的 batch-insert 特性。当该变量开启时，
INSERT语句可能会被拆分为多个事务，并被非原子地提交。要使该特性生效，还需要开启tidb_enable_batch_dml并将tidb_dml_batch_size的值设置为正数。不推荐使用这种方式。
tidb_batch_pending_tiflash_count 从 v6.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
4000 - 范围：
[0, 2147483647] - 使用
ALTER DATABASE SET TIFLASH REPLICA语句为 TiFlash 添加副本时，能容许的不可用表的个数上限。如果超过该上限，则会停止或者以非常慢的速度为库中的剩余表设置 TiFlash 副本。
tidb_broadcast_join_threshold_count 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
10240 - 范围：
[0, 9223372036854775807] - 单位：行
- 如果 join 的对象为子查询，优化器无法估计子查询结果集大小，在这种情况下通过结果集行数判断。如果子查询的行数估计值小于该变量，则选择 Broadcast Hash Join 算法。否则选择 Shuffled Hash Join 算法。
tidb_broadcast_join_threshold_size 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
104857600(100 MiB) - 范围：
[0, 9223372036854775807] - 单位：字节
- 如果表大小（字节数）小于该值，则选择 Broadcast Hash Join 算法。否则选择 Shuffled Hash Join 算法。
tidb_build_stats_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
4 - 单位：线程
- 这个变量用来设置 ANALYZE 语句执行时并发度。
- 当这个变量被设置得更大时，会对其它的查询语句执行性能产生一定影响。
tidb_capture_plan_baselines 从 v4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用于控制是否开启自动捕获绑定功能。该功能依赖 Statement Summary，因此在使用自动绑定之前需打开 Statement Summary 开关。
- 开启该功能后会定期遍历一次 Statement Summary 中的历史 SQL 语句，并为至少出现两次的 SQL 语句自动创建绑定。
tidb_check_mb4_value_in_utf8
- 作用域：GLOBAL
- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
- 默认值：
ON - 设置该变量为
ON可强制只存储基本多文种平面 (BMP) 编码区段内的utf8字符值。若要存储 BMP 区段外的utf8值，推荐使用utf8mb4字符集。 - 早期版本的 TiDB 中 (v2.1.x)，
utf8检查更为宽松。如果你的 TiDB 集群是从早期版本升级的，推荐关闭该变量，详情参阅升级与升级后常见问题。
tidb_committer_concurrency 从 v6.1.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
128 - 范围：
[1, 10000] - 在单个事务的提交阶段，用于执行提交操作相关请求的 goroutine 数量。
- 若提交的事务过大，事务提交时的流控队列等待耗时可能会过长。此时，可以通过调大该配置项来加速提交。
- 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (
performance.committer-concurrency) 进行配置，升级到 v6.1.0 时会自动继承原有设置。
tidb_checksum_table_concurrency
- 作用域：SESSION
- 默认值：
4 - 单位：线程
- 这个变量用来设置
ADMIN CHECKSUM TABLE语句执行时扫描索引的并发度。当这个变量被设置得更大时，会对其它的查询语句执行性能产生一定影响。
tidb_config
- 作用域：SESSION
- 默认值：""
- 这个变量是一个只读变量，用来获取当前 TiDB Server 的配置信息。
tidb_constraint_check_in_place
作用域：SESSION | GLOBAL
是否持久化到集群：是
默认值：
OFF该变量仅适用于乐观事务模型。当这个变量设置为
OFF时，唯一索引的重复值检查会被推迟到事务提交时才进行。这有助于提高性能，但对于某些应用，可能导致非预期的行为。详情见约束。乐观事务模型下将
tidb_constraint_check_in_place设置为 0：create table t (i int key); insert into t values (1); begin optimistic; insert into t values (1);Query OK, 1 row affectedtidb> commit; -- 事务提交时才检查ERROR 1062 : Duplicate entry '1' for key 'PRIMARY'乐观事务模型下将
tidb_constraint_check_in_place设置为 1：set @@tidb_constraint_check_in_place=1; begin optimistic; insert into t values (1);ERROR 1062 : Duplicate entry '1' for key 'PRIMARY'
悲观事务模式中，始终默认执行约束检查。
tidb_current_ts
- 作用域：SESSION
- 默认值：
0 - 这个变量是一个只读变量，用来获取当前事务的时间戳。
tidb_ddl_error_count_limit
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
512 - 范围：
[0, 9223372036854775807] - 这个变量用来控制 DDL 操作失败重试的次数。失败重试次数超过该参数的值后，会取消出错的 DDL 操作。
tidb_ddl_reorg_batch_size
作用域：GLOBAL
是否持久化到集群：是
默认值：
256范围：
[32, 10240]单位：行
这个变量用来设置 DDL 操作
re-organize阶段的 batch size。比如ADD INDEX操作，需要回填索引数据，通过并发tidb_ddl_reorg_worker_cnt个 worker 一起回填数据，每个 worker 以 batch 为单位进行回填。- 如果
ADD INDEX操作时有较多UPDATE操作或者REPLACE等更新操作，batch size 越大，事务冲突的概率也会越大，此时建议调小 batch size 的值，最小值是 32。 - 在没有事务冲突的情况下，batch size 可设为较大值（需要参考 worker 数量，见线上负载与
ADD INDEX相互影响测试），这样回填数据的速度更快，但是 TiKV 的写入压力也会变大。
- 如果
tidb_ddl_reorg_priority
- 作用域：SESSION
- 默认值：PRIORITY_LOW
- 这个变量用来设置
ADD INDEX操作re-organize阶段的执行优先级，可设置为PRIORITY_LOW/PRIORITY_NORMAL/PRIORITY_HIGH。
tidb_ddl_reorg_worker_cnt
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
4 - 范围：
[1, 256] - 单位：线程
- 这个变量用来设置 DDL 操作
re-organize阶段的并发度。
tidb_disable_txn_auto_retry
作用域：SESSION | GLOBAL
是否持久化到集群：是
默认值：
ON这个变量用来设置是否禁用显式的乐观事务自动重试，设置为
ON时，不会自动重试，如果遇到事务冲突需要在应用层重试。如果将该变量的值设为
OFF，TiDB 将会自动重试事务，这样在事务提交时遇到的错误更少。需要注意的是，这样可能会导致数据更新丢失。这个变量不会影响自动提交的隐式事务和 TiDB 内部执行的事务，它们依旧会根据
tidb_retry_limit的值来决定最大重试次数。关于是否需要禁用自动重试，请参考重试的局限性。
该变量只适用于乐观事务，不适用于悲观事务。悲观事务的重试次数由
max_retry_count控制。
tidb_distsql_scan_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
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
- 是否持久化到集群：是
- 默认值：
0 - 范围：
[0, 2147483647] - 单位：行
- 这个变量的值大于
0时，TiDB 会将INSERT或LOAD DATA等语句在更小的事务中批量提交。这样可减少内存使用，确保大批量修改时事务大小不会达到txn-total-size-limit限制。 - 只有变量值为
0时才符合 ACID 要求。否则无法保证 TiDB 的原子性和隔离性要求。 - 要使该特性生效，还需要开启
tidb_enable_batch_dml，以及至少开启tidb_batch_insert和tidb_batch_delete中的一个。
tidb_enable_1pc 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 指定是否在只涉及一个 Region 的事务上启用一阶段提交特性。比起传统两阶段提交，一阶段提交能大幅降低事务提交延迟并提升吞吐。
tidb_enable_amend_pessimistic_txn 从 v4.0.7 版本开始引入
作用域：SESSION | GLOBAL
是否持久化到集群：是
默认值：
OFF这个变量用于控制是否开启
AMEND TRANSACTION特性。在悲观事务模式下开启该特性后，如果该事务相关的表存在并发 DDL 操作和 SCHEMA VERSION 变更，TiDB 会尝试对该事务进行 amend 操作，修正该事务的提交内容，使其和最新的有效 SCHEMA VERSION 保持一致，从而成功提交该事务而不返回Information schema is changed报错。该特性对以下并发 DDL 变更生效：ADD COLUMN或DROP COLUMN类型的 DDL 操作。MODIFY COLUMN或CHANGE COLUMN类型的 DDL 操作，且只对增大字段长度的操作生效。ADD INDEX或DROP INDEX类型的 DDL 操作，且操作的索引列须在事务开启之前创建。
tidb_enable_async_commit 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 该变量控制是否启用 Async Commit 特性，使事务两阶段提交的第二阶段于后台异步进行。开启本特性能降低事务提交的延迟。
tidb_enable_auto_analyze 从 v6.1.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 该变量控制 TiDB 是否以后台操作自动更新表的统计信息。
- 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (
performance.run-auto-analyze) 进行配置，升级到 v6.1.0 时会自动继承原有设置。
tidb_enable_auto_increment_in_generated
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用于控制是否允许在创建生成列或者表达式索引时引用自增列。
tidb_enable_batch_dml
- 作用域：GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
OFF - 该变量控制是否启用废弃的 batch-dml 特性。启用该变量后，部分语句可能会被拆分为多个事务执行，这是非原子性的，使用时需谨慎。使用 batch-dml 时，必须确保正在操作的数据没有并发操作。要使该变量生效，还需要为
tidb_batch_dml_size指定一个正值，并启用tidb_batch_insert和tidb_batch_delete中的至少一个。
tidb_enable_change_multi_schema
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用于控制是否允许在一个
ALTER TABLE语句中变更多个列或者索引。该变量值为ON时，仅支持以下多模式对象变更：- 添加多列，例如
ALTER TABLE t ADD COLUMN c1 INT, ADD COLUMN c2 INT;。 - 删除多列，例如
ALTER TABLE t DROP COLUMN c1, DROP COLUMN c2;。 - 删除多个索引，例如
ALTER TABLE t DROP INDEX i1, DROP INDEX i2;。 - 删除被单列索引所覆盖的列，例如
ALTER TABLE t DROP COLUMN c1, 表结构中包含INDEX idx(c1)。
- 添加多列，例如
tidb_enable_cascades_planner
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用于控制是否开启 cascades planner。
tidb_enable_chunk_rpc 从 v4.0 版本开始引入
- 作用域：SESSION
- 默认值：
ON - 这个变量用来设置是否启用 Coprocessor 的
Chunk数据编码格式。
tidb_enable_clustered_index 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
INT_ONLY - 可选值：
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 实例
- 默认值：
ON - 这个变量用于控制是否同时将各个执行算子的执行信息记录入 slow query log 中。
tidb_enable_column_tracking 从 v5.4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用于控制是否开启 TiDB 对
PREDICATE COLUMNS的收集。关闭该变量后，之前收集的PREDICATE COLUMNS会被清除。详情见收集部分列的统计信息。
tidb_enable_enhanced_security
- 作用域：NONE
- 默认值：
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_restricted_read_only 从 v5.2.0 版本开始引入
作用域：GLOBAL
是否持久化到集群：是
默认值：
OFF可选值：
OFF和ONtidb_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 语句不会受影响，只对新执行的 SQL 语句进行是否只读的检查。
在变量开启时，对于尚未提交的事务：
- 如果有尚未提交的只读事务，可正常提交该事务。
- 如果尚未提交的事务为非只读事务，在事务内执行写入的 SQL 语句会被拒绝。
- 如果尚未提交的事务已经有数据改动，其提交也会被拒绝。
当集群开启只读模式后，所有用户（包括
SUPER用户）都无法执行可能写入数据的 SQL 语句，除非该用户被显式地授予了RESTRICTED_REPLICA_WRITER_ADMIN权限。
tidb_enable_exchange_partition
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
OFF - 该变量用于设置是否启用
exchange partitions with tables特性。默认值为OFF，即默认关闭该功能。
tidb_enable_fast_analyze
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用来控制是否启用统计信息快速分析功能。默认值 0 表示不开启。
- 快速分析功能开启后，TiDB 会随机采样约 10000 行的数据来构建统计信息。因此在数据分布不均匀或者数据量比较少的情况下，统计信息的准确度会比较低。这可能导致执行计划不优，比如选错索引。如果可以接受普通
ANALYZE语句的执行时间，则推荐关闭快速分析功能。
tidb_enable_historical_stats
- 作用域：GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
OFF - 该变量用于一个未发布的特性，请勿修改该变量值。
tidb_enable_index_merge 从 v4.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用于控制是否开启 index merge 功能。
tidb_enable_index_merge_join
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
OFF - 表示是否启用
IndexMergeJoin算子。 - 该变量为 TiDB 内部变量，不推荐使用，否则可能会造成数据正确性问题。
tidb_enable_legacy_instance_scope 从 v6.0.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用于允许使用
SET SESSION对INSTANCE作用域的变量进行设置，用法同SET GLOBAL。 - 为了兼容之前的 TiDB 版本，该变量值默认为
ON。
tidb_enable_list_partition 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用来设置是否开启
LIST (COLUMNS) TABLE PARTITION特性。
tidb_enable_local_txn
- 作用域：GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
OFF - 该变量用于一个未发布的特性，请勿修改该变量值。
tidb_enable_mutation_checker 从 v6.0.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用于设置是否开启 mutation checker。mutation checker 是一项在 DML 语句执行过程中进行的数据索引一致性校验，校验报错会回滚当前语句。开启该校验会导致 CPU 使用轻微上升。详见数据索引一致性报错。
- 对于新创建的 v6.0.0 及以上的集群，默认值为
ON。对于升级版本的集群，如果升级前是低于 v6.0.0 的版本，升级后默认值为OFF。
tidb_enable_new_only_full_group_by_check 从 v6.1.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 可选值：
OFF，ON - 该变量用于控制 TiDB 执行
ONLY_FULL_GROUP_BY检查时的行为。有关ONLY_FULL_GROUP_BY的信息可以参考 MySQL 文档。在 v6.1 中 TiDB 对该项检查做了更严格正确的处理。 - 由于可能存在版本升级造成的兼容性问题，在 v6.1 中该变量默认值是
OFF，即默认关闭。
tidb_enable_noop_functions 从 v4.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 默认情况下，用户尝试将某些语法用于尚未实现的功能时，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_outer_join_reorder 从 v6.1.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：在 v6.1.0 中为
ON，即默认开启；在从 v6.1.1 起的 6.1 补丁版本中为OFF，即默认关闭。 - 自 v6.1.0 起，TiDB 的 Join Reorder 算法 开始支持 Outer Join。该变量用于控制这个支持行为。默认关闭，即不启用 Outer Join 的 Join Reorder。
- 对于从较低版本升级到 v6.1.0 的 TiDB，升级后该变量的默认值为
ON。对于从较低版本升级到 v6.1.1 或之后的 6.1 补丁版本的 TiDB，升级后该变量的默认值为OFF。
tidb_enable_inl_join_inner_multi_pattern 从 v6.1.6 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
OFF - 该变量用于控制当内表上有
Selection/Projection算子时是否支持 Index Join。OFF表示不支持。
tidb_enable_ordered_result_mode
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
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
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用于控制
IndexLookUp算子是否使用分页 (paging) 方式发送 Coprocessor 请求。 - 适用场景：对于使用
IndexLookUp和Limit并且Limit无法下推到IndexScan上的读请求，可能会出现读请求的延迟高、TiKV 的 Unified read pool CPU 使用率高的情况。在这种情况下，由于Limit算子只需要少部分数据，开启tidb_enable_paging，能够减少处理数据的数量，从而降低延迟、减少资源消耗。 - 开启
tidb_enable_paging后，Limit无法下推且数量小于960的IndexLookUp请求会使用 paging 方式发送 Coprocessor 请求。Limit的值越小，优化效果会越明显。
tidb_enable_parallel_apply 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：0
- 这个变量用于控制是否开启 Apply 算子并发，并发数由
tidb_executor_concurrency变量控制。Apply 算子用来处理关联子查询且默认无并发，所以执行速度较慢。打开 Apply 并发开关可增加并发度，提高执行速度。目前默认关闭。
tidb_enable_pipelined_window_function
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
ON - 该变量指定是否对窗口函数采用流水线的执行算法。
tidb_enable_prepared_plan_cache 从 v6.1.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用来控制是否开启 Prepared Plan Cache。开启后，对
Prepare、Execute请求的执行计划会进行缓存，以便在后续执行时跳过查询计划优化这个步骤，获得性能上的提升。 - 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (
prepared-plan-cache.enabled) 进行配置，升级到 v6.1.0 时会自动继承原有设置。
tidb_enable_pseudo_for_outdated_stats 从 v5.3.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用来控制优化器在一张表上的统计信息过期时的行为。
- 统计信息过期的判断标准：最近一次对某张表执行
ANALYZE获得统计信息后，该表数据被修改的行数大于该表总行数的 80%，便可判定该表的统计信息已过期。该比例可通过pseudo-estimate-ratio配置参数调整。 - 默认情况下（即该变量值为
ON时），某张表上的统计信息过期后，优化器认为该表上除总行数以外的统计信息不再可靠，转而使用 pseudo 统计信息。将该变量值设为OFF后，即使统计信息过期，优化器也仍会使用该表上的统计信息。 - 如果表数据修改较频繁，没有及时对表执行
ANALYZE，但又希望执行计划保持稳定，可以将该变量值设为OFF。
tidb_enable_rate_limit_action
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量控制是否为读数据的算子开启动态内存控制功能。读数据的算子默认启用
tidb_distsql_scan_concurrency所允许的最大线程数来读取数据。当单条 SQL 语句的内存使用每超过tidb_mem_quota_query一次，读数据的算子会停止一个线程。 - 当读数据的算子只剩 1 个线程且当单条 SQL 语句的内存使用继续超过
tidb_mem_quota_query时，该 SQL 语句会触发其它的内存控制行为，例如落盘。
tidb_enable_slow_log
- 作用域：GLOBAL
- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
- 默认值：
ON - 这个变量用于控制是否开启 slow log 功能。
tidb_enable_stmt_summary 从 v3.0.4 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用来控制是否开启 statement summary 功能。如果开启，SQL 的耗时等执行信息将被记录到系统表
information_schema.STATEMENTS_SUMMARY中，用于定位和排查 SQL 性能问题。
tidb_enable_strict_double_type_check 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
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
- 是否持久化到集群：是
- 默认值：
ON - 可选值：
OFF，ON，AUTO - 这个变量用来设置是否开启
TABLE PARTITION特性。目前变量支持以下三种值：- 默认值
ON表示开启 TiDB 当前已实现了的分区表类型，目前 Range partition、Hash partition 以及 Range column 单列的场景会生效。 AUTO目前作用和ON一样。OFF表示关闭TABLE PARTITION特性，此时语法还是保持兼容，只是创建的表并不是真正的分区表，而是普通的表。
- 默认值
tidb_enable_telemetry 从 v4.0.2 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：对于 TiDB v6.1.0 ~ v6.1.4，默认值为
ON；对于 v6.1.5 以及之后的 v6.1.x 版本，默认值为OFF。 - 这个变量用于动态地控制 TiDB 遥测 功能是否开启。当所有 TiDB 实例都设置配置项
enable-telemetry为false时，将忽略该系统变量，并总是关闭 TiDB 遥测功能。参阅遥测了解该功能详情。
tidb_enable_top_sql 从 v5.4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用控制是否开启 Top SQL 特性。
tidb_enable_tso_follower_proxy 从 v5.3.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用来开启 TSO Follower Proxy 特性。当该值为
OFF时，TiDB 仅会从 PD leader 获取 TSO。开启该特性之后，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_vectorized_expression 从 v4.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用于控制是否开启向量化执行。
tidb_enable_window_function
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用来控制是否开启窗口函数的支持。默认值 1 代表开启窗口函数的功能。
- 由于窗口函数会使用一些保留关键字，可能导致原先可以正常执行的 SQL 语句在升级 TiDB 后无法被解析语法，此时可以将
tidb_enable_window_function设置为OFF。
tidb_enforce_mpp 从 v5.1 版本开始引入
- 作用域：SESSION
- 默认值：
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
是否持久化到集群：是
默认值：
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
- 是否持久化到集群：是
- 默认值：
23:59 +0000 - 这个变量用来设置一天中允许自动演进的结束时间。
tidb_evolve_plan_task_max_time 从 v4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
600 - 范围：
[-1, 9223372036854775807] - 单位：秒
- 该变量用于限制自动演进功能中，每个执行计划运行的最长时间。
tidb_evolve_plan_task_start_time 从 v4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
00:00 +0000 - 这个变量用来设置一天中允许自动演进的开始时间。
tidb_executor_concurrency 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
5 - 范围：
[1, 256] - 单位：线程
变量用来统一设置各个 SQL 算子的并发度，包括：
index lookupindex lookup joinhash joinhash aggregation（partial 和 final 阶段）windowprojection
tidb_executor_concurrency 整合了已有的系统变量，方便管理。这些变量所列如下：
tidb_index_lookup_concurrencytidb_index_lookup_join_concurrencytidb_hash_join_concurrencytidb_hashagg_partial_concurrencytidb_hashagg_final_concurrencytidb_projection_concurrencytidb_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 实例
- 默认值：
60 - 范围：
[10, 2147483647] - 单位：秒
- 这个变量用来控制打印 expensive query 日志的阈值时间，默认值是 60 秒。expensive query 日志和慢日志的差别是，慢日志是在语句执行完后才打印，expensive query 日志可以把正在执行中的语句且执行时间超过阈值的语句及其相关信息打印出来。
tidb_force_priority
- 作用域：GLOBAL
- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
- 默认值：
NO_PRIORITY - 这个变量用于改变 TiDB server 上执行的语句的默认优先级。例如，你可以通过设置该变量来确保正在执行 OLAP 查询的用户优先级低于正在执行 OLTP 查询的用户。
- 默认值
NO_PRIORITY表示不强制改变执行语句的优先级，其它优先级从低到高可设置为LOW_PRIORITY、DELAYED或HIGH_PRIORITY。
tidb_gc_concurrency 从 v5.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
-1 - 范围：
[1, 256] - 单位：线程
- 这个变量用于指定 GC 在Resolve Locks（清理锁）步骤中线程的数量。默认值
-1表示由 TiDB 自主判断运行 GC 要使用的线程的数量。
tidb_gc_enable 从 v5.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用于控制是否启用 TiKV 的垃圾回收 (GC) 机制。如果不启用 GC 机制，系统将不再清理旧版本的数据，因此会有损系统性能。
tidb_gc_life_time 从 v5.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
10m0s - 范围：
[10m0s, 8760h0m0s] - 这个变量用于指定每次进行垃圾回收 (GC) 时保留数据的时限。变量值为 Go 的 Duration 字符串格式。每次进行 GC 时，将以当前时间减去该变量的值作为 safe point。
tidb_gc_max_wait_time 从 v6.1.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
86400 - 范围：
[600, 31536000] - 单位：秒
- 这个变量用于指定活跃事务阻碍 GC safe point 推进的最大时间。每次进行 GC 时，默认 GC safe point 不会超过正在执行中的事务的开始时间。如果活跃事务运行时间未超过该值，GC safe point 会一直被阻塞不更新，直到活跃事务运行时间超过该值 safe point 才会正常推进。
tidb_gc_run_interval 从 v5.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
10m0s - 范围：
[10m0s, 8760h0m0s] - 这个变量用于指定垃圾回收 (GC) 运行的时间间隔。变量值为 Go 的 Duration 字符串格式，如
"1h30m"、"15m"等。
tidb_gc_scan_lock_mode 从 v5.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
LEGACY - 可设置为：
PHYSICAL，LEGACYLEGACY：使用旧的扫描方式，即禁用 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 实例
- 默认值：
OFF - 这个变量用来设置是否在日志里记录所有的 SQL 语句。该功能默认关闭。如果系统运维人员在定位问题过程中需要追踪所有 SQL 记录，可考虑开启该功能。
- 在 TiDB 配置项
log.level为"info"或"debug"时，通过查询"GENERAL_LOG"字符串可以定位到该功能在日志中的所有记录。日志会记录以下内容：conn：当前会话对应的 IDuser：当前会话用户schemaVersion：当前 schema 版本txnStartTS：当前事务的开始时间戳forUpdateTS：事务模式为悲观事务时，SQL 语句的当前时间戳。悲观事务内发生写冲突时，会重试当前执行语句，该时间戳会被更新。重试次数由max-retry-count配置。事务模式为乐观事务时，该条目与txnStartTS等价。isReadConsistency：当前事务隔离级别是否是读已提交 (RC)current_db：当前数据库名txn_mode：事务模式。可选值：OPTIMISTIC（乐观事务模式），或PESSIMISTIC（悲观事务模式）sql：当前查询对应的 SQL 语句
tidb_guarantee_linearizability 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
ON - 此变量控制异步提交 (Async Commit) 中提交时间戳的计算方式。默认情况下（使用
ON值），两阶段提交从 PD 服务器请求一个新的时间戳，并使用该时间戳计算最终提交的时间戳，这样可保证所有并发事务可线性化。 - 如果将该变量值设为
OFF，从 PD 获取时间戳的操作会被省掉，这种情况下只保证因果一致性但不保证线性一致性。详情请参考 PingCAP 博文 Async Commit 原理介绍。 - 对于需要只保证因果一致性的场景，可将此变量设为
OFF以提升性能。
tidb_hash_exchange_with_new_collation
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
ON - 该值表示是否在开启 new collation 的集群里生成 MPP hash partition exchange 算子。
true表示生成此算子，false表示不生成。 - 该变量为 TiDB 内部变量，不推荐设置该变量。
tidb_hash_join_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
-1 - 范围：
[1, 256] - 单位：线程
- 这个变量用来设置 hash join 算法的并发度。
- 默认值
-1表示使用tidb_executor_concurrency的值。
tidb_hashagg_final_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
-1 - 范围：
[1, 256] - 单位：线程
- 这个变量用来设置并行 hash aggregation 算法 final 阶段的执行并发度。对于聚合函数参数不为 distinct 的情况，HashAgg 分为 partial 和 final 阶段分别并行执行。
- 默认值
-1表示使用tidb_executor_concurrency的值。
tidb_hashagg_partial_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
-1 - 范围：
[1, 256] - 单位：线程
- 这个变量用来设置并行 hash aggregation 算法 partial 阶段的执行并发度。对于聚合函数参数不为 distinct 的情况，HashAgg 分为 partial 和 final 阶段分别并行执行。
- 默认值
-1表示使用tidb_executor_concurrency的值。
tidb_ignore_prepared_cache_close_stmt 从 v6.0.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用来设置是否忽略关闭 Prepared Statement 的指令。
- 如果变量值设为
ON，Binary 协议的COM_STMT_CLOSE信号和文本协议的DEALLOCATE PREPARE语句都会被忽略。
tidb_index_join_batch_size
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
25000 - 范围：
[1, 2147483647] - 单位：行
- 这个变量用来设置 index lookup join 操作的 batch 大小，AP 类应用适合较大的值，TP 类应用适合较小的值。
tidb_index_lookup_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
-1 - 范围：
[1, 256] - 单位：线程
- 这个变量用来设置 index lookup 操作的并发度，AP 类应用适合较大的值，TP 类应用适合较小的值。
- 默认值
-1表示使用tidb_executor_concurrency的值。
tidb_index_lookup_join_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
-1 - 范围：
[1, 256] - 单位：线程
- 这个变量用来设置 index lookup join 算法的并发度。
- 默认值
-1表示使用tidb_executor_concurrency的值。
tidb_index_lookup_size
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
20000 - 范围：
[1, 2147483647] - 单位：行
- 这个变量用来设置 index lookup 操作的 batch 大小，AP 类应用适合较大的值，TP 类应用适合较小的值。
tidb_index_serial_scan_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
1 - 范围：
[1, 256] - 单位：线程
- 这个变量用来设置顺序 scan 操作的并发度，AP 类应用适合较大的值，TP 类应用适合较小的值。
tidb_init_chunk_size
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
32 - 范围：
[1, 32] - 单位：行
- 这个变量用来设置执行过程中初始 chunk 的行数。默认值是 32，可设置的范围是 1～32。chunk 行数直接影响单个查询所需的内存。可以按照查询中所有的列的总宽度和 chunk 行数来粗略估算单个 chunk 所需内存，并结合执行器的并发数来粗略估算单个查询所需内存总量。建议单个 chunk 内存总量不要超过 16 MiB。
tidb_isolation_read_engines 从 v4.0 版本开始引入
- 作用域：SESSION
- 默认值：
tikv,tiflash,tidb - 这个变量用于设置 TiDB 在读取数据时可以使用的存储引擎列表。
tidb_last_ddl_info 从 v6.0.0 版本开始引入
- 作用域：SESSION
- 是否持久化到集群：否
- 默认值：""
- 类型：字符串
- 该变量为只读变量，TiDB 内部使用该变量获取当前会话中上一个 DDL 操作的信息。
- "query"：上一个 DDL 查询字符串。
- "seq_num"：每个 DDL 操作的序列号，用于标识 DDL 操作的顺序。
tidb_last_query_info 从 v4.0.14 版本开始引入
- 作用域：SESSION
- 默认值：""
- 这是一个只读变量。用于在 TiDB 内部查询上一条 DML 语句的事务信息。查询的事务信息包括：
txn_scope：事务的作用域，可能为global或local。start_ts：事务开始的时间戳。for_update_ts：先前执行的 DML 语句的for_update_ts信息。这是 TiDB 用于测试的内部术语。通常，你可以忽略此信息。error：错误消息（如果有）。
tidb_last_txn_info 从 v4.0.9 版本开始引入
- 作用域：SESSION
- 是否持久化到集群：否
- 类型：字符串
- 此变量用于获取当前会话中最后一个事务的信息。这是一个只读变量。事务信息包括：
- 事务的范围
- 开始时间戳和提交时间戳
- 事务的提交模式，可能是两阶段提交，一阶段提交，或者异步提交
- 事务从异步提交或一阶段提交到两阶段提交的回退信息
- 遇到的错误
tidb_log_file_max_days 从 v5.3.0 版本开始引入
- 作用域：SESSION
- 默认值：
0 - 范围：
[0, 2147483647] - 这个变量可以调整当前 TiDB 实例上日志的最大保留天数。默认值是实例配置文件中指定的值，见配置项
max-days。此变量只影响当前 TiDB 实例上的配置，重启后丢失，且配置文件不受影响。
tidb_low_resolution_tso
- 作用域：SESSION
- 默认值：
OFF - 这个变量用来设置是否启用低精度 TSO 特性。开启该功能之后，新事务会使用一个每 2s 更新一次的 TS 来读取数据。
- 主要场景是在可以容忍读到旧数据的情况下，降低小的只读事务获取 TSO 的开销。
tidb_nontransactional_ignore_error 从 v6.1.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用来设置是否在非事务语句中立刻返回错误。当设为
OFF时，在碰到第一个报错的 batch 时，非事务 DML 语句即中止，取消其后的所有 batch，返回错误。当设为ON时，当某个 batch 执行报错时，其后的 batch 会继续执行，直到所有 batch 执行完毕，返回结果时把这些错误合并后返回。
tidb_max_chunk_size
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
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
- 是否持久化到集群：是
- 默认值：
1024 - 范围：
[100, 16384] - 这个变量用来设置缓存 schema 版本信息（对应版本修改的相关 table IDs）的个数限制，可设置的范围 100 - 16384。此变量在 2.1.18 及之后版本支持。
tidb_mem_oom_action 从 v6.1.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
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
- 是否持久化到集群：是
- 默认值：
0 - 单位：字节
- 这个变量用来控制 TiDB 更新统计信息时的最大总内存占用，包括用户执行的
ANALYZE TABLE和 TiDB 后台自动执行的统计信息更新任务。当总的内存占用超过这个阈值时，用户执行的ANALYZE会被终止退出，并通过错误信息提示用户尝试更小的采样率或稍后重试。如果 TiDB 后台自动执行的统计信息更新任务因内存超限而退出，且使用的采样率高于默认值，则会使用默认采样率重试一次。当该变量值为负数或零时，TiDB 不对更新统计信息的前后台任务进行内存限制。
tidb_mem_quota_apply_cache 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
33554432(32 MiB) - 范围：
[0, 9223372036854775807] - 单位：字节
- 这个变量用来设置
Apply算子中局部 Cache 的内存使用阈值。 Apply算子中局部 Cache 用来加速Apply算子的计算，该变量可以设置ApplyCache 的内存使用阈值。设置变量值为0可以关闭ApplyCache 功能。
tidb_mem_quota_binding_cache 从 v6.0.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
67108864(64 MiB) - 范围：
[0, 2147483647] - 单位：字节
- 这个变量用来设置存放
binding的缓存的内存使用阈值。 - 如果一个系统创建或者捕获了过多的绑定，导致绑定所使用的内存空间超过该阈值，TiDB 会在日志中增加警告日志进行提示。这种情况下，缓存无法存放所有可用的绑定，并且无法保证哪些绑定存在于缓存中，因此，可能存在一些查询无法使用可用绑定的情况。此时，可以调大该变量的值，从而保证所有可用绑定都能正常使用。修改变量值以后，需要执行命令
admin reload bindings重新加载绑定，确保变更生效。
tidb_mem_quota_query
- 作用域：SESSION ｜ GLOBAL
- 是否持久化到集群：是
- 默认值：
1073741824(1 GiB) - 范围：
[-1, 9223372036854775807] - 单位：字节
- 这个变量用来设置一条查询语句的内存使用阈值。
- 如果一条查询语句执行过程中使用的内存空间超过该阈值，会触发系统变量
tidb_mem_oom_action中指定的行为。 - 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (
mem-quota-query) 进行配置，且作用域为SESSION。升级到 v6.1.0 时会自动继承原有设置，作用域变更为SESSION | GLOBAL。
tidb_memory_usage_alarm_ratio
- 作用域：GLOBAL
- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
- 默认值：
0.8 - TiDB 内存使用占总内存的比例超过一定阈值时会报警。该功能的详细介绍和使用方法可以参考
memory-usage-alarm-ratio。 - 该变量的初始值可通过
memory-usage-alarm-ratio进行配置。
tidb_merge_join_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
1 - 设置
MergeJoin算子执行查询时的并发度。 - 不推荐设置该变量，修改该变量值可能会造成数据正确性问题。
tidb_metric_query_range_duration 从 v4.0 版本开始引入
- 作用域：SESSION
- 默认值：
60 - 范围：
[10, 216000] - 单位：秒
- 这个变量设置了查询
METRIC_SCHEMA时生成的 Prometheus 语句的 range duration。
tidb_metric_query_step 从 v4.0 版本开始引入
- 作用域：SESSION
- 默认值：
60 - 范围：
[10, 216000] - 单位：秒
- 这个变量设置了查询
METRIC_SCHEMA时生成的 Prometheus 语句的 step。
tidb_multi_statement_mode 从 v4.0.11 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 可选值：
OFF，ON，WARN - 该变量用于控制是否在同一个
COM_QUERY调用中执行多个查询。 - 为了减少 SQL 注入攻击的影响，TiDB 目前默认不允许在同一
COM_QUERY调用中执行多个查询。该变量可用作早期 TiDB 版本的升级路径选项。该变量值与是否允许多语句行为的对照表如下：
| 客户端设置 | tidb_multi_statement_mode 值 | 是否允许多语句 |
|---|---|---|
| Multiple Statements = ON | OFF | 允许 |
| Multiple Statements = ON | ON | 允许 |
| Multiple Statements = ON | WARN | 允许 |
| Multiple Statements = OFF | OFF | 不允许 |
| Multiple Statements = OFF | ON | 允许 |
| Multiple Statements = OFF | WARN | 允许 + 警告提示 |
- go-sql-driver (
multiStatements)- Connector/J (
allowMultiQueries)- PHP mysqli (
mysqli_multi_query)
tidb_enable_new_cost_interface
该变量与自 v6.2.0 起可用的功能相关，但在 v6.1 中不可用。详情参阅 v6.2 文档 tidb_enable_new_cost_interface。
tidb_opt_agg_push_down
- 作用域：SESSION
- 默认值：
OFF - 这个变量用来设置优化器是否执行聚合函数下推到 Join，Projection 和 UnionAll 之前的优化操作。当查询中聚合操作执行很慢时，可以尝试设置该变量为 ON。
tidb_opt_broadcast_cartesian_join
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：整数
- 默认值：
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
- 是否持久化到集群：是
- 类型：浮点数
- 范围：
[0, 2147483647] - 默认值：
3.0 - 表示在 TiDB 中开启一个 Golang goroutine 的 CPU 开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。
tidb_opt_copcpu_factor
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：浮点数
- 范围：
[0, 2147483647] - 默认值：
3.0 - 表示 TiKV 协处理器处理一行数据的 CPU 开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。
tidb_opt_correlation_exp_factor
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
1 - 范围：
[0, 2147483647] - 当交叉估算方法不可用时，会采用启发式估算方法。这个变量用来控制启发式方法的行为。当值为 0 时不用启发式估算方法，大于 0 时，该变量值越大，启发式估算方法越倾向 index scan，越小越倾向 table scan。
tidb_opt_correlation_threshold
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
0.9 - 这个变量用来设置优化器启用交叉估算 row count 方法的阈值。如果列和 handle 列之间的顺序相关性超过这个阈值，就会启用交叉估算方法。
- 交叉估算方法可以简单理解为，利用这个列的直方图来估算 handle 列需要扫的行数。
tidb_opt_cpu_factor
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：浮点数
- 范围：
[0, 2147483647] - 默认值：
3.0 - 表示 TiDB 处理一行数据的 CPU 开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。
tidb_opt_desc_factor
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：浮点数
- 范围：
[0, 2147483647] - 默认值：
3.0 - 表示降序扫描时，TiKV 在磁盘上扫描一行数据的开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。
tidb_opt_disk_factor
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：浮点数
- 范围：
[0, 2147483647] - 默认值：
1.5 - 表示 TiDB 往临时磁盘读写一个字节数据的 I/O 开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。
tidb_opt_distinct_agg_push_down
- 作用域：SESSION
- 默认值：
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
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用来控制优化器是否开启交叉估算。
tidb_opt_insubq_to_join_and_agg
作用域：SESSION | GLOBAL
是否持久化到集群：是
默认值：
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
- 是否持久化到集群：是
- 默认值：
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
- 是否持久化到集群：是
- 默认值：
100 - 范围：
[0, 2147483647] - 这个变量用来设置将 Limit 和 TopN 算子下推到 TiKV 的阈值。
- 如果 Limit 或者 TopN 的取值小于等于这个阈值，则 Limit 和 TopN 算子会被强制下推到 TiKV。该变量可以解决部分由于估算误差导致 Limit 或者 TopN 无法被下推的问题。
tidb_opt_memory_factor
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：浮点数
- 范围：
[0, 2147483647] - 默认值：
0.001 - 表示 TiDB 存储一行数据的内存开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。
tidb_opt_mpp_outer_join_fixed_build_side 从 v5.1.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值：
OFF - 当该变量值为
ON时，左连接始终使用内表作为构建端，右连接始终使用外表作为构建端。将该变量值设为OFF后，外连接可以灵活选择任意一边表作为构建端。
tidb_opt_network_factor
- 作用域：SESSION | GLOBAL
- 是否持久化
- 类型：浮点数
- 范围：
[0, 2147483647] - 默认值：
1.0 - 表示传输 1 比特数据的网络净开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。
tidb_opt_prefer_range_scan 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 将该变量值设为
ON后，优化器总是偏好区间扫描而不是全表扫描。 - 在以下示例中，
tidb_opt_prefer_range_scan开启前，TiDB 优化器需要执行全表扫描。tidb_opt_prefer_range_scan开启后，优化器选择了索引区间扫描。
explain select * from t where age=5;
+-------------------------+------------+-----------+---------------+-------------------+
| id | estRows | task | access object | operator info |
+-------------------------+------------+-----------+---------------+-------------------+
| TableReader_7 | 1048576.00 | root | | data:Selection_6 |
| └─Selection_6 | 1048576.00 | cop[tikv] | | eq(test.t.age, 5) |
| └─TableFullScan_5 | 1048576.00 | cop[tikv] | table:t | keep order:false |
+-------------------------+------------+-----------+---------------+-------------------+
3 rows in set (0.00 sec)
set session tidb_opt_prefer_range_scan = 1;
explain select * from t where age=5;
+-------------------------------+------------+-----------+-----------------------------+-------------------------------+
| id | estRows | task | access object | operator info |
+-------------------------------+------------+-----------+-----------------------------+-------------------------------+
| IndexLookUp_7 | 1048576.00 | root | | |
| ├─IndexRangeScan_5(Build) | 1048576.00 | cop[tikv] | table:t, index:idx_age(age) | range:[5,5], keep order:false |
| └─TableRowIDScan_6(Probe) | 1048576.00 | cop[tikv] | table:t | keep order:false |
+-------------------------------+------------+-----------+-----------------------------+-------------------------------+
3 rows in set (0.00 sec)
tidb_opt_projection_push_down 从 v6.1.0 版本开始引入
- 作用域：SESSION
- 是否持久化到集群：否
- 类型：布尔值
- 默认值：
OFF - 指定是否允许优化器将
Projection算子下推到 TiKV 或者 TiFlash。
tidb_opt_scan_factor
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：浮点数
- 范围：
[0, 2147483647] - 默认值：
1.5 - 表示升序扫描时，TiKV 在磁盘上扫描一行数据的开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。
tidb_opt_seek_factor
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：浮点数
- 范围：
[0, 2147483647] - 默认值：
20 - 表示 TiDB 从 TiKV 请求数据的初始开销。该变量是代价模型内部使用的变量，不建议修改该变量的值。
tidb_opt_tiflash_concurrency_factor
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：浮点数
- 范围：
[0, 2147483647] - 默认值：
24.0 - 表示 TiFlash 计算的并发数。该变量是代价模型内部使用的变量，不建议修改该变量的值。
tidb_opt_write_row_id
- 作用域：SESSION
- 默认值：
OFF - 这个变量用来设置是否允许
INSERT、REPLACE和UPDATE操作_tidb_rowid列，默认是不允许操作。该选项仅用于 TiDB 工具导数据时使用。
tidb_partition_prune_mode 从 v5.1 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：static
- 这个变量用来设置是否开启分区表动态裁剪模式。关于动态裁剪模式的详细说明请参阅分区表动态裁剪模式。
tidb_persist_analyze_options 从 v5.4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用于控制是否开启 ANALYZE 配置持久化特性。
tidb_placement_mode 从 v6.0.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
STRICT - 可选值：
STRICT，IGNORE - 该变量用于控制 DDL 语句是否忽略 Placement Rules in SQL 指定的放置规则。变量值为
IGNORE时将忽略所有放置规则选项。 - 该变量可由逻辑转储或逻辑恢复工具使用，确保即使绑定了不合适的放置规则，也始终可以成功创建表。这类似于 mysqldump 将
SET FOREIGN_KEY_CHECKS=0;写入每个转储文件的开头部分。
tidb_pprof_sql_cpu 从 v4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
- 默认值：
0 - 范围：
[0, 1] - 这个变量用来控制是否在 profile 输出中标记出对应的 SQL 语句，用于定位和排查性能问题。
tidb_prepared_plan_cache_memory_guard_ratio 从 v6.1.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
0.1 - 范围：
[0, 1] - 这个变量用来控制 Prepared Plan Cache 触发内存保护机制的阈值，具体可见 Prepared Plan Cache 的内存管理。
- 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (
prepared-plan-cache.memory-guard-ratio) 进行配置，升级到 v6.1.0 时会自动继承原有设置。
tidb_prepared_plan_cache_size 从 v6.1.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
100 - 范围：
[1, 100000] - 这个变量用来控制单个
SESSION的 Prepared Plan Cache 最多能够缓存的计划数量，具体可见 Prepared Plan Cache 的内存管理。 - 在 v6.1.0 之前这个开关通过 TiDB 配置文件 (
prepared-plan-cache.capacity) 进行配置，升级到 v6.1.0 时会自动继承原有设置。
tidb_projection_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
-1 - 范围：
[-1, 256] - 单位：线程
- 这个变量用来设置
Projection算子的并发度。 - 默认值
-1表示使用tidb_executor_concurrency的值。
tidb_query_log_max_len
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
4096(4 KiB) - 范围：
[0, 1073741824] - 单位：字节
- 该变量控制 SQL 语句输出的最大长度。当一条 SQL 语句的输出长度大于
tidb_query_log_max_len时，输出将会被截断。 - 在 v6.1.0 之前这个开关也可以通过 TiDB 配置文件 (
log.query-log-max-len) 进行配置，升级到 v6.1.0 后仅可通过系统变量配置。
tidb_rc_read_check_ts 从 v6.0.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 该变量用于优化时间戳的获取，适用于悲观事务
READ-COMMITTED隔离级别下读写冲突较少的场景，开启此变量可以避免获取全局 timestamp 带来的延迟和开销，并优化事务内读语句延迟。 - 如果读写冲突较为严重，开启此功能会增加额外开销和延迟，造成性能回退。更详细的说明，请参考读已提交隔离级别 (Read Committed) 文档。
tidb_read_consistency 从 v5.4.0 版本开始引入
- 作用域：SESSION
- 是否持久化到集群：否
- 类型：字符串
- 默认值：
strict - 此变量用于控制自动提交的读语句的读一致性。
- 如果将变量值设置为
weak，则直接跳过读语句遇到的锁，读的执行可能会更快，这就是弱一致性读模式。但在该模式下，事务语义（例如原子性）和分布式一致性（线性一致性）并不能得到保证。 - 如果用户场景中需要快速返回自动提交的读语句，并且可接受弱一致性的读取结果，则可以使用弱一致性读取模式。
tidb_read_staleness 从 v5.4.0 版本开始引入
- 作用域：SESSION
- 默认值：
0 - 范围
[-2147483648, 0] - 这个变量用于设置当前会话允许读取的历史数据范围。设置后，TiDB 会从参数允许的范围内选出一个尽可能新的时间戳，并影响后继的所有读操作。比如，如果该变量的值设置为
-5，TiDB 会在 5 秒时间范围内，保证 TiKV 拥有对应历史版本数据的情况下，选择尽可能新的一个时间戳。
tidb_record_plan_in_slow_log
- 作用域：GLOBAL
- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
- 默认值：
ON - 这个变量用于控制是否在 slow log 里包含慢查询的执行计划。
tidb_redact_log
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用于控制在记录 TiDB 日志和慢日志时，是否将 SQL 中的用户信息遮蔽。
- 将该变量设置为
1即开启后，假设执行的 SQL 为insert into t values (1,2)，在日志中记录的 SQL 会是insert into t values (?,?)，即用户输入的信息被遮蔽。
tidb_regard_null_as_point 从 v5.4.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用来控制优化器是否可以将包含 null 的等值条件作为前缀条件来访问索引。
- 该变量默认开启。开启后，该变量可以使优化器减少需要访问的索引数据量，从而提高查询的执行速度。例如，在有多列索引
index(a, b)且查询条件为a<=>null and b=1的情况下，优化器可以同时使用查询条件中的a<=>null和b=1进行索引访问。如果关闭该变量，因为a<=>null and b=1包含 null 的等值条件，优化器不会使用b=1进行索引访问。
tidb_remove_orderby_in_subquery 从 v6.1.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：布尔值
- 默认值：
OFF - 指定是否在子查询中移除
ORDER BY子句。
tidb_replica_read 从 v4.0 版本开始引入
作用域：SESSION | GLOBAL
是否持久化到集群：是
默认值：
leader可选值：
leader，follower，leader-and-follower这个变量用于控制 TiDB 读取数据的位置，有以下三个选择：
- leader：只从 leader 节点读取
- follower：只从 follower 节点读取
- leader-and-follower：从 leader 或 follower 节点读取
更多细节，见 Follower Read。
tidb_retry_limit
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
10 - 范围：
[-1, 9223372036854775807] - 这个变量用来设置乐观事务的最大重试次数。一个事务执行中遇到可重试的错误（例如事务冲突、事务提交过慢或表结构变更）时，会根据该变量的设置进行重试。注意当
tidb_retry_limit = 0时，也会禁用自动重试。该变量仅适用于乐观事务，不适用于悲观事务。
tidb_row_format_version
作用域：GLOBAL
是否持久化到集群：是
默认值：
2范围：
[1, 2]控制新保存数据的表数据格式版本。TiDB v4.0 中默认使用版本号为 2 的新表数据格式保存新数据。
但如果从 4.0.0 之前的版本升级到 4.0.0，不会改变表数据格式版本，TiDB 会继续使用版本为 1 的旧格式写入表中，即只有新创建的集群才会默认使用新表数据格式。
需要注意的是修改该变量不会对已保存的老数据产生影响，只会对修改变量后的新写入数据使用对应版本格式保存。
tidb_scatter_region
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - TiDB 默认会在建表时为新表分裂 Region。开启该变量后，会在建表语句执行时，同步打散刚分裂出的 Region。适用于批量建表后紧接着批量写入数据，能让刚分裂出的 Region 先在 TiKV 分散而不用等待 PD 进行调度。为了保证后续批量写入数据的稳定性，建表语句会等待打散 Region 完成后再返回建表成功，建表语句执行时间会是该变量关闭时的数倍。
- 如果建表时设置了
SHARD_ROW_ID_BITS和PRE_SPLIT_REGIONS，建表成功后会均匀切分出指定数量的 Region。
tidb_shard_allocate_step 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
9223372036854775807 - 范围：
[1, 9223372036854775807] - 该变量设置为
AUTO_RANDOM或SHARD_ROW_ID_BITS属性列分配的最大连续 ID 数。通常，AUTO_RANDOMID 或带有SHARD_ROW_ID_BITS属性的行 ID 在一个事务中是增量和连续的。你可以使用该变量来解决大事务场景下的热点问题。
tidb_skip_ascii_check 从 v5.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用来设置是否校验 ASCII 字符的合法性。
- 校验 ASCII 字符会损耗些许性能。当你确认输入的字符串为有效的 ASCII 字符时，可以将其设置为
ON。
tidb_skip_isolation_level_check
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 开启这个开关之后，如果对
tx_isolation赋值一个 TiDB 不支持的隔离级别，不会报错，有助于兼容其他设置了（但不依赖于）不同隔离级别的应用。
tidb> set tx_isolation='serializable';
ERROR 8048 (HY000): The isolation level 'serializable' is not supported. Set tidb_skip_isolation_level_check=1 to skip this error
tidb> set tidb_skip_isolation_level_check=1;
Query OK, 0 rows affected (0.00 sec)
tidb> set tx_isolation='serializable';
Query OK, 0 rows affected, 1 warning (0.00 sec)
tidb_skip_utf8_check
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用来设置是否校验 UTF-8 字符的合法性。
- 校验 UTF-8 字符会损耗些许性能。当你确认输入的字符串为有效的 UTF-8 字符时，可以将其设置为
ON。
tidb_slow_log_threshold
- 作用域：GLOBAL
- 是否持久化到集群：否，仅作用于当前连接的 TiDB 实例
- 默认值：
300 - 范围：
[-1, 9223372036854775807] - 单位：毫秒
- 输出慢日志的耗时阈值，默认为 300 ms。如果查询耗时大于这个值，会视作一个慢查询，并记录到慢查询日志。注意，当日志的输出级别
log.level是"debug"时，所有查询都会记录到慢日志，不受该变量的限制。
tidb_max_tiflash_threads 从 v6.1.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：整数型
- 默认值：
-1 - 范围：
[-1, 256] - 单位：线程
- TiFlash 中 request 执行的最大并发度。默认值为
-1，表示该系统变量无效，此时最大并发度取决于 TiFlash 配置项profiles.default.max_threads的设置。0表示由 TiFlash 系统自动设置该值。
tidb_mpp_store_fail_ttl
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 类型：Duration
- 默认值：
60s - 刚重启的 TiFlash 可能不能正常提供服务。为了防止查询失败，TiDB 会限制 tidb-server 向刚重启的 TiFlash 节点发送查询。这个变量表示刚重启的 TiFlash 不被发送请求的时间范围。
tidb_slow_query_file
- 作用域：SESSION
- 默认值：""
- 查询
INFORMATION_SCHEMA.SLOW_QUERY只会解析配置文件中slow-query-file设置的慢日志文件名，默认是 "tidb-slow.log"。但如果想要解析其他的日志文件，可以通过设置 session 变量tidb_slow_query_file为具体的文件路径，然后查询INFORMATION_SCHEMA.SLOW_QUERY就会按照设置的路径去解析慢日志文件。更多详情可以参考 SLOW_QUERY 文档。
tidb_snapshot
- 作用域：SESSION
- 默认值：""
- 这个变量用来设置当前会话期待读取的历史数据所处时刻。比如当设置为
"2017-11-11 20:20:20"时或者一个 TSO 数字 "400036290571534337"，当前会话将能读取到该时刻的数据。
tidb_stats_cache_mem_quota 从 v6.1.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
0 - 这个变量用于控制 TiDB 内部统计信息缓存使用内存的上限。
tidb_stats_load_sync_wait 从 v5.4.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
0 - 单位：毫秒
- 范围：
[0, 2147483647] - 这个变量用于控制是否开启统计信息的同步加载模式（默认为
0代表不开启，即为异步加载模式），以及开启的情况下，SQL 执行同步加载完整统计信息等待多久后会超时。更多信息，请参考统计信息的加载。
tidb_stats_load_pseudo_timeout 从 v5.4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用于控制统计信息同步加载超时后，SQL 是执行失败（
OFF），还是退回使用 pseudo 的统计信息（ON）。
tidb_stmt_summary_history_size 从 v4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
24 - 范围：
[0, 255] - 这个变量设置了 statement summary tables 的历史记录容量。
tidb_stmt_summary_internal_query 从 v4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用来控制是否在 statement summary tables 中包含 TiDB 内部 SQL 的信息。
tidb_stmt_summary_max_sql_length 从 v4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
4096 - 范围：
[0, 2147483647] - 这个变量控制 statement summary tables 显示的 SQL 字符串长度。
tidb_stmt_summary_max_stmt_count 从 v4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
3000 - 范围：
[1, 32767] - 这个变量设置了 statement summary tables 在内存中保存的语句的最大数量。
tidb_stmt_summary_refresh_interval 从 v4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
1800 - 范围：
[1, 2147483647] - 单位：秒
- 这个变量设置了 statement summary tables 的刷新时间。
tidb_streamagg_concurrency
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
1 - 设置
StreamAgg算子执行查询时的并发度。 - 不推荐设置该变量，修改该变量值可能会造成数据正确性问题。
tidb_top_sql_max_meta_count 从 v6.0.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
5000 - 范围：
[1, 10000] - 这个变量用于控制 Top SQL 每分钟最多收集 SQL 语句类型的数量。
tidb_top_sql_max_time_series_count 从 v6.0.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
100 - 范围：
[1, 5000] - 这个变量用于控制 Top SQL 每分钟保留消耗负载最大的前多少条 SQL（即 Top N) 的数据。
tidb_store_limit 从 v3.0.4 和 v4.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
0 - 范围：
[0, 9223372036854775807] - 这个变量用于限制 TiDB 同时向 TiKV 发送的请求的最大数量，0 表示没有限制。
tidb_super_read_only 从 v5.3.1 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 类型：布尔型
- 默认值:
OFF tidb_super_read_only用于实现对 MySQL 变量super_read_only的替代。然而，由于 TiDB 是一个分布式数据库，开启tidb_super_read_only后数据库各个 TiDB 服务器进入只读模式的时刻不是强一致的，而是最终一致的。- 拥有
SUPER或SYSTEM_VARIABLES_ADMIN权限的用户可以修改该变量。 - 该变量可以控制整个集群的只读状态。开启后（即该值为
ON），整个集群中的 TiDB 服务器都将进入只读状态，只有SELECT、USE、SHOW等不会修改数据的语句才能被执行，其他如INSERT、UPDATE等语句会被拒绝执行。 - 该变量开启只读模式只保证整个集群最终进入只读模式，当变量修改状态还没被同步到其他 TiDB 服务器时，尚未同步的 TiDB 仍然停留在非只读模式。
- 在变量开启时，正在执行的 SQL 语句不会受影响，只对新执行的 SQL 语句进行是否只读的检查。
- 在变量开启时，对于尚未提交的事务：
- 如果有尚未提交的只读事务，可正常提交该事务。
- 如果尚未提交的事务为非只读事务，在事务内执行写入的 SQL 语句会被拒绝。
- 如果尚未提交的事务已经有数据改动，其提交也会被拒绝。
- 当集群开启只读模式后，所有用户（包括
SUPER用户）都无法执行可能写入数据的 SQL 语句，除非该用户被显式地授予了RESTRICTED_REPLICA_WRITER_ADMIN权限。 - 当系统变量
tidb_restricted_read_only为ON时，tidb_super_read_only的值会受到tidb_restricted_read_only的影响。详情请参见tidb_restricted_read_only中的描述。
tidb_sysdate_is_now 从 v6.0.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
OFF - 这个变量用于控制
SYSDATE函数能否替换为NOW函数，其效果与 MYSQL 中的sysdate-is-now一致。
tidb_table_cache_lease 从 v6.0.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
3 - 范围：
[1, 10] - 单位：秒
- 这个变量用来控制缓存表的 lease 时间，默认值是 3 秒。该变量值的大小会影响缓存表的修改。在缓存表上执行修改操作后，最长可能出现
tidb_table_cache_lease变量值时长的等待。如果业务表为只读表，或者能接受很高的写入延迟，则可以将该变量值调大，从而增加缓存的有效时间，减少 lease 续租的频率。
tidb_tmp_table_max_size 从 v5.3 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
67108864 - 范围：
[1048576, 137438953472] - 单位：字节
- 这个变量用于限制单个临时表的最大大小，临时表超出该大小后报错。
tidb_track_aggregate_memory_usage
- 作用域：SESSION ｜ GLOBAL
- 是否持久化到集群：是
- 类型：布尔值
- 默认值：
ON - 本变量控制 TiDB 是否跟踪聚合函数的内存使用情况。
tidb_tso_client_batch_max_wait_time 从 v5.3.0 版本开始引入
- 作用域：GLOBAL
- 是否持久化到集群：是
- 默认值：
0 - 范围：
[0, 10] - 单位：毫秒
- 这个变量用来设置 TiDB 向 PD 请求 TSO 时进行一次攒批操作的最大等待时长。默认值为
0，即不进行额外的等待。 - 在向 PD 获取 TSO 请求时，TiDB 使用的 PD Client 会一次尽可能多地收集同一时刻的 TSO 请求，将其攒批合并成一个 RPC 请求后再发送给 PD，从而减轻 PD 的压力。
- 将这个变量值设置为非 0 后，TiDB 会在每一次攒批结束前进行一个最大时长为其值的等待，目的是为了收集到更多的 TSO 请求，从而提高攒批效果。
- 适合调高这个变量值的场景：
- PD leader 因高压力的 TSO 请求而达到 CPU 瓶颈，导致 TSO RPC 请求的延迟较高。
- 集群中 TiDB 实例的数量不多，但每一台 TiDB 实例上的并发量较高。
- 在实际使用中，推荐将该变量尽可能设置为一个较小的值。
tidb_txn_assertion_level 从 v6.0.0 版本开始引入
作用域：SESSION | GLOBAL
是否持久化到集群：是
默认值：
FAST可选值：
OFF，FAST，STRICT这个变量用于设置 assertion 级别。assertion 是一项在事务提交过程中进行的数据索引一致性校验，它对正在写入的 key 是否存在进行检查。如果不符则说明数据索引不一致，会导致事务 abort。详见数据索引一致性报错。
对于新创建的 v6.0.0 及以上的集群，默认值为
FAST。对于升级版本的集群，如果升级前是低于 v6.0.0 的版本，升级后默认值为OFF。OFF: 关闭该检查。FAST: 开启大多数检查项，对性能几乎无影响。STRICT: 开启全部检查项，当系统负载较高时，对悲观事务的性能有较小影响。
tidb_txn_mode
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
pessimistic - 可选值：
pessimistic，optimistic - 这个变量用于设置事务模式。TiDB v3.0 支持了悲观事务，自 v3.0.8 开始，默认使用悲观事务模式。
- 但如果从 3.0.7 及之前的版本升级到 >= 3.0.8 的版本，不会改变默认事务模式，即只有新创建的集群才会默认使用悲观事务模式。
- 将该变量设置为 "optimistic" 或 "" 时，将会使用乐观事务模式。
tidb_use_plan_baselines 从 v4.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用于控制是否开启执行计划绑定功能，默认打开，可通过赋值
OFF来关闭。关于执行计划绑定功能的使用可以参考执行计划绑定文档。
tidb_wait_split_region_finish
- 作用域：SESSION
- 默认值：
ON - 由于打散 Region 的时间可能比较长，主要由 PD 调度以及 TiKV 的负载情况所决定。这个变量用来设置在执行
SPLIT REGION语句时，是否同步等待所有 Region 都打散完成后再返回结果给客户端。- 默认
ON代表等待打散完成后再返回结果 OFF代表不等待 Region 打散完成就返回。
- 默认
- 需要注意的是，在 Region 打散期间，对正在打散 Region 上的写入和读取的性能会有一定影响，对于批量写入、导数据等场景，还是建议等待 Region 打散完成后再开始导数据。
tidb_wait_split_region_timeout
- 作用域：SESSION
- 默认值：
300 - 范围：
[1, 2147483647] - 单位：秒
- 这个变量用来设置
SPLIT REGION语句的执行超时时间，默认值是 300 秒，如果超时还未完成，就返回一个超时错误。
tidb_window_concurrency 从 v4.0 版本开始引入
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
-1 - 范围：
[1, 256] - 单位：线程
- 这个变量用于设置 window 算子的并行度。
- 默认值
-1表示使用tidb_executor_concurrency的值。
time_zone
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
SYSTEM - 数据库所使用的时区。这个变量值可以写成时区偏移的形式，如 '-8:00'，也可以写成一个命名时区，如 'America/Los_Angeles'。
- 默认值
SYSTEM表示时区应当与系统主机的时区相同。系统的时区可通过system_time_zone获取。
timestamp
- 作用域：SESSION
- 类型：浮点数
- 默认值：
0 - 取值范围：
[0, 2147483647] - 一个 Unix 时间戳。变量值非空时，表示
CURRENT_TIMESTAMP()、NOW()等函数的时间戳。该变量通常用于数据恢复或数据复制。
transaction_isolation
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
REPEATABLE-READ - 可选值：
READ-UNCOMMITTED，READ-COMMITTED，REPEATABLE-READ，SERIALIZABLE - 这个变量用于设置事务隔离级别。TiDB 为了兼容 MySQL，支持可重复读 (
REPEATABLE-READ)，但实际的隔离级别是快照隔离。详情见事务隔离级别。
tx_isolation
这个变量是 transaction_isolation 的别名。
tx_isolation_one_shot
在 TiDB 内部实现中，TiDB 解释器会将 SET TRANSACTION ISOLATION LEVEL [READ COMMITTED| REPEATABLE READ | ...] 语句转化为 SET @@SESSION.TX_ISOLATION_ONE_SHOT = [READ COMMITTED| REPEATABLE READ | ...]。
tx_read_ts
- 作用域：SESSION
- 是否持续化到集群：否
- 默认值：
0 - 在 Stale Read 场景下，该会话变量用于帮助记录 Stable Read TS 值。
- 该变量仅用于 TiDB 内部实现，不推荐设置该变量。
txn_scope
- 作用域：SESSION
- 是否持续化到集群：否
- 默认值：
global - 可选值：
global和local - 该变量用于设置当前会话下事务为全局事务（设为
global）还是局部事务（设为local）。 - 该变量仅用于 TiDB 内部实现，不推荐设置该变量。
version
- 作用域：NONE
- 默认值：
5.7.25-TiDB-(tidb version) - 这个变量的值是 MySQL 的版本和 TiDB 的版本，例如 '5.7.25-TiDB-v4.0.0-beta.2-716-g25e003253'。
version_comment
- 作用域：NONE
- 默认值：(string)
- 这个变量的值是 TiDB 版本号的其他信息，例如 'TiDB Server (Apache License 2.0) Community Edition, MySQL 5.7 compatible'。
version_compile_os
- 作用域：NONE
- 默认值：(string)
- 这个变量值是 TiDB 所在操作系统的名称。
version_compile_machine
- 作用域：NONE
- 默认值：(string)
- 这个变量值是运行 TiDB 的 CPU 架构的名称。
wait_timeout
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
28800 - 范围：
[0, 31536000] - 单位：秒
- 这个变量表示用户会话的空闲超时。
0代表没有时间限制。
warning_count
- 作用域：SESSION
- 默认值：
0 - 这个只读变量表示之前执行语句中出现的警告数。
windowing_use_high_precision
- 作用域：SESSION | GLOBAL
- 是否持久化到集群：是
- 默认值：
ON - 这个变量用于控制计算窗口函数时是否采用高精度模式。