MySQL服务器配置选项（mysqld）

mysqld是MySQL服务器。以下讨论涵盖了这些MySQL服务器配置主题：

• 服务器支持的启动选项。您可以在命令行上，通过配置文件或同时在这两者上指定这些选项。
• 服务器系统变量。这些变量反映了启动选项的当前状态和值，其中一些可以在服务器运行时进行修改。
• 服务器状态变量。这些变量包含有关运行时操作的计数器和统计信息。
• 如何设置服务器SQL模式。此设置修改了SQL语法和语义的某些方面，例如为了与其他数据库系统的代码兼容，或控制特定情况下的错误处理。
• 配置和使用IPv6支持。
• 配置和使用时区支持。
• 服务器端帮助功能。
• 服务器关闭过程。根据表的类型（事务性或非事务性）以及是否使用复制，需要考虑性能和可靠性。

有关在MySQL 8.0中已添加，不建议使用或删除的MySQL服务器变量和选项的列表，请参见“在MySQL 8.0中添加，不建议使用或删除的服务器和状态变量及选项”。

注意

并非所有MySQL服务器二进制文件和配置都支持所有存储引擎。要了解如何确定MySQL服务器安装支持的存储引擎，请参见“ SHOW ENGINES语句”。

服务器配置默认值

MySQL服务器具有许多操作参数，您可以在服务器启动时使用命令行选项或配置文件（选项文件）进行更改。也可以在运行时更改许多参数。有关在启动或运行时设置参数的一般说明，请参见“服务器命令选项”和“服务器系统变量”。

在Windows上，MySQL Installer与用户进行交互，并my.ini在基本安装目录中创建一个名为默认选项文件的文件。

注意

在Windows上，可能不会显示.ini或.cnf选项文件扩展名。

完成安装过程后，您可以随时编辑默认选项文件，以修改服务器使用的参数。例如，要在文件#的行首使用带注释的参数设置，请删除#，并在必要时修改参数值。要禁用设置，请#在行首添加a 或将其删除。

对于非Windows平台，在服务器安装或数据目录初始化过程中不会创建默认选项文件。按照“使用选项文件”中的说明创建选项文件。如果没有选项文件，则服务器仅以其默认设置启动-有关如何检查这些设置的信息，请参见“服务器配置默认值”。

有关选项文件格式和语法的更多信息，请参见“使用选项文件”。

服务器配置验证

从MySQL 8.0.16开始，MySQL Server支持一个--validate-config选项，该选项使您无需在正常操作模式下运行服务器即可检查启动配置是否存在问题：

mysqld --validate-config

如果未找到错误，则服务器以退出代码0终止。如果发现错误，则服务器显示诊断消息，并以退出代码1终止。例如：

shell>mysqld --validate-config --no-such-option
2018-11-05T17:50:12.738919Z 0 [ERROR] [MY-000068] [Server] unknown
option '--no-such-option'.
2018-11-05T17:50:12.738962Z 0 [ERROR] [MY-010119] [Server] Aborting

一旦发现任何错误，服务器就会终止。要进行其他检查，请更正最初的问题，然后--validate-config再次运行服务器。

对于前面的示例，如果--validate-config在显示错误消息时使用结果，则服务器退出代码为1。根据log_error_verbosity值，也可能会显示警告和信息消息，但不会立即产生终止验证或退出代码为1例如，此命令产生多个警告，两个警告均显示。但是没有错误发生，因此退出代码为0：

shell>mysqld --validate-config --log_error_verbosity=2
--read-only=s --transaction_read_only=s
2018-11-05T15:43:18.445863Z 0 [Warning] [MY-000076] [Server] option
'read_only': boolean value 's' was not recognized. Set to OFF.
2018-11-05T15:43:18.445882Z 0 [Warning] [MY-000076] [Server] option
'transaction-read-only': boolean value 's' was not recognized. Set to OFF.

此命令会产生相同的警告，但也会产生错误，因此错误消息将与警告一起显示，并且退出代码为1：

shell>mysqld --validate-config --log_error_verbosity=2
--no-such-option --read-only=s --transaction_read_only=s
2018-11-05T15:43:53.152886Z 0 [Warning] [MY-000076] [Server] option
'read_only': boolean value 's' was not recognized. Set to OFF.
2018-11-05T15:43:53.152913Z 0 [Warning] [MY-000076] [Server] option
'transaction-read-only': boolean value 's' was not recognized. Set to OFF.
2018-11-05T15:43:53.164889Z 0 [ERROR] [MY-000068] [Server] unknown
option '--no-such-option'.
2018-11-05T15:43:53.165053Z 0 [ERROR] [MY-010119] [Server] Aborting

该--validate-config选项的范围仅限于配置检查，以使服务器可以在不进行正常启动过程的情况下执行该检查。这样，配置检查不会初始化存储引擎和其他插件，组件等，也不会验证与那些未初始化的子系统关联的选项。

--validate-config可以随时使用，但在升级后特别有用，它可以检查升级的服务器是否认为旧版本服务器先前使用的任何选项已被弃用或作废。例如，tx_read_only系统变量在MySQL 5.7中已弃用，而在8.0中已删除。假设使用my.cnf文件中的系统变量运行了MySQL 5.7服务器，然后将其升级到MySQL 8.0。运行升级的服务器--validate-config以检查配置会产生以下结果：

shell>mysqld --validate-config
2018-11-05T10:40:02.712141Z 0 [ERROR] [MY-000067] [Server] unknown variable
'tx_read_only=ON'.
2018-11-05T10:40:02.712178Z 0 [ERROR] [MY-010119] [Server] Aborting

--validate-config可以与--defaults-file选项一起使用，以仅验证特定文件中的选项：

shell>mysqld --defaults-file=./my.cnf-test --validate-config
2018-11-05T10:40:02.712141Z 0 [ERROR] [MY-000067] [Server] unknown variable
'tx_read_only=ON'.
2018-11-05T10:40:02.712178Z 0 [ERROR] [MY-010119] [Server] Aborting

请记住--defaults-file，如果指定，则必须是命令行上的第一个选项。（以相反的顺序执行前面的示例会生成一条消息，该消息--defaults-file本身是未知的。）

服务器选项，系统变量和状态变量参考

下表列出了适用于的所有命令行选项，系统变量和状态变量mysqld。

该表在一个统一列表中列出了命令行选项（Cmd-line），在配置文件中有效的选项（Option file），服务器系统变量（System Var）和状态变量（Status var），并指出了每个选项的位置或变量有效。如果在命令行或选项文件中设置的服务器选项与相应系统变量的名称不同，则将在相应选项的下方立即标记变量名称。对于系统变量和状态变量，变量的范围（Var Scope）为全局，会话或两者。有关设置以及使用选项和变量的详细信息，请参见相应的项目描述。在适当的地方，提供了指向有关该项目的更多信息的直接链接。

有关该表特定于NDB Cluster的版本，请参见“ NDB Cluster mysqld选项和变量参考”。

表5.1命令行选项，系统变量和状态变量摘要