MySQL8新特性之全局参数持久化详解(参数持久)

全局参数持久化

MySQL 8.0 版本支持在线修改全局参数并持久化，通过加上 PERSIST 关键字，可以将修改的参数持久化到新的配置文件（mysqld-auto.cnf）中，重启 MySQL 时，可以从该配置文件获取到最新的配置参数！

对应的Worklog [WL#8688]：dev.mysql.com/worklog/tas…

启用这个功能，使用特定的语法 SET PERSIST 来设定任意可动态修改的全局变量！

SET PERSIST

语句可以修改内存中变量的值，并且将修改后的值写⼊数据⽬录中的 mysqld-auto.cnf 中。

SET PERSIST_ONLY

语句不会修改内存中变量的值，只是将修改后的值写⼊数据⽬录中的 mysqld-auto.cnf 中。

以 max_connections 参数为例：

mysql> select * from performance_schema.persisted_variables;
Empty set (0.00 sec)
mysql> show variables like '%max_connections%';
+------------------------+-------+
| Variable_name          | Value |
+------------------------+-------+
| max_connections        | 151   |
| mysqlx_max_connections | 100   |
+------------------------+-------+
2 rows in set (0.00 sec)
mysql> set persist max_connections=300;
Query OK, 0 rows affected (0.00 sec)
mysql> select * from performance_schema.persisted_variables;
+-----------------+----------------+
| VARIABLE_NAME   | VARIABLE_VALUE |
+-----------------+----------------+
| max_connections | 300            |
+-----------------+----------------+
1 row in set (0.00 sec)

系统会在数据目录下生成一个包含 json 格式的 mysqld-auto.cnf 的文件，格式化后如下所示，当 my.cnf 和mysqld-auto.cnf 同时存在时，后者具有更高优先级。

{
    "Version": 1, 
    "mysql_server": {
        "max_connections": {
            "Value": "300", 
            "Metadata": {
                "Timestamp": 1632575065787609, 
                "User": "root", 
                "Host": "localhost"
            }
        }
    }
}

📢 注意：即使你通过 SET PERSIST 修改配置的值并没有任何变化，也会写入到 mysqld-auto.cnf 文件中。但你可以通过设置成 DEFAULT 值的方式来恢复初始默认值！

如果想要恢复 max_connections 参数为初始默认值，只需要执行：

mysql> set persist max_connections=DEFAULT;
Query OK, 0 rows affected (0.00 sec)
mysql> select * from performance_schema.persisted_variables;
+-----------------+----------------+
| VARIABLE_NAME   | VARIABLE_VALUE |
+-----------------+----------------+
| max_connections | 151            |
+-----------------+----------------+
1 row in set (0.00 sec)

如果想要移除所有的全局持久化参数，则只需执行：

mysql> RESET PERSIST;
Query OK, 0 rows affected (0.00 sec)
mysql> select * from performance_schema.persisted_variables;
Empty set (0.00 sec)

当然，删除 mysqld-auto.cnf 文件后，重启 MySQL 也可！

写在最后

主要代码：

Commit f2bc0f89b7f94cc8fe963d08157413a01d14d994

主要入口函数(8.0.0)：

接口函数大多定义在sql/persisted_variable.cc文件中：
启动时载入mysqld-auto.cnf的内容: Persisted_variables_cache::load_persist_file()；通过json解析合法性，并存入内存
将文件中读取的配置进行设置： Persisted_variables_cache::set_persist_options

运行SET PERSIST命令时，调用Persisted_variables_cache::set_variable 更新内存中存储的值
写入mysqld-auto.cnf文件中： Persisted_variables_cache::flush_to_file