系统变量

MySQL 系统变量 (System Variables) 是一些系统参数,用于调整数据库运行时的行为,根据变量的作用范围分为全局范围有效(Global Scope)以及会话级别有效(Session Scope)。TiDB 支持 MySQL5.7 的所有系统变量,大部分变量仅仅是为了兼容性而支持,不会影响运行时行为。

设置系统变量

通过 SET 语句可以修改系统变量的值。进行修改时,还要考虑变量可修改的范围,不是所有的变量都能在全局/会话范围内进行修改。具体的可修改范围参考 MySQL 动态变量文档

全局范围值

  • 在变量名前加 GLOBAL 关键词或者是使用 @@global. 作为修饰符:

    1. SET GLOBAL autocommit = 1;
    2. SET @@global.autocommit = 1;

会话范围值

  • 在变量名前加 SESSION 关键词或者是使用 @@session. 作为修饰符,或者是不加任何修饰符:

    1. SET SESSION autocommit = 1;
    2. SET @@session.autocommit = 1;
    3. SET @@autocommit = 1;
  • LOCAL 以及 @@local.SESSION 以及 @@session. 的同义词

系统变量的作用机制

  • 会话范围的系统变量仅仅会在创建会话时才会根据全局范围系统变量初始化自己的值。更改全局范围的系统变量不会改变已经创建的会话正在使用的系统变量的值。

    1. mysql> SELECT @@GLOBAL.autocommit;
    2. +---------------------+
    3. | @@GLOBAL.autocommit |
    4. +---------------------+
    5. | ON |
    6. +---------------------+
    7. 1 row in set (0.00 sec)
    8. mysql> SELECT @@SESSION.autocommit;
    9. +----------------------+
    10. | @@SESSION.autocommit |
    11. +----------------------+
    12. | ON |
    13. +----------------------+
    14. 1 row in set (0.00 sec)
    15. mysql> SET GLOBAL autocommit = OFF;
    16. Query OK, 0 rows affected (0.01 sec)
    17. mysql> SELECT @@SESSION.autocommit; -- 会话范围的系统变量不会改变,会话中执行的事务依旧是以自动提交的形式来进行。
    18. +----------------------+
    19. | @@SESSION.autocommit |
    20. +----------------------+
    21. | ON |
    22. +----------------------+
    23. 1 row in set (0.00 sec)
    24. mysql> SELECT @@GLOBAL.autocommit;
    25. +---------------------+
    26. | @@GLOBAL.autocommit |
    27. +---------------------+
    28. | OFF |
    29. +---------------------+
    30. 1 row in set (0.00 sec)
    31. mysql> exit
    32. Bye
    33. $ mysql -h127.0.0.1 -P4000 -uroot -D test
    34. Welcome to the MySQL monitor. Commands end with ; or \g.
    35. Your MySQL connection id is 3
    36. Server version: 5.7.25-TiDB-None MySQL Community Server (Apache License 2.0)
    37. Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
    38. Oracle is a registered trademark of Oracle Corporation and/or its
    39. affiliates. Other names may be trademarks of their respective
    40. owners.
    41. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    42. mysql> SELECT @@SESSION.autocommit; -- 新建的会话会使用新的全局变量。
    43. +----------------------+
    44. | @@SESSION.autocommit |
    45. +----------------------+
    46. | OFF |
    47. +----------------------+
    48. 1 row in set (0.00 sec)

TiDB 支持的 MySQL 系统变量

下列系统变量是 TiDB 真正支持并且行为和 MySQL 一致:

变量名 作用域 说明
autocommit GLOBAL \ SESSION 是否自动 Commit 事务
sql_mode GLOBAL \ SESSION 支持部分 MySQL SQL mode,
time_zone GLOBAL \ SESSION 数据库所使用的时区
tx_isolation GLOBAL \ SESSION 事务隔离级别

TiDB 特有的系统变量

参见 TiDB 专用系统变量