title

TiDB 专用系统变量和语法

TiDB 在 MySQL 的基础上，定义了一些专用的系统变量和语法用来优化性能。

系统变量

变量可以通过 SET 语句设置，例如

set @@tidb_distsql_scan_concurrency = 10;

如果需要设置全局变量，执行

set @@global.tidb_distsql_scan_concurrency = 10;

tidb_snapshot

作用域：SESSION

默认值：空字符串

这个变量用来设置当前会话期待读取的历史数据所处时刻。比如当设置为 "2017-11-11 20:20:20" 时或者一个 TSO 数字 "400036290571534337"，当前会话将能读取到该时刻的数据。

tidb_opt_agg_push_down

作用域：SESSION

默认值：0

这个变量用来设置优化器是否执行聚合函数下推到 Join 之前的优化操作。当查询中聚合操作执行很慢时，可以尝试设置该变量为 1。

tidb_opt_distinct_agg_push_down

作用域：SESSION

默认值：0

这个变量用来设置优化器是否执行带有 Distinct 的聚合函数（比如 select count(distinct a) from t）下推到 Coprocessor 的优化操作。当查询中带有 Distinct 的聚合操作执行很慢时，可以尝试设置该变量为 1。

在以下示例中，tidb_opt_distinct_agg_push_down 开启前，TiDB 需要从 TiKV 读取所有数据，并在 TiDB 侧执行 disctinct。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_auto_analyze_ratio

作用域：GLOBAL

默认值：0.5

这个变量用来设置自动 ANALYZE 更新的阈值。当某个表 tbl 的修改行数与总行数的比值大于 tidb_auto_analyze_ratio，并且当前时间在 tidb_auto_analyze_start_time 和 tidb_auto_analyze_end_time 之间时，TiDB 会在后台执行 ANALYZE TABLE tbl 语句以自动更新该表的统计信息。注意：只有在 TiDB 的启动配置文件中开启了 run-auto-analyze 选项，该 TiDB 才会触发 auto_analyze。

tidb_auto_analyze_start_time

作用域：GLOBAL

默认值：00:00 +0000

这个变量用来设置一天中允许自动 ANALYZE 更新的开始时间。

tidb_auto_analyze_end_time

作用域：GLOBAL

默认值：23:59 +0000

这个变量用来设置一天中允许自动 ANALYZE 更新的结束时间。

tidb_build_stats_concurrency

作用域：SESSION

默认值：4

这个变量用来设置 ANALYZE 语句执行时并发度。当这个变量被设置得更大时，会对其它的查询语句执行性能产生一定影响。

tidb_checksum_table_concurrency

作用域：SESSION

默认值：4

这个变量用来设置 ADMIN CHECKSUM TABLE 语句执行时扫描索引的并发度。当这个变量被设置得更大时，会对其它的查询语句执行性能产生一定影响。

tidb_current_ts

作用域：SESSION

默认值：0

这个变量是一个只读变量，用来获取当前事务的时间戳。

tidb_config

作用域：SESSION

默认值：空字符串

这个变量是一个只读变量，用来获取当前 TiDB Server 的配置信息。

tidb_distsql_scan_concurrency

作用域：SESSION | GLOBAL

默认值：15

这个变量用来设置 scan 操作的并发度，AP 类应用适合较大的值，TP 类应用适合较小的值。对于 AP 类应用，最大值建议不要超过所有 TiKV 节点的 CPU 核数。

tidb_index_lookup_size

作用域：SESSION | GLOBAL

默认值：20000

这个变量用来设置 index lookup 操作的 batch 大小，AP 类应用适合较大的值，TP 类应用适合较小的值。

tidb_index_lookup_concurrency

作用域：SESSION | GLOBAL

默认值：4

这个变量用来设置 index lookup 操作的并发度，AP 类应用适合较大的值，TP 类应用适合较小的值。

tidb_index_lookup_join_concurrency

作用域：SESSION | GLOBAL

默认值：4

这个变量用来设置 index lookup join 算法的并发度。

tidb_hash_join_concurrency

作用域：SESSION | GLOBAL

默认值：5

这个变量用来设置 hash join 算法的并发度。

tidb_index_serial_scan_concurrency

作用域：SESSION | GLOBAL

默认值：1

这个变量用来设置顺序 scan 操作的并发度，AP 类应用适合较大的值，TP 类应用适合较小的值。

tidb_projection_concurrency

作用域：SESSION | GLOBAL

默认值：4

这个变量用来设置 Projection 算子的并发度。

tidb_hashagg_partial_concurrency

作用域：SESSION | GLOBAL

默认值：4

这个变量用来设置并行 hash aggregation 算法 partial 阶段的执行并发度。对于聚合函数参数不为 distinct 的情况，HashAgg 分为 partial 和 final 阶段分别并行执行。

tidb_hashagg_final_concurrency

作用域：SESSION | GLOBAL

默认值：4

这个变量用来设置并行 hash aggregation 算法 final 阶段的执行并发度。对于聚合函数参数不为 distinct 的情况，HashAgg 分为 partial 和 final 阶段分别并行执行。

tidb_index_join_batch_size

作用域：SESSION | GLOBAL

默认值：25000

这个变量用来设置 index lookup join 操作的 batch 大小，AP 类应用适合较大的值，TP 类应用适合较小的值。

tidb_skip_utf8_check

作用域：SESSION | GLOBAL

默认值：0

这个变量用来设置是否跳过 UTF-8 字符的验证。验证 UTF-8 字符需要消耗一定的性能，当可以确认输入的字符串为有效的 UTF-8 字符时，可以将其设置为 1。

tidb_init_chunk_size

作用域：SESSION | GLOBAL

默认值：32

这个变量用来设置执行过程中初始 chunk 的行数。默认值是 32。

tidb_max_chunk_size

作用域：SESSION | GLOBAL

默认值：1024

这个变量用来设置执行过程中一个 chunk 最大的行数。

tidb_mem_quota_query

作用域：SESSION

默认值：1 GB

这个变量用来设置一条查询语句的内存使用阈值。如果一条查询语句执行过程中使用的内存空间超过该阈值，会触发 TiDB 启动配置文件中 OOMAction 项所指定的行为。该变量的初始值由配置项 mem-quota-query 配置。

tidb_mem_quota_hashjoin

作用域：SESSION

默认值：32 GB

这个变量用来设置 HashJoin 算子的内存使用阈值。如果 HashJoin 算子执行过程中使用的内存空间超过该阈值，会触发 TiDB 启动配置文件中 OOMAction 项所指定的行为。

tidb_mem_quota_mergejoin

作用域：SESSION

默认值：32 GB

这个变量用来设置 MergeJoin 算子的内存使用阈值。如果 MergeJoin 算子执行过程中使用的内存空间超过该阈值，会触发 TiDB 启动配置文件中 OOMAction 项所指定的行为。

tidb_mem_quota_sort

作用域：SESSION

默认值：32 GB

这个变量用来设置 Sort 算子的内存使用阈值。如果 Sort 算子执行过程中使用的内存空间超过该阈值，会触发 TiDB 启动配置文件中 OOMAction 项所指定的行为。

tidb_mem_quota_topn

作用域：SESSION

默认值：32 GB

这个变量用来设置 TopN 算子的内存使用阈值。如果 TopN 算子执行过程中使用的内存空间超过该阈值，会触发 TiDB 启动配置文件中 OOMAction 项所指定的行为。

tidb_mem_quota_indexlookupreader

作用域：SESSION

默认值：32 GB

这个变量用来设置 IndexLookupReader 算子的内存使用阈值。

如果 IndexLookupReader 算子执行过程中使用的内存空间超过该阈值，会触发 TiDB 启动配置文件中 OOMAction 项所指定的行为。

tidb_mem_quota_indexlookupjoin

作用域：SESSION

默认值：32 GB

这个变量用来设置 IndexLookupJoin 算子的内存使用阈值。如果 IndexLookupJoin 算子执行过程中使用的内存空间超过该阈值，会触发 TiDB 启动配置文件中 OOMAction 项所指定的行为。

tidb_mem_quota_nestedloopapply

作用域：SESSION

默认值：32 GB

这个变量用来设置 NestedLoopApply 算子的内存使用阈值。如果 NestedLoopApply 算子执行过程中使用的内存空间超过该阈值，会触发 TiDB 启动配置文件中 OOMAction 项所指定的行为。

tidb_general_log

作用域：SERVER

默认值：0

这个变量用来设置是否在日志里记录所有的 SQL 语句。

tidb_enable_streaming

作用域：SESSION

默认值：0

这个变量用来设置是否启用 Streaming。

tidb_retry_limit

作用域：SESSION | GLOBAL

默认值：10

这个变量用来设置最大重试次数。一个事务执行中遇到可重试的错误（例如事务冲突、事务提交过慢或表结构变更）时，会根据该变量的设置进行重试。注意当 tidb_retry_limit = 0 时，也会禁用自动重试。

tidb_disable_txn_auto_retry

作用域：SESSION | GLOBAL

默认值：on

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

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

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

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

tidb_backoff_weight

作用域：SESSION | GLOBAL

默认值：2

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

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

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

tidb_enable_table_partition

作用域：SESSION | GLOBAL

默认值："on"

这个变量用来设置是否开启 TABLE PARTITION 特性。目前变量支持以下三种值：

默认值 on 表示开启 TiDB 当前已实现了的分区表类型，目前 range partition、hash partition 以及 range column 单列的场景会生效。
auto 目前作用和 on 一样。
off 表示关闭 TABLE PARTITION 的特性，此时语法还是保持兼容，只是创建的表并不是真正的分区表，而是普通的表。

注意，目前 TiDB 只支持 range partition 和 hash partition。

tidb_backoff_lock_fast

作用域：SESSION | GLOBAL

默认值：100

这个变量用来设置读请求遇到锁的 backoff 时间。

tidb_ddl_reorg_worker_cnt

作用域：GLOBAL

默认值：4

这个变量用来设置 DDL 操作 re-organize 阶段的并发度。

tidb_ddl_reorg_batch_size

作用域：GLOBAL

默认值：256

这个变量用来设置 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 可设为较大值，最大值是 10240，这样回填数据的速度更快，但是 TiKV 的写入压力也会变大。

tidb_ddl_reorg_priority

作用域：SESSION | GLOBAL

默认值：PRIORITY_LOW

这个变量用来设置 ADD INDEX 操作 re-organize 阶段的执行优先级，可设置为 PRIORITY_LOW/PRIORITY_NORMAL/PRIORITY_HIGH。

tidb_ddl_error_count_limit

作用域：GLOBAL

默认值：512

这个变量用来控制 DDL 操作失败重试的次数。失败重试次数超过该参数的值后，会取消出错的 DDL 操作。

tidb_max_delta_schema_count

作用域：GLOBAL

默认值：1024

这个变量用来设置缓存 schema 版本信息（对应版本修改的相关 table IDs）的个数限制，可设置的范围 100 - 16384。此变量在 2.1.18 及之后版本支持。

tidb_force_priority

作用域：SESSION

默认值：NO_PRIORITY

这个变量用于改变 TiDB server 上执行的语句的默认优先级。例如，你可以通过设置该变量来确保正在执行 OLAP 查询的用户优先级低于正在执行 OLTP 查询的用户。

可设置为 NO_PRIORITY、LOW_PRIORITY、DELAYED 或 HIGH_PRIORITY。

tidb_opt_write_row_id

作用域：SESSION

默认值：0

这个变量用来设置是否允许 insert、replace 和 update 操作 _tidb_rowid 列，默认是不允许操作。该选项仅用于 TiDB 工具导数据时使用。

tidb_row_format_version

作用域：GLOBAL

默认值：2

控制新保存数据的表数据格式版本。TiDB v4.0 中默认使用版本号为 2 的新表数据格式保存新数据。

但如果从 4.0.0 之前的版本升级到 4.0.0，不会改变表数据格式版本，TiDB 会继续使用版本为 1 的旧格式写入表中，即只有新创建的集群才会默认使用新表数据格式。

需要注意的是修改该变量不会对已保存的老数据产生影响，只会对修改变量后的新写入数据使用对应版本格式保存。

tidb_enable_slow_log

作用域：SESSION

默认值：1

这个变量用于控制是否开启 slow log 功能，默认开启。

tidb_record_plan_in_slow_log

作用域：SESSION

默认值：1

这个变量用于控制是否在 slow log 里包含慢查询的执行计划。

tidb_slow_log_threshold

作用域：SESSION

默认值：300

输出慢日志的耗时阈值。当查询大于这个值，就会当做是一个慢查询，输出到慢查询日志。默认为 300ms。

示例：

set tidb_slow_log_threshold = 200;

tidb_query_log_max_len

作用域：SESSION

默认值：4096 (bytes)

最长的 SQL 输出长度。当语句的长度大于 query-log-max-len，将会被截断输出。

示例：

set tidb_query_log_max_len = 20;

tidb_txn_mode

作用域：SESSION | GLOBAL

默认值："pessimistic"

这个变量用于设置事务模式。TiDB v3.0 支持了悲观事务，自 v3.0.8 开始，默认使用悲观事务模式。

但如果从 3.0.7 及之前的版本升级到 >= 3.0.8 的版本，不会改变默认事务模型，即只有新创建的集群才会默认使用悲观事务模型。

将该变量设置为 "optimistic" 或 "" 时，将会使用乐观事务模式。

tidb_constraint_check_in_place

作用域：SESSION | GLOBAL

默认值：0

TiDB 支持乐观事务模型，即在执行写入时，假设不存在冲突。冲突检查是在最后 commit 提交时才去检查。这里的检查指 unique key 检查。

这个变量用来控制是否每次写入一行时就执行一次唯一性检查。注意，开启该变量后，在大批量写入场景下，对性能会有影响。

示例：

默认关闭 tidb_constraint_check_in_place 时的行为：

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

Query OK, 1 row affected

commit 时才去做检查：

commit;

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

打开 tidb_constraint_check_in_place 后：

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

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

tidb_check_mb4_value_in_utf8

作用域：SERVER

默认值：1

这个变量用来设置是否开启对字符集为 UTF8 类型的数据做合法性检查，默认值 1 表示开启检查。这个默认行为和 MySQL 是兼容的。

注意，如果是旧版本升级时，可能需要关闭该选项，否则由于旧版本（v2.1.1 以及之前）没有对数据做合法性检查，所以旧版本写入非法字符串是可以写入成功的，但是新版本加入合法性检查后会报写入失败。具体可以参考升级后常见问题。

tidb_opt_insubq_to_join_and_agg

作用域：SESSION | GLOBAL

默认值：1

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

示例：

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

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

将子查询转成 join 如下：

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

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

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

tidb_opt_correlation_threshold

作用域：SESSION | GLOBAL

默认值：0.9

这个变量用来设置优化器启用交叉估算 row count 方法的阈值。如果列和 handle 列之间的顺序相关性超过这个阈值，就会启用交叉估算方法。

交叉估算方法可以简单理解为，利用这个列的直方图来估算 handle 列需要扫的行数。

tidb_opt_correlation_exp_factor

作用域：SESSION | GLOBAL

默认值：1

当交叉估算方法不可用时，会采用启发式估算方法。这个变量用来控制启发式方法的行为。当值为 0 时不用启发式估算方法，大于 0 时，该变量值越大，启发式估算方法越倾向 index scan，越小越倾向 table scan。

tidb_enable_window_function

作用域：SESSION | GLOBAL

默认值：1

这个变量用来控制是否开启窗口函数的支持。默认值 1 代表开启窗口函数的功能。

由于窗口函数会使用一些保留关键字，可能导致原先可以正常执行的 SQL 语句在升级 TiDB 后无法被解析语法，此时可以将 tidb_enable_window_function 设置为 0。

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_enable_fast_analyze

作用域：SESSION | GLOBAL

默认值：0

这个变量用来控制是否启用统计信息快速分析功能。默认值 0 表示不开启。

快速分析功能开启后，TiDB 会随机采样约 10000 行的数据来构建统计信息。因此在数据分布不均匀或者数据量比较少的情况下，统计信息的准确度会比较低。这可能导致执行计划不优，比如选错索引。如果可以接受普通 ANALYZE 语句的执行时间，则推荐关闭快速分析功能。

tidb_expensive_query_time_threshold

作用域：SERVER

默认值：60

这个变量用来控制打印 expensive query 日志的阈值时间，单位是秒，默认值是 60 秒。expensive query 日志和慢日志的差别是，慢日志是在语句执行完后才打印，expensive query 日志可以把正在执行中的语句且执行时间超过阈值的语句及其相关信息打印出来。

tidb_wait_split_region_finish

作用域：SESSION

默认值：1

由于打散 region 的时间可能比较长，主要由 PD 调度以及 TiKV 的负载情况所决定。这个变量用来设置在执行 SPLIT REGION 语句时，是否同步等待所有 region 都打散完成后再返回结果给客户端。默认 1 代表等待打散完成后再返回结果。0 代表不等待 Region 打散完成就返回。

需要注意的是，在 region 打散期间，对正在打散 region 上的写入和读取的性能会有一定影响，对于批量写入，导数据等场景，还是建议等待 region 打散完成后再开始导数据。

tidb_wait_split_region_timeout

作用域：SESSION

默认值：300

这个变量用来设置 SPLIT REGION 语句的执行超时时间，单位是秒，默认值是 300 秒，如果超时还未完成，就返回一个超时错误。

tidb_scatter_region

作用域：GLOBAL

默认值：0

TiDB 默认会在建表时为新表分裂 Region。开启该变量后，会在建表语句执行时，同步打散刚分裂出的 Region。适用于批量建表后紧接着批量写入数据，能让刚分裂出的 Region 先在 TiKV 分散而不用等待 PD 进行调度。为了保证后续批量写入数据的稳定性，建表语句会等待打散 Region 完成后再返回建表成功，建表语句执行时间会是关闭该变量的数倍。

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

作用域：SESSION

默认值：0

这个变量用来控制是否允许通过 ALTER TABLE MODIFY 或 ALTER TABLE CHANGE 来移除某个列的 AUTO_INCREMENT 属性。默认为不允许。

tidb_enable_stmt_summary 从 v3.0.4 版本开始引入

作用域：SESSION | GLOBAL

默认值：1（受配置文件影响，这里给出的是默认配置文件取值）

这个变量用来控制是否开启 statement summary 功能。如果开启，SQL 的耗时等执行信息将被记录到系统表 performance_schema.events_statements_summary_by_digest 中，用于定位和排查 SQL 性能问题。

tidb_stmt_summary_internal_query 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: 0（受配置文件影响，这里给出的是默认配置文件取值）

这个变量用来控制是否在 statement summary 中包含 TiDB 内部 SQL 的信息。

tidb_stmt_summary_refresh_interval 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: 1800（受配置文件影响，这里给出的是默认配置文件取值）

这个变量设置了 statement summary 的刷新时间，单位为秒。

tidb_stmt_summary_history_size 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: 24（受配置文件影响，这里给出的是默认配置文件取值）

这个变量设置了 statement summary 的历史记录容量。

tidb_stmt_summary_max_stmt_count 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: 200（受配置文件影响，这里给出的是默认配置文件取值）

这个变量设置了 statement summary 在内存中保存的语句的最大数量。

tidb_stmt_summary_max_sql_length 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值：4096（受配置文件影响，这里给出的是默认配置文件取值）

这个变量控制 statement summary 显示的 SQL 字符串长度。

tidb_enable_chunk_rpc 从 v4.0 版本开始引入

作用域：SESSION

默认值：1

这个变量用来设置是否启用 Coprocessor 的 Chunk 数据编码格式。

last_plan_from_cache 从 v4.0 版本开始引入

作用域：SESSION

默认值：0

这个变量用来显示上一个 execute 语句所使用的执行计划是不是直接从 plan cache 中取出来的。

ddl_slow_threshold

作用域：SESSION

默认值：300

耗时超过该阈值的 ddl 操作会被输出到日志，单位为毫秒。

tidb_pprof_sql_cpu 从 v4.0 版本开始引入

作用域：SESSION

默认值：0

这个变量用来控制是否在 profile 输出中标记出对应的 SQL 语句，用于定位和排查性能问题。

tidb_skip_isolation_level_check

作用域：SESSION

默认值：0

开启这个开关之后，如果对 tx_isolation 赋值一个 TiDB 不支持的隔离级别，不会报错。

tidb_low_resolution_tso

作用域：SESSION

默认值：0

这个变量用来设置是否启用低精度 tso 特性，开启该功能之后新事务会使用一个每 2s 更新的 ts 来读取数据。

主要场景是在可以容忍读到旧数据的情况下，降低小的只读事务获取 tso 的开销。

tidb_replica_read 从 v4.0 版本开始引入

作用域：SESSION

默认值: leader

这个变量用于控制 TiDB 读取数据的位置，有以下三个选择：

leader：只从 leader 节点读取
follower：只从 follower 节点读取
leader-and-follower：从 leader 或 follower 节点读取

tidb_use_plan_baselines 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: on

这个变量用于控制是否开启执行计划绑定功能，默认打开，可通过赋值 off 来关闭。关于执行计划绑定功能的使用可以参考执行计划绑定文档。

tidb_capture_plan_baselines 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: off

这个变量用于控制是否开启自动创建绑定功能。该功能依赖 Statement Summary，因此在使用自动绑定之前需打开 Statement Summary 开关。

开启该功能后会定期遍历一次 Statement Summary 中的历史 SQL 语句，并为至少出现两次的 SQL 语句自动创建绑定。

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_max_time 从 v4.0 版本开始引入

作用域：GLOBAL

默认值：600

该变量用于限制自动演进功能中，每个执行计划运行的最长时间，单位为秒。

tidb_evolve_plan_task_start_time 从 v4.0 版本开始引入

作用域：GLOBAL

默认值：00:00 +0000

这个变量用来设置一天中允许自动演进的开始时间。

tidb_evolve_plan_task_end_time 从 v4.0 版本开始引入

作用域：GLOBAL

默认值：23:59 +0000

这个变量用来设置一天中允许自动演进的结束时间。

tidb_allow_batch_cop 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: 0

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

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

tidb_enable_cascades_planner

作用域：SESSION | GLOBAL

默认值: 0

这个变量用于控制是否开启 cascades planner。

tidb_window_concurrency 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: 4

这个变量用于设置 window 算子的并行度。

tidb_enable_vectorized_expression 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: 1

这个变量用于控制是否开启向量化执行。

tidb_enable_index_merge 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: 0

这个变量用于控制是否开启 index merge 功能。

tidb_enable_noop_functions 从 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: 0

这个变量用于控制是否开启 get_lock 和 release_lock 这两个没有实现的函数。需要注意的是，当前版本的 TiDB 这两个函数永远返回 1。

tidb_isolation_read_engines 从 v4.0 版本开始引入

作用域：SESSION

默认值: tikv, tiflash, tidb

这个变量用于设置 TiDB 在读取数据时可以使用的存储引擎列表。

tidb_store_limit 从 v3.0.4 和 v4.0 版本开始引入

作用域：SESSION | GLOBAL

默认值: 0

这个变量用于限制 TiDB 同时向 TiKV 发送的请求的最大数量，0 表示没有限制。

tidb_metric_query_step 从 v4.0 版本开始引入

作用域：SESSION

默认值: 60

这个变量设置了查询 METRIC_SCHEMA 时生成的 Prometheus 语句的 step，单位为秒。

tidb_metric_query_range_duration 从 v4.0 版本开始引入

作用域：SESSION

默认值: 60

这个变量设置了查询 METRIC_SCHEMA 时生成的 Prometheus 语句的 range duration，单位为秒。

Files

tidb-specific-system-variables.md

Latest commit

History

tidb-specific-system-variables.md

File metadata and controls

TiDB 专用系统变量和语法

系统变量

tidb_snapshot

tidb_opt_agg_push_down

tidb_opt_distinct_agg_push_down

tidb_auto_analyze_ratio

tidb_auto_analyze_start_time

tidb_auto_analyze_end_time

tidb_build_stats_concurrency

tidb_checksum_table_concurrency

tidb_current_ts

tidb_config

tidb_distsql_scan_concurrency

tidb_index_lookup_size

tidb_index_lookup_concurrency

tidb_index_lookup_join_concurrency

tidb_hash_join_concurrency

tidb_index_serial_scan_concurrency

tidb_projection_concurrency

tidb_hashagg_partial_concurrency

tidb_hashagg_final_concurrency

tidb_index_join_batch_size

tidb_skip_utf8_check

tidb_init_chunk_size

tidb_max_chunk_size

tidb_mem_quota_query

tidb_mem_quota_hashjoin

tidb_mem_quota_mergejoin

tidb_mem_quota_sort

tidb_mem_quota_topn

tidb_mem_quota_indexlookupreader

tidb_mem_quota_indexlookupjoin

tidb_mem_quota_nestedloopapply

tidb_general_log

tidb_enable_streaming

tidb_retry_limit

tidb_disable_txn_auto_retry

tidb_backoff_weight

tidb_enable_table_partition

tidb_backoff_lock_fast

tidb_ddl_reorg_worker_cnt

tidb_ddl_reorg_batch_size

tidb_ddl_reorg_priority

tidb_ddl_error_count_limit

tidb_max_delta_schema_count

tidb_force_priority

tidb_opt_write_row_id

tidb_row_format_version

tidb_enable_slow_log

tidb_record_plan_in_slow_log

tidb_slow_log_threshold

tidb_query_log_max_len

tidb_txn_mode

tidb_constraint_check_in_place

tidb_check_mb4_value_in_utf8

tidb_opt_insubq_to_join_and_agg

tidb_opt_correlation_threshold

tidb_opt_correlation_exp_factor

tidb_enable_window_function

tidb_slow_query_file

tidb_enable_fast_analyze

tidb_expensive_query_time_threshold

tidb_wait_split_region_finish

tidb_wait_split_region_timeout

tidb_scatter_region

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

tidb_enable_stmt_summary 从 v3.0.4 版本开始引入

tidb_stmt_summary_internal_query 从 v4.0 版本开始引入

tidb_stmt_summary_refresh_interval 从 v4.0 版本开始引入

tidb_stmt_summary_history_size 从 v4.0 版本开始引入

tidb_stmt_summary_max_stmt_count 从 v4.0 版本开始引入

tidb_stmt_summary_max_sql_length 从 v4.0 版本开始引入

tidb_enable_chunk_rpc 从 v4.0 版本开始引入

last_plan_from_cache 从 v4.0 版本开始引入