要查看服务器基于其编译默认值和读取的选项文件的值，请使用以下命令：

mysqld --verbose --help

要查看服务器基于其编译默认值的值，忽略选项文件中的设置，请使用以下命令：

mysqld --no-defaults --verbose --help

要查看当前正在运行的服务器使用的值，请使用 SHOW VARIABLES 语句或性能模式系统变量表。请参阅 第 29.12.14 节，“性能模式系统变量表”。

第 7.1.9 节，“使用系统变量”，讨论了设置和显示系统变量值的语法。

第 7.1.9.2 节，“动态系统变量”，列出了可以在运行时设置的变量。

系统变量调整信息可以在 第 7.1.1 节，“配置服务器” 中找到。

第 17.14 节，“InnoDB 启动选项和系统变量”，列出了 InnoDB 系统变量。

第 25.4.3.9.2 节，“NDB 集群系统变量”，列出了特定于 NDB 集群的系统变量。

有关复制服务器系统变量的信息，请参阅 第 19.1.6 节，“复制和二进制日志选项和变量”。

activate_all_roles_on_login

是否在用户登录服务器时启用所有授予角色的自动激活：

授予角色包括明确授予用户的角色和在 mandatory_roles 系统变量值中命名的角色。

activate_all_roles_on_login 只适用于登录时，以及在定义器上下文中执行的存储程序和视图的开始执行时。要在会话中更改活动角色，请使用 SET ROLE。要更改存储程序的活动角色，该程序体应执行 SET ROLE。

admin_address

监听管理网络接口的IP地址（参见第7.1.12.1节，“连接接口”）。没有默认的admin_address值。如果在启动时未指定此变量，服务器将不维护管理接口。服务器还具有bind_address系统变量，以配置常规（非管理）客户端TCP/IP连接。参见第7.1.12.1节，“连接接口”。

如果指定admin_address，其值必须满足以下要求：

可以将IP地址指定为IPv4或IPv6地址。如果值是一个主机名，服务器将其解析为IP地址并绑定到该地址。如果主机名解析到多个IP地址，服务器将使用第一个IPv4地址，如果有，或者第一个IPv6地址否则。

服务器对不同类型的地址进行如下处理：

以下规则适用于指定网络命名空间：

有关网络命名空间的更多信息，请参见第7.1.14节，“网络命名空间支持”。

如果绑定到地址失败，服务器将产生错误并且不启动。

admin_address系统变量与bind_address系统变量相似，但有以下差异：

admin_port

用于管理网络接口的TCP/IP端口号（参见第7.1.12.1节，“连接接口”）。将此变量设置为0将使用默认值。

设置admin_port没有效果，如果admin_address未指定，因为在那种情况下，服务器不维护管理网络接口。

admin_ssl_ca

系统变量admin_ssl_ca类似于ssl_ca，只是它应用于管理连接接口，而不是主连接接口。有关配置管理接口加密支持的信息，请参阅管理接口加密连接支持。

admin_ssl_capath

系统变量admin_ssl_capath类似于ssl_capath，只是它应用于管理连接接口，而不是主连接接口。有关配置管理接口加密支持的信息，请参阅管理接口加密连接支持。

admin_ssl_cert

系统变量admin_ssl_cert类似于ssl_cert，只是它应用于管理连接接口，而不是主连接接口。有关配置管理接口加密支持的信息，请参阅管理接口加密连接支持。

admin_ssl_cipher

系统变量admin_ssl_cipher类似于ssl_cipher，只是它应用于管理连接接口，而不是主连接接口。有关配置管理接口加密支持的信息，请参阅管理接口加密连接支持。

admin_ssl_crl

系统变量 admin_ssl_crl 与 ssl_crl 相似，除了它应用于管理连接接口而不是主连接接口。有关配置管理接口加密支持的信息，请参阅 管理接口支持加密连接。

admin_ssl_crlpath

系统变量 admin_ssl_crlpath 与 ssl_crlpath 相似，除了它应用于管理连接接口而不是主连接接口。有关配置管理接口加密支持的信息，请参阅 管理接口支持加密连接。

admin_ssl_key

系统变量 admin_ssl_key 与 ssl_key 相似，除了它应用于管理连接接口而不是主连接接口。有关配置管理接口加密支持的信息，请参阅 管理接口支持加密连接。

admin_tls_ciphersuites

系统变量 admin_tls_ciphersuites 与 tls_ciphersuites 相似，除了它应用于管理连接接口而不是主连接接口。有关配置管理接口加密支持的信息，请参阅 管理接口支持加密连接。

admin_tls_version

系统变量 admin_tls_version 与 tls_version 相似，除了它应用于管理连接接口而不是主连接接口。有关配置管理接口加密支持的信息，请参阅 管理接口支持加密连接。

身份验证策略

该变量用于管理多因素身份验证（MFA）功能。它适用于 CREATE USER 和 ALTER USER 语句中与账户定义相关的身份验证因子子句，其中“factor”对应于与账户关联的身份验证方法或插件：

因为 身份验证策略 只适用于创建或修改账户时，因此对其值的更改不会影响现有的用户账户。

身份验证策略 的值是一个由 1、2 或 3 个逗号分隔的元素列表。每个元素可以是身份验证插件名称、星号 (*)、空或缺失。（例外：元素 1 不能为空或缺失。）在所有情况下，元素可以被空白字符包围，整个列表被单引号括起来。

指定的值类型对应于元素 N 在列表中的影响是，是否需要 factor N 在账户定义中存在，以及哪些身份验证插件可以被使用：

当 authentication_policy 元素命名身份验证插件时，元素的允许插件名称受以下条件限制：

当 authentication_policy 元素 N 是 * 时，factor N 在账户定义中的允许插件名称受以下条件限制：

当 authentication_policy 元素 N 为空时，factor N 在账户定义中的允许插件名称受以下条件限制：

空元素必须出现在列表的末尾，跟随非空元素。在其他 words，第一个元素不能为空，或者没有元素为空，或者最后一个元素为空，或者最后两个元素为空。例如，值为 ',,' 不允许，因为它将表明所有因素都是可选的。这是不可能的；账户必须至少有一个身份验证因素。

默认值为 authentication_policy 是 '*,,'。这意味着因素 1 在账户定义中是必需的，可以使用任何身份验证插件，而因素 2 和 3 是可选的，每个都可以使用不使用内部凭证存储的身份验证插件。

以下表格显示了一些 authentication_policy 值和每个值所建立的账户创建或更改策略。

身份验证Windows日志级别

该变量仅在启用了身份验证Windows插件并启用了调试代码时可用。请参阅第 8.4.1.6 节，“Windows 可插拔身份验证”。

该变量设置身份验证Windows插件的日志级别。以下表格显示了允许的值。

身份验证Windows使用principal名称

该变量仅在启用了身份验证Windows插件时可用。请参阅第 8.4.1.6 节，“Windows 可插拔身份验证”。

使用 InitSecurityContext() 函数进行身份验证的客户端应该提供一个字符串，标识连接到的服务 (targetName)。MySQL 使用服务器运行的账户的 principal 名称 (UPN)。UPN 的形式为 user_id@computer_name，无需注册即可使用。该 UPN 在身份验证握手机开始时由服务器发送。

该变量控制服务器是否在初始挑战中发送 UPN。默认情况下，该变量启用。出于安全原因，可以禁用该变量，以避免将服务器的账户名称以明文形式发送给客户端。如果禁用该变量，服务器总是发送 0x00 字节作为初始挑战，客户端不指定 targetName，因此使用 NTLM 身份验证。

如果服务器无法获取其 UPN（主要发生在不支持 Kerberos 身份验证的环境中），则服务器不发送 UPN，使用 NTLM 身份验证。

自动提交

自动提交模式。如果设置为 1，则对表的所有更改立即生效。如果设置为 0，则必须使用 COMMIT 来接受事务或 ROLLBACK 来取消它。如果 autocommit 是 0 并将其更改为 1，MySQL 将执行自动 COMMIT 任何打开的事务。另一种开始事务的方式是使用 START TRANSACTION 或 BEGIN 语句。见 第 15.3.1 节，“START TRANSACTION, COMMIT, and ROLLBACK Statements”。

默认情况下，客户端连接以 autocommit 设置为 1 开始。要使客户端以默认值 0 开始，请使用 --autocommit=0 选项启动服务器。要使用选项文件设置变量，请包括以下行：

[mysqld]
autocommit=0

automatic_sp_privileges

当该变量的值为 1（默认值）时，服务器自动授予存储过程的创建者 EXECUTE 和 ALTER ROUTINE 权限，如果用户不能执行或更改或删除该过程。（ALTER ROUTINE 权限是删除该过程所需的。）服务器还自动从创建者中删除这些权限时删除该过程。

过程的创建者是执行 CREATE 语句的账户。这可能与在过程定义中指定的 DEFINER 账户不同。

如果您使用 --skip-new 选项启动 mysqld，automatic_sp_privileges 将被设置为 OFF。

另见 第 27.2.2 节，“Stored Routines and MySQL Privileges”。

auto_generate_certs

该变量控制服务器是否在数据目录中自动生成 SSL 密钥和证书文件，如果它们不存在。

在启动时，如果 auto_generate_certs 系统变量启用，未指定其他 SSL 选项，且服务器端 SSL 文件缺失于数据目录中，服务器将自动生成服务器端和客户端 SSL 证书和密钥文件。这些文件启用使用 SSL 的安全客户端连接；见 第 8.3.1 节，“Configuring MySQL to Use Encrypted Connections”。

有关SSL文件自动生成的更多信息，包括文件名和特征，请参阅第8.3.3.1节，“使用MySQL创建SSL和RSA证书和密钥”

系统变量sha256_password_auto_generate_rsa_keys和caching_sha2_password_auto_generate_rsa_keys相关，但控制使用RSA在未加密连接上交换安全密码的RSA密钥对文件的自动生成。

avoid_temporal_upgrade

该变量控制是否ALTER TABLE隐式升级发现的时间列（TIME、DATETIME和TIMESTAMP列）以前的5.6.4格式升级这些列需要重建表，防止快速更改操作的应用。

该变量默认情况下禁用。启用它将导致ALTER TABLE不重建时间列，从而能够应用快速更改操作。

该变量已弃用；预计在未来MySQL版本中删除。

back_log

MySQL可以拥有的未决连接请求的数量。这在MySQL主线程在短时间内收到大量连接请求时发挥作用。那时，主线程需要一些时间（尽管非常短）来检查连接并启动新线程。back_log值指示在这短时间内可以堆叠的请求数量，然后MySQL暂时停止回答新请求。

换言之，这个值是入站TCP/IP连接的监听队列的大小。您的操作系统对该队列的大小也有其限制。Unix listen()系统调用手册页应该有更多详细信息。请查看您的操作系统文档，以了解该变量的最大值。back_log不能设置高于操作系统限制。

默认值是max_connections的值，这使得允许的积压量调整到最大允许的连接数。

basedir

MySQL安装的基本目录路径。

big_tables

如果启用，服务器将所有临时表存储在磁盘上，而不是在内存中。这将防止大多数 表 tbl_name 已满 错误对于 SELECT 操作，这些操作需要一个大型临时表，但也会减慢查询速度，对于那些可以使用内存表的查询。

默认值为新连接是 OFF（使用内存临时表）。通常，不需要启用这个变量。当内存 内部 临时表由 TempTable 存储引擎（默认）管理时，最大内存量超过 TempTable 存储引擎可以占用的内存量时，TempTable 存储引擎将开始将数据存储到临时文件中。当内存临时表由 MEMORY 存储引擎管理时，内存表将自动转换为基于磁盘的表，如有需要。有关更多信息，请参阅 第 10.4.4 节，“MySQL 中的内部临时表使用”。

bind_address

MySQL 服务器监听一个或多个网络套接字以接受 TCP/IP 连接。每个套接字绑定到一个地址，但一个地址可以映射到多个网络接口。要指定服务器如何监听 TCP/IP 连接，请在服务器启动时设置 bind_address 系统变量。服务器还具有一个 admin_address 系统变量，用于在专用接口上启用管理连接。请参阅 第 7.1.12.1 节，“连接接口”。

如果 bind_address 被指定，它接受一个或多个地址值，每个值可以指定单个非通配符 IP 地址或主机名。每个地址可以包括网络命名空间规范。如果只有一个地址被指定，它可以使用一个通配符地址格式（*、0.0.0.0 或 ::），以便在多个网络接口上监听。多个地址用逗号分隔。当多个值被列出时，每个值必须指定单个非通配符 IP 地址（IPv4 或 IPv6）或主机名，而通配符地址格式（*、0.0.0.0 或 ::）不允许。

IP 地址可以指定为 IPv4 或 IPv6 地址。对于任何主机名，服务器将其解析为 IP 地址，然后绑定到该地址。如果主机名解析到多个 IP 地址，服务器使用第一个 IPv4 地址，如果没有，则使用第一个 IPv6 地址。

服务器对不同类型的地址进行如下处理：

以下规则适用于指定网络命名空间：

有关网络命名空间的更多信息，请参阅第 7.1.14 节，“网络命名空间支持”。

如果绑定到任何地址失败，服务器将产生错误并且不启动。

示例：

当 bind_address 命名单个值（通配符或非通配符）时，服务器监听单个套接字，该套接字可能绑定到多个网络接口。当 bind_address 命名多个值时，服务器监听每个值一个套接字，每个套接字绑定到单个网络接口。套接字的数量与指定的值数量成线性关系。根据操作系统的连接接受效率，长值列表可能会产生性能损失。

由于文件描述符分配给监听套接字和网络命名空间文件，因此可能需要增加 open_files_limit 系统变量。

如果您打算将服务器绑定到特定地址，请确保 mysql.user 系统表中存在具有管理权限的帐户，以便您可以连接到该地址。否则，您无法关闭服务器。例如，如果您将服务器绑定到 *，您可以使用所有现有帐户连接到服务器。但是，如果您将服务器绑定到 ::1，它将仅接受来自该地址的连接。在这种情况下，首先确保 'root'@'::1' 帐户存在于 mysql.user 表中，以便您可以连接到服务器以关闭它。

block_encryption_mode

该变量控制块加密模式，对于块加密算法如 AES 生效。它影响 AES_ENCRYPT() 和 AES_DECRYPT() 的加密。

块加密模式 采用 aes-密钥长度-加密模式 格式，其中 密钥长度 是以位为单位的密钥长度，加密模式 是加密模式。该值不区分大小写。允许的 密钥长度 值为 128、192 和 256。允许的 加密模式 值为 ECB、CBC、CFB1、CFB8、CFB128 和 OFB。

例如，该语句使 AES 加密函数使用 256 位密钥长度和 CBC 模式：

SET block_encryption_mode = 'aes-256-cbc';

尝试将 块加密模式 设置为包含不支持的密钥长度或 SSL 库不支持的模式时，会发生错误。

构建 ID

这是一个 160 位 SHA1 签名，由链接器在 Linux 系统上编译服务器时生成（默认情况下启用），并将其转换为十六进制字符串。该只读值充当唯一的构建 ID，并在服务器启动时写入日志中。

构建 ID 不支持其他平台。

批量插入缓冲区大小

MyISAM 使用特殊的树形缓存来加速批量插入 INSERT ... SELECT、INSERT ... VALUES (...), (...), ... 和 LOAD DATA 对非空表的数据添加时。该变量限制了每个线程的缓存树大小，以字节为单位。将其设置为 0 将禁用该优化。默认值为 8MB。

设置该会话变量需要足够的权限。请参阅 第 7.1.9.1 节，“系统变量权限”。

caching_sha2_password 摘要轮数

该变量指定了 caching_sha2_password 身份验证插件用于密码存储的哈希轮数。

将哈希轮数增加到默认值以上将导致性能损失，该损失与增加的数量相关：

caching_sha2_password 自动生成 RSA 密钥

服务器使用该变量来确定是否在数据目录中自动生成 RSA 私钥/公钥文件对，如果它们尚不存在。

在启动时，服务器自动在数据目录中生成 RSA 私钥/公钥文件对，如果所有以下条件都为真：sha256_password_auto_generate_rsa_keys 或 caching_sha2_password_auto_generate_rsa_keys 系统变量启用；没有指定 RSA 选项；RSA 文件缺失于数据目录中。这些密钥文件使得使用 RSA 进行安全密码交换在未加密连接中对于使用 sha256_password 或 caching_sha2_password 插件认证的账户；见 第 8.4.1.3 节，“SHA-256 可插拔认证”，和 第 8.4.1.2 节，“Caching SHA-2 可插拔认证”。

有关 RSA 文件自动生成的更多信息，包括文件名和特征，请参阅 第 8.3.3.1 节，“使用 MySQL 创建 SSL 和 RSA 证书和密钥”

auto_generate_certs 系统变量与之相关，但控制 SSL 证书和密钥文件的自动生成，以便使用 SSL 进行安全连接。

caching_sha2_password_private_key_path

该变量指定了 caching_sha2_password 认证插件的 RSA 私钥文件的路径名。如果文件名指定为相对路径，则相对于服务器数据目录进行解释。文件必须是 PEM 格式。

有关 caching_sha2_password 的信息，请参阅 第 8.4.1.2 节，“Caching SHA-2 可插拔认证”。

caching_sha2_password_public_key_path

该变量指定了 caching_sha2_password 认证插件的 RSA 公钥文件的路径名。如果文件名指定为相对路径，则相对于服务器数据目录进行解释。文件必须是 PEM 格式。

有关 caching_sha2_password 的信息，包括客户端请求 RSA 公钥的信息，请参阅 第 8.4.1.2 节，“Caching SHA-2 可插拔认证”。

character_set_client

客户端发送的语句的字符集。会话变量的值是根据客户端连接服务器时请求的字符集设置的。(许多客户端支持 --default-character-set 选项，以便明确指定该字符集。另见 第 12.4 节，“连接字符集和排序规则”。)全局变量的值用于设置会话值，在客户端请求的值未知或不可用时，或者服务器配置为忽略客户端请求时。这可能发生在客户端请求服务器不支持的字符集时，例如日本启用客户端请求 sjis 时连接到不支持 sjis 的服务器。

有一些字符集不能用作客户端字符集。尝试使用它们作为 character_set_client 值将产生错误。见 不可用的客户端字符集。

character_set_connection

用于没有字符集引入符的文字和数字到字符串转换的字符集。关于引入符的信息，请参见 第 12.3.8 节，“字符集引入符”。

character_set_database

默认数据库使用的字符集。服务器在默认数据库更改时设置该变量。如果没有默认数据库，该变量的值与 character_set_server 相同。

设置该系统变量的会话值是一个受限操作。会话用户必须具有足够的权限来设置受限的会话变量。见 第 7.1.9.1 节，“系统变量权限”。

全局 character_set_database 和 collation_database 系统变量已弃用；预计它们将在未来版本的 MySQL 中被删除。

将值分配给会话 character_set_database 和 collation_database 系统变量已弃用，并且分配将产生警告。预计在未来版本的 MySQL 中，会话变量将变为只读的（并且分配将产生错误）。

character_set_filesystem

文件系统字符集。此变量用于解释字符串文字，例如在 LOAD DATA 和 SELECT ... INTO OUTFILE 语句和 LOAD_FILE() 函数中。这些文件名从 character_set_client 转换为 character_set_filesystem，然后尝试打开文件。默认值是 binary，这意味着不进行转换。对于允许多字节文件名的系统，可能需要不同的值。例如，如果系统使用 UTF-8 表示文件名，设置 character_set_filesystem 为 'utf8mb4'。

设置此系统变量的会话值是一个受限操作。会话用户必须具有足够的权限来设置受限会话变量。见 第 7.1.9.1 节，“系统变量权限”。

character_set_results

用于将查询结果返回给客户端的字符集。这包括结果数据，如列值、结果元数据，如列名和错误消息。

character_set_server

服务器的默认字符集。见 第 12.15 节，“字符集配置”。如果您设置了这个变量，也应该设置 collation_server 以指定字符集的排序规则。

character_set_system

服务器用于存储标识符的字符集。该值始终是 utf8mb3。

character_sets_dir

字符集安装的目录。见 第 12.15 节，“字符集配置”。

check_proxy_users

一些身份验证插件为自己实现了代理用户映射（例如 PAM 和 Windows 身份验证插件）。其他身份验证插件不支持代理用户，默认情况下。这些插件中的一些可以请求 MySQL 服务器根据授予的代理权限映射代理用户：mysql_native_password、sha256_password。

如果启用了check_proxy_users系统变量，服务器将为任何请求代理用户映射的身份验证插件执行代理用户映射。然而，可能还需要启用插件特定的系统变量以利用服务器的代理用户映射支持：

有关用户代理的信息，请参阅第 8.2.19 节，“代理用户”。

collation_connection

连接字符集的排序规则。collation_connection对于文字字符串的比较非常重要。对于列值的字符串比较，collation_connection不重要，因为列有其自己的排序规则，该排序规则具有更高的排序优先级（见第 12.8.4 节，“表达式中的排序强制”）。

使用用户定义的排序规则名称为该变量将引发警告。

collation_database

默认数据库使用的排序规则。服务器在默认数据库更改时设置该变量。如果没有默认数据库，该变量的值与collation_server相同。

全局character_set_database和collation_database系统变量已弃用；预计它们将在未来版本的 MySQL 中被删除。

将值分配给会话character_set_database和collation_database系统变量已弃用，并且分配将产生警告。预计这些会话变量将在未来版本的 MySQL 中变为只读（并且分配将产生错误），以便继续访问会话变量以确定默认数据库的字符集和排序规则。

使用用户定义的排序规则名称为collation_database将引发警告。

collation_server

服务器的默认排序规则。请参阅第 12.15 节，“字符集配置”。

将用户定义的排序规则名称设置为该变量将引发警告。

completion_type

事务完成类型。该变量可以采用以下表格所示的值。变量可以使用名称值或对应的整数值分配。

completion_type 影响以 START TRANSACTION 或 BEGIN 开始并以 COMMIT 或 ROLLBACK 结束的事务。它不适用于隐式提交，例如执行以下语句时：Section 15.3.3, “Statements That Cause an Implicit Commit”。它也不适用于 XA COMMIT, XA ROLLBACK, 或者当 autocommit=1。

component_scheduler.enabled

当在启动时设置为 OFF，后台线程不会启动。任务仍然可以被安排，但它们不会运行，直到 component_scheduler 被启用。当在启动时设置为 ON，组件将完全运作。

也可以动态地设置该值，以获得以下效果：

concurrent_insert

如果 AUTO(默认)，MySQL 允许 INSERT 和 SELECT 语句并发运行对于 MyISAM 表没有空闲块的中间数据文件。

该变量可以采用以下表格所示的值。变量可以使用名称值或对应的整数值分配。

如果您使用 mysqld 选项 --skip-new，concurrent_insert 将被设置为 从不。

另请参阅 第 10.11.3 节，“并发插入”。

connect_timeout

mysqld 服务器等待连接包之前响应 Bad handshake 的秒数。默认值为 10 秒。

增加 connect_timeout 值可能有助于客户端经常遇到错误，如 Lost connection to MySQL server at 'XXX', system error: errno。

connection_memory_chunk_size

设置全局内存使用情况计数器 Global_connection_memory 的块大小。状态变量仅在所有用户连接的总内存消耗改变超过该值时更新。禁用更新通过设置 connection_memory_chunk_size = 0。

内存计算不包括系统用户（如 MySQL 根用户）使用的内存，也不包括 InnoDB 缓冲池使用的内存。

您必须拥有 SYSTEM_VARIABLES_ADMIN 或 SUPER 权限来设置该变量。

connection_memory_limit

设置单个用户连接可以使用的最大内存量。如果任何用户连接使用超过此金额，来自该连接的所有查询将被拒绝，包括当前正在运行的查询。

此变量设置的限制不适用于系统用户或 MySQL 根账户。InnoDB 缓冲池使用的内存也不包括在内。

您必须拥有 SYSTEM_VARIABLES_ADMIN 或 SUPER 权限才能设置此变量。

core_file

如果服务器意外退出，是否写入核心文件。此变量由 --core-file 选项设置。

create_admin_listener_thread

是否使用专用监听线程来处理管理网络接口的客户端连接（见 第 7.1.12.1 节，“连接接口”）。默认为 OFF，即管理器线程也处理普通连接的管理接口。

根据平台类型和工作负载等因素，您可能发现某个设置对性能的影响。

设置 create_admin_listener_thread 变量无效，如果 admin_address 未指定，因为在那种情况下服务器不维护管理网络接口。

cte_max_recursion_depth

公共表表达式（CTE）最大递归深度。服务器将终止执行任何递归超过此变量值的 CTE。有关更多信息，请参阅 限制公共表表达式递归。

datadir

MySQL 服务器数据目录的路径。相对路径将相对于当前目录解析。如果您期望服务器自动启动（即，在无法预先知道当前目录的上下文中），最好将 datadir 值指定为绝对路径。

debug

该变量指示当前的调试设置。它仅适用于带调试支持的服务器。初始值来自服务器启动时的 --debug 选项的值。全局和会话值可以在运行时设置。

设置该系统变量的会话值是一个受限操作。会话用户必须具有足够的权限来设置受限的会话变量。见 第 7.1.9.1 节，“系统变量权限”。

将值设置为以 + 或 - 开头将导致值被添加到或从当前值中减去：

mysql> SET debug = 'T';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| T       |
+---------+

mysql> SET debug = '+P';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| P:T     |
+---------+

mysql> SET debug = '-P';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| T       |
+---------+

有关更多信息，请参阅 第 7.9.4 节，“DBUG 包”。

debug_sync

该变量是 Debug Sync 设施的用户界面。使用 Debug Sync 需要 MySQL 配置了 -DWITH_DEBUG=ON CMake 选项（见 第 2.8.7 节，“MySQL 源代码配置选项”）；否则，该系统变量不可用。

全局变量值是只读的，指示该设施是否启用。默认情况下，Debug Sync 是禁用的，debug_sync 的值是 OFF。如果服务器以 --debug-sync-timeout=N 启动，其中 N 是大于 0 的超时值，Debug Sync 将启用，debug_sync 的值将是 ON - current signal，后跟信号名称。此外，N 将成为单个同步点的默认超时值。

会话值可以由任何用户读取，具有与全局变量相同的值。会话值可以设置以控制同步点。

设置该系统变量的会话值是一个受限操作。会话用户必须具有足够的权限来设置受限的会话变量。见 第 7.1.9.1 节，“系统变量权限”。

有关 Debug Sync 设施的描述和如何使用同步点，请参阅 MySQL Internals: 测试同步。

default_authentication_plugin

默认身份验证插件。这必须是一个使用内部凭证存储的插件，因此这些值是允许的：

关于哪些身份验证插件使用内部凭证存储的信息，请参阅第 8.2.15 节，“密码管理”。

default_authentication_plugin 与authentication_policy 系统变量一起使用，但优先级较低。详细信息，请参阅默认身份验证插件。default_authentication_plugin 已弃用，将在未来 MySQL 版本中删除。

default_collation_for_utf8mb4

该变量由服务器设置为 utf8mb4 字符集的默认排序规则。变量的值从源服务器复制到副本服务器，以便副本服务器可以正确处理来自源服务器的数据，该源服务器具有不同的默认排序规则 utf8mb4。该变量主要用于支持从 MySQL 5.7 或更早版本的复制源服务器到 MySQL 8.0 或更高版本的副本服务器的复制，或者在 MySQL 5.7 主节点和一个或多个 MySQL 8.0 或更高版本的辅助节点的组复制中。 utf8mb4 在 MySQL 5.7 中的默认排序规则是 utf8mb4_general_ci，但在后续版本系列中是 utf8mb4_0900_ai_ci。如果副本服务器没有收到变量的值，它假设源服务器来自早期版本，并将值设置为之前的默认排序规则 utf8mb4_general_ci。

默认 utf8mb4 排序规则用于以下语句：

另请参阅 第 12.9 节，“Unicode 支持”。

default_password_lifetime

该变量定义了全局自动密码过期策略。默认 default_password_lifetime 值为 0，表示禁用自动密码过期。如果 default_password_lifetime 的值是一个正整数 N，则表示允许的密码生命周期；密码必须每 N 天更改一次。

全局密码过期策略可以根据需要被个体账户覆盖，使用 CREATE USER 和 ALTER USER 语句的密码过期选项。见 第 8.2.15 节，“密码管理”。

default_storage_engine

表的默认存储引擎。见 第 18 章，《替代存储引擎》。该变量仅设置永久表的存储引擎。要设置临时表的存储引擎，请设置 default_tmp_storage_engine 系统变量。

要查看可用的存储引擎和启用的引擎，请使用 SHOW ENGINES 语句或查询 INFORMATION_SCHEMA ENGINES 表。

如果您在服务器启动时禁用默认存储引擎，则必须将永久表和临时表的默认引擎设置为不同的引擎，否则服务器将不启动。

default_table_encryption

定义了在创建模式和通用表空间时应用的默认加密设置，除非指定了 ENCRYPTION 子句。

变量 default_table_encryption 仅适用于用户创建的模式和通用表空间，不适用于 mysql 系统表空间。

设置 default_table_encryption 的运行时值需要 SYSTEM_VARIABLES_ADMIN 和 TABLE_ENCRYPTION_ADMIN 权限，或者弃用的 SUPER 权限。

default_table_encryption 支持 SET PERSIST 和 SET PERSIST_ONLY 语法。见 第 7.1.9.3 节，“持久系统变量”。

更多信息，请参阅 定义模式和通用表空间的加密默认值。

default_tmp_storage_engine

默认存储引擎为 TEMPORARY 表（使用 CREATE TEMPORARY TABLE 创建）。要设置永久表的存储引擎，请设置 default_storage_engine 系统变量。也可以查看该变量的讨论，以了解可能的值。

如果您在服务器启动时禁用默认存储引擎，则必须将永久表和 TEMPORARY 表的默认引擎设置为不同的引擎，否则服务器将无法启动。

default_week_format

用于 WEEK() 函数的默认模式值。请参阅 第 14.7 节，“日期和时间函数”。

delay_key_write

该变量指定如何使用延迟键写入。它仅适用于 MyISAM 表。延迟键写入会导致键缓冲区在写入之间不被刷新。请参阅 第 18.2.1 节，“MyISAM 启动选项”。

该变量可以具有以下值，以影响 DELAY_KEY_WRITE 表选项，该选项可以在 CREATE TABLE 语句中使用。

如果 DELAY_KEY_WRITE 为启用状态，则键缓冲区不会在每次索引更新时刷新，而是在表关闭时刷新。这将大大加速键写入，但是如果您使用此功能，应该通过设置 myisam_recover_options 系统变量（例如，myisam_recover_options='BACKUP,FORCE'）来自动检查所有 MyISAM 表。请参阅 第 7.1.8 节，“服务器系统变量” 和 第 18.2.1 节，“MyISAM 启动选项”。

如果您使用 mysqld 启动时带有 --skip-new，则 delay_key_write 将被设置为 OFF。

延迟插入限制

该系统变量已弃用（因为DELAYED插入不受支持），您应该期望它在未来版本中被删除。

延迟插入超时

该系统变量已弃用（因为DELAYED插入不受支持），您应该期望它在未来版本中被删除。

延迟队列大小

该系统变量已弃用（因为DELAYED插入不受支持），您应该期望它在未来版本中被删除。

禁用存储引擎

该变量指示哪些存储引擎不能用于创建表或表空间。例如，要防止创建新的MyISAM或FEDERATED表，启动服务器时在服务器选项文件中添加以下行：

[mysqld]
disabled_storage_engines="MyISAM,FEDERATED"

默认情况下，禁用存储引擎为空（无引擎禁用），但可以设置为以逗号分隔的引擎列表（不区分大小写）。任何在值中命名的引擎都不能用于创建表或表空间，使用CREATE TABLE或CREATE TABLESPACE，也不能与ALTER TABLE ... ENGINE或ALTER TABLESPACE ... ENGINE一起使用以更改现有表或表空间的存储引擎。尝试这样做将导致ER_DISABLED_STORAGE_ENGINE错误。

禁用存储引擎 不限制其他 DDL 语句对现有表的操作，例如 CREATE INDEX、 TRUNCATE TABLE、 ANALYZE TABLE、 DROP TABLE 或 DROP TABLESPACE。这允许现有表或表空间平滑过渡，以便使用禁用引擎的表或表空间可以迁移到允许的引擎，例如使用 ALTER TABLE ... ENGINE permitted_engine。

允许设置 default_storage_engine 或 default_tmp_storage_engine 系统变量为禁用引擎。这可能会导致应用程序行为不稳定或失败，尽管这可能是在开发环境中识别使用禁用引擎的应用程序，以便修改它们。

禁用存储引擎 在服务器启动时禁用，并且没有效果，如果服务器使用以下选项启动：--initialize、 --initialize-insecure、 --skip-grant-tables。

断开过期密码

该变量控制服务器如何处理具有过期密码的客户端：

有关客户端和服务器设置之间的交互的更多信息，请参阅 第 8.2.16 节，“服务器处理过期密码”。

除法精度增量

该变量指示了除法操作的结果的精度增加的位数，使用/运算符。默认值为4。最小值和最大值分别为0和30。以下示例说明了增加默认值的效果。

mysql> SELECT 1/7;
+--------+
| 1/7    |
+--------+
| 0.1429 |
+--------+
mysql> SET div_precision_increment = 12;
mysql> SELECT 1/7;
+----------------+
| 1/7            |
+----------------+
| 0.142857142857 |
+----------------+

dragnet.log_error_filter_rules

该变量控制错误日志过滤器组件的过滤规则log_filter_dragnet。如果log_filter_dragnet未安装，dragnet.log_error_filter_rules不可用。如果log_filter_dragnet已安装但未启用，dragnet.log_error_filter_rules的更改无效。

默认值的效果类似于log_sink_internal过滤器的设置log_error_verbosity=2。

dragnet.Status状态变量可以用来确定dragnet.log_error_filter_rules的最新分配结果。

enterprise_encryption.maximum_rsa_key_size

该变量限制了MySQL Enterprise Encryption生成的RSA密钥的最大大小。该变量仅在MySQL Enterprise Encryption组件component_enterprise_encryption安装时可用。如果使用openssl_udf共享库提供MySQL Enterprise Encryption函数，该变量不可用。

最低设置为2048位，这是当前最佳实践中RSA密钥的最小长度。默认设置为4096位。最高设置为16384位。生成更长的密钥可能会消耗大量CPU资源，因此可以使用该设置来限制密钥长度，以平衡安全性和资源使用情况。请注意，openssl_udf共享库提供的函数允许从1024位开始的密钥长度，在升级到该组件后，密钥的最小长度将大于此。请参阅第8.6.2节，“配置MySQL Enterprise Encryption”以获取更多信息。

enterprise_encryption.rsa_support_legacy_padding

该变量控制了MySQL Enterprise Encryption使用openssl_udf共享库函数生成的加密数据和签名是否可以被MySQL Enterprise Encryption组件component_enterprise_encryption的函数解密或验证。该变量仅在MySQL Enterprise Encryption组件安装时可用，并且在使用openssl_udf共享库提供MySQL Enterprise Encryption函数时不可用。

对于组件函数支持解密和验证由遗留的 openssl_udf 共享库函数生成的内容，您必须将系统变量 padding 设置为 ON。当 ON 设置时，如果组件函数无法解密或验证内容时假设它具有 RSAES-OAEP 或 RSASSA-PSS 方案（如组件使用），它们将尝试假设它具有 RSAES-PKCS1-v1_5 或 RSASSA-PKCS1-v1_5 方案（如 openssl_udf 共享库函数使用）。当 OFF 设置时，如果组件函数无法解密或验证内容时使用其正常方案，它们将返回 null 输出。请参阅 第 8.6.2 节，“配置 MySQL 企业加密” 以获取更多信息。

end_markers_in_json

是否在优化器 JSON 输出中添加结束标记。请参阅 MySQL Internals：end_markers_in_json 系统变量。

eq_range_index_dive_limit

该变量指示了在等式范围比较条件中，优化器应该从使用索引dives 切换到使用索引统计信息来估算合格行数的等式范围数。如果 eq_range_index_dive_limit 大于 0，则优化器将使用现有的索引统计信息，而不是索引dives，以估算合格行数。

col_name IN(val1, ..., valN)
col_name = val1 OR ... OR col_name = valN

在这两种情况下，表达式都包含 N 等式范围。优化器可以使用索引dives 或索引统计信息来估算行数。如果 eq_range_index_dive_limit 大于 0，优化器将使用现有的索引统计信息，而不是索引dives，以估算合格行数。因此，要允许使用索引dives 对于最多 N 等式范围，设置 eq_range_index_dive_limit 为 N + 1。要禁用索引统计信息的使用并总是使用索引dives，不管 N 的值如何，设置 eq_range_index_dive_limit 为 0。

有关更多信息，请参阅 等式范围优化。

要更新表索引统计信息以获取最佳估算，请使用 ANALYZE TABLE。

error_count

最后一条生成消息的语句的错误数。该变量是只读的。请参阅 第 15.7.7.18 节，“SHOW ERRORS 语句”。

event_scheduler

该变量启用或禁用事件计划程序，并启动或停止事件计划程序。可能的状态值为 ON、OFF 和 DISABLED。将事件计划程序设置为 OFF 不同于禁用事件计划程序，后者需要将状态设置为 DISABLED。该变量及其对事件计划程序操作的影响在 第 27.4.2 节，“事件计划程序配置” 中有更详细的讨论。

explain_format

该变量确定在不指定 FORMAT 选项时 EXPLAIN 的默认输出格式。可能的值及其效果如下所示：

该变量的设置也影响 EXPLAIN ANALYZE。为此目的，DEFAULT 和 TRADITIONAL 被解释为 TREE。如果 explain_format 的值为 JSON，并且没有 FORMAT 选项的 EXPLAIN ANALYZE 语句被发出，则该语句将引发错误 (ER_NOT_SUPPORTED_YET）。

使用格式说明符与 EXPLAIN 或 EXPLAIN ANALYZE 将覆盖 explain_format 的设置。

该变量对 EXPLAIN 输出没有影响，当该语句用于显示表列信息时。

设置会话值 explain_format 不需要特殊权限；设置全局值需要 SYSTEM_VARIABLES_ADMIN（或已弃用的 SUPER 权限）。见 第 7.1.9.1 节，“系统变量权限”。

更多信息和示例，请参阅 获取执行计划信息。

explain_json_format_version

确定 EXPLAIN FORMAT=JSON 语句使用的 JSON 输出格式的版本。将此变量设置为 1 将导致服务器使用 Version 1，该格式始终用于 MySQL 8.2 及更早版本的输出。该版本是 MySQL 8.3 的默认版本。将 explain_json_format_version 设置为 2 将导致使用 Version 2 格式；该 JSON 输出格式基于访问路径，旨在提供与未来版本的 MySQL 优化器的更好兼容性。

有关使用示例，请参阅 获取执行计划信息。

explicit_defaults_for_timestamp

该系统变量确定服务器是否启用某些非标准行为，以处理 TIMESTAMP 列的默认值和 NULL 值处理。默认情况下，explicit_defaults_for_timestamp 已启用，禁用了非标准行为。禁用 explicit_defaults_for_timestamp 将导致警告。

如果 explicit_defaults_for_timestamp 被禁用，服务器将启用非标准行为，并处理 TIMESTAMP 列如下：

这些非标准行为将被弃用；预计它们将在未来 MySQL 版本中被删除。

如果 explicit_defaults_for_timestamp 已启用，服务器将禁用非标准行为，并处理 TIMESTAMP 列如下：

如果在服务器启动时禁用了 explicit_defaults_for_timestamp，则会在错误日志中出现警告：

[Warning] TIMESTAMP with implicit DEFAULT value is deprecated.
Please use --explicit_defaults_for_timestamp server option (see
documentation for more details).

如警告所示，要禁用弃用的非标准行为，请在服务器启动时启用 explicit_defaults_for_timestamp 系统变量。

有关更多信息，请参阅 第 13.2.5 节，“自动初始化和更新 TIMESTAMP 和 DATETIME”。

external_user

在身份验证过程中使用的外部用户名，如由插件设置的那样。在使用本机（内置）MySQL 身份验证或插件不设置该值时，该变量为 NULL。请参阅 第 8.2.19 节，“代理用户”。

flush

如果 ON, 服务器将在每个 SQL 语句后将所有更改刷新到磁盘。如果 查看 Section B.3.3.3, “如果 MySQL Keeps Crashing”。如果使用 mysqld 启动选项 --flush,则该变量将设置为 ON。

刷新时间

如果将其设置为非零值，则每 刷新时间 秒关闭所有表，以释放资源并将未刷新的数据同步到磁盘。此选项仅适用于资源有限的系统。

外键检查

如果设置为 1（默认值），则检查外键约束。如果设置为 0，则忽略外键约束，除了少数例外情况。在重新创建已删除的表时，如果表定义不符合外键约束，会返回错误。同样，ALTER TABLE 操作将返回错误，如果外键定义不正确。更多信息，请参阅 Section 15.1.20.5, “FOREIGN KEY 约束”。

将该变量设置为 0 对 NDB 表的影响与对 InnoDB 表的影响相同。通常情况下，在正常操作中启用外键检查，以强制 参照完整性。禁用外键检查可以在重新加载 InnoDB 表时有用，以便在不同的顺序中重新加载表，而不受父/子关系的限制。请参阅 Section 15.1.20.5, “FOREIGN KEY 约束”。

将 foreign_key_checks 设置为 0 也会影响数据定义语句：DROP SCHEMA 删除模式，即使该模式包含有外键引用的表，而 DROP TABLE 删除表，即使该表有外键引用的其他表。

ft_boolean_syntax

布尔全文搜索使用的运算符列表，使用 IN BOOLEAN MODE。见 第 14.9.2 节，“布尔全文搜索”。

默认变量值为 '+ -><()~*:""&|'。更改值的规则如下：

ft_max_word_len

在 MyISAM FULLTEXT 索引中包括的最大单词长度。

ft_min_word_len

在 MyISAM FULLTEXT 索引中包括的最小单词长度。

ft_query_expansion_limit

使用 WITH QUERY EXPANSION 进行的全文搜索的顶级匹配数。

ft_stopword_file

从中读取全文搜索的停止词列表的文件 MyISAM 表。服务器在数据目录中查找该文件，除非给定绝对路径名以指定不同的目录。该文件中的所有单词都将被使用；注释将被 忽略。默认情况下，使用内置的停止词列表（如 storage/myisam/ft_static.c 文件中定义的）。将该变量设置为空字符串 ('') 将禁用停止词过滤。另见 第 14.9.4 节，“全文停止词”。

general_log

是否启用通用查询日志。该值可以是 0（或 OFF）以禁用日志或 1（或 ON）以启用日志。日志输出的目标由 log_output 系统变量控制；如果该值为 NONE，即使日志启用，也不会写入日志条目。

general_log_file

通用查询日志文件的名称。默认值是 host_name.log，但可以使用 --general_log_file 选项更改初始值。

generated_random_password_length

生成的随机密码的最大字符数，用于 CREATE USER、ALTER USER 和 SET PASSWORD 语句。更多信息，请参见 随机密码生成。

global_connection_memory_limit

设置所有用户连接的总内存使用量；即 Global_connection_memory 不应超过该值。任何时候该值超过该限制，所有用户查询（包括当前正在运行的查询）都将被拒绝，错误代码为 ER_GLOBAL_CONN_LIMIT。

系统用户（如 MySQL 根用户）的内存使用量也包括在该总量中，但不计入断开限制；这些用户永远不会因为内存使用量而断开连接。

内存由 InnoDB 缓冲池排除在总计之外。

您必须拥有 SYSTEM_VARIABLES_ADMIN 或 SUPER 权限来设置该变量。

global_connection_memory_tracking

确定服务器是否计算 Global_connection_memory。该变量必须被明确启用；否则，内存计算将不执行，Global_connection_memory 将不被设置。

您必须拥有 SYSTEM_VARIABLES_ADMIN 或 SUPER 权限来设置该变量。

group_concat_max_len

函数 GROUP_CONCAT() 的最大结果长度（以字节为单位）。默认值为 1024。

have_compress

YES 如果 zlib 压缩库可供服务器使用，NO 如果不可用。如果不可用，则无法使用 COMPRESS() 和 UNCOMPRESS() 函数。

have_dynamic_loading

YES 如果 mysqld 支持动态加载插件，NO 如果不支持。如果值为 NO，则无法使用选项如 --plugin-load 在服务器启动时加载插件，或者使用 INSTALL PLUGIN 语句在运行时加载插件。

have_geometry

YES 如果服务器支持空间数据类型，NO 如果不支持。

have_openssl

该变量是 have_ssl 的同义词。

have_openssl 已弃用，并将在未来 MySQL 版本中删除。有关 MySQL 连接接口的 TLS 属性，请参阅 tls_channel_status 表。

have_profiling

YES 如果语句 profiling 能力存在，NO 如果不存在。如果存在，profiling 系统变量控制该能力是否启用或禁用。请参阅 第 15.7.7.33 节，“SHOW PROFILES 语句”。

该变量已弃用，并且您应该期望它在未来MySQL版本中被删除。

have_query_cache

have_query_cache 已弃用，始终具有 NO 的值，并且您应该期望它在未来MySQL版本中被删除。

have_rtree_keys

YES 如果 RTREE 索引可用， NO 如果不可用。（这些用于 MyISAM 表中的空间索引。）

have_ssl

YES 如果 mysqld 支持 SSL 连接， DISABLED 如果服务器被编译以支持 SSL，但未使用适当的连接加密选项启动。有关更多信息，请参阅 第 2.8.6 节，“配置 SSL 库支持”。

have_ssl 已弃用，并且您应该期望它在未来 MySQL 版本中被删除。有关 MySQL 连接接口的 TLS 属性的信息，请参阅 tls_channel_status 表格。

have_statement_timeout

是否启用语句执行超时功能（请参阅 语句执行时间优化器提示）。该值可以是 NO 如果该功能使用的后台线程无法初始化。

have_symlink

YES 如果符号链接支持启用， NO 如果不可用。这在 Unix 上是必需的，以支持 DATA DIRECTORY 和 INDEX DIRECTORY 表选项。如果服务器使用 --skip-symbolic-links 选项启动，该值为 DISABLED。

该变量在 Windows 上没有意义。

histogram_generation_max_mem_size

生成histogram统计信息的最大内存量。见第10.9.6节，“优化器统计信息”，和第15.7.3.1节，“ANALYZE TABLE语句”。

设置会话值的这个系统变量是一个受限操作。会话用户必须具有足够的权限来设置受限会话变量。见第7.1.9.1节，“系统变量权限”。

主机缓存大小

MySQL服务器维护一个内存中的主机缓存，该缓存包含客户端主机名和IP地址信息，并用于避免域名系统（DNS）查找；见第7.1.12.3节，“DNS查找和主机缓存”。

该主机缓存大小变量控制主机缓存的大小，以及性能架构主机缓存表的大小，该表公开了缓存内容。设置主机缓存大小具有以下效果：

默认值是自动调整到128，加上max_connections的值，直到500，加上max_connections值每增加20的值，限制在2000。

主机名

服务器在启动时将该变量设置为服务器主机名。最大长度为255个字符。

身份

该变量是last_insert_id变量的同义词。它存在于与其他数据库系统的兼容性中。你可以使用SELECT @@identity读取其值，并使用SET identity设置它。

初始化连接

一个字符串，服务器将其执行以连接每个客户端。该字符串由一个或多个SQL语句组成，使用分号字符分隔。

对于拥有CONNECTION_ADMIN特权（或已弃用的SUPER特权）的用户，init_connect的内容不会被执行。这是为了防止init_connect的错误值阻止所有客户端连接。例如，值可能包含语法错误的语句，从而导致客户端连接失败。不执行init_connect对于拥有CONNECTION_ADMIN或SUPER特权的用户，使他们能够打开连接并修复init_connect值。

init_connect执行将被跳过，对于任何客户端用户的过期密码。这是因为这样的用户无法执行任意语句，因此init_connect执行失败，导致客户端无法连接。跳过init_connect执行使用户能够连接并更改密码。

服务器将丢弃init_connect值中的语句产生的任何结果集。

information_schema_stats_expiry

一些INFORMATION_SCHEMA表包含提供表统计信息的列：

STATISTICS.CARDINALITY
TABLES.AUTO_INCREMENT
TABLES.AVG_ROW_LENGTH
TABLES.CHECKSUM
TABLES.CHECK_TIME
TABLES.CREATE_TIME
TABLES.DATA_FREE
TABLES.DATA_LENGTH
TABLES.INDEX_LENGTH
TABLES.MAX_DATA_LENGTH
TABLES.TABLE_ROWS
TABLES.UPDATE_TIME

这些列表示动态表元数据，即随着表内容的变化而变化的信息。

默认情况下，MySQL 从mysql.index_stats和mysql.table_stats词典表中检索缓存的值，以便查询这些列，这比从存储引擎中检索统计信息更高效。如果缓存的统计信息不可用或已过期，MySQL 将从存储引擎中检索最新的统计信息，并将其缓存在mysql.index_stats和mysql.table_stats词典表中。随后的查询将检索缓存的统计信息，直到缓存的统计信息过期。服务器重启或第一次打开mysql.index_stats和mysql.table_stats表不会自动更新缓存的统计信息。

会话变量information_schema_stats_expiry定义了缓存统计信息的过期时间。默认为 86400 秒（24 小时），但时间期限可以延长到一年。

要在任何时候更新缓存值，对于给定的表，使用ANALYZE TABLE。

要始终从存储引擎中检索最新的统计信息，并绕过缓存的值，设置information_schema_stats_expiry为0。

查询统计信息列不会在以下情况下存储或更新mysql.index_stats和mysql.table_stats词典表中的统计信息：

统计缓存可能在多语句事务中更新，在事务提交前不知道。这可能会导致缓存包含不对应于已知提交状态的信息。这可以在 autocommit=0 或 START TRANSACTION 后发生。

information_schema_stats_expiry 是一个会话变量，每个客户会话可以定义其自己的过期值。从存储引擎检索并缓存的统计信息对其他会话可用。

有关信息，请参阅 第 10.2.3 节，“优化 INFORMATION_SCHEMA 查询”。

init_file

如果指定了该变量，将在启动过程中读取和执行包含 SQL 语句的文件。该文件支持以下构造：

如果服务器以 --initialize 或 --initialize-insecure 选项启动，则它处于引导模式，某些功能不可用，限制了文件中的语句。这些语句包括与账户管理相关的语句（例如 CREATE USER 或 GRANT），复制和全局事务标识符。请参阅 第 19.1.3 节，“使用全局事务标识符的复制”。

在服务器启动期间创建的线程用于执行任务，如创建数据字典、运行升级过程和创建系统表。为了确保稳定和可预测的环境，这些线程使用服务器内置的默认值执行，例如 sql_mode、character_set_server、collation_server、completion_type、explicit_defaults_for_timestamp 和 default_table_encryption。

这些线程还用于执行启动服务器时指定的文件中的语句，以 init_file，因此这些语句将使用服务器内置的默认值执行。

innodb_xxx

InnoDB 系统变量列在 第 17.14 节，“InnoDB 启动选项和系统变量”。这些变量控制了 InnoDB 表的许多方面，包括存储、内存使用和 I/O 模式，现在 InnoDB 是默认的存储引擎。

insert_id

用于以下 INSERT 或 ALTER TABLE 语句插入自动递增值的值。这主要用于二进制日志。

interactive_timeout

服务器在关闭交互式连接之前等待活动的秒数。交互式客户端定义为使用 CLIENT_INTERACTIVE 选项的客户端 mysql_real_connect()。见 also wait_timeout。

internal_tmp_mem_storage_engine

内存内部临时表的存储引擎（见 第 10.4.4 节，“MySQL 中的内部临时表使用”）。允许的值是 TempTable（默认）和 MEMORY。

优化器使用 internal_tmp_mem_storage_engine 定义的存储引擎来处理内存内部临时表。

配置会话设置 internal_tmp_mem_storage_engine 需要 SESSION_VARIABLES_ADMIN 或 SYSTEM_VARIABLES_ADMIN 权限。

join_buffer_size

最小的缓冲区大小，用于普通索引扫描、范围索引扫描和不使用索引的连接，从而执行完整的表扫描。此变量还控制哈希连接所使用的内存量。通常，获取快速连接的最好方法是添加索引。增加join_buffer_size的值，以获取更快的完整连接，当添加索引不可行时。

默认值为 256KB。允许的最大设置为 4GB−1。对于 64 位平台（除 64 位 Windows 外，large 值将被截断为 4GB−1 并发出警告）。块大小为 128，MySQL 服务器在存储系统变量之前将值舍入到下一个块大小的倍数。

除非使用 Block Nested-Loop 或 Batched Key Access 算法，否则将缓冲区设置得太大不会带来任何好处，所有连接至少分配最小大小，因此请小心地将该变量设置为大值全局。更好的是将全局设置保持小，并在需要大连接的会话中更改会话设置，或者使用 SET_VAR 优化器提示（见 第 10.9.3 节，“优化器提示”）。内存分配时间可能会导致性能下降，如果全局大小大于大多数查询所需的大小。

当使用 Block Nested-Loop 时，较大的连接缓冲区可能会有益，直到所有必要的列从第一表的所有行中存储在连接缓冲区中。这取决于查询；最佳大小可能小于持有第一表的所有行。

当使用 Batched Key Access 时，join_buffer_size 的值定义了每个请求中的批处理键的大小。缓冲区越大，对右侧表的顺序访问就越多，从而可以显著改善性能。

有关连接缓冲区的更多信息，请参阅 第 10.2.1.7 节，“Nested-Loop Join 算法”。有关 Batched Key Access 的信息，请参阅 第 10.2.1.12 节，“Block Nested-Loop 和 Batched Key Access 连接”。有关哈希连接的信息，请参阅 第 10.2.1.4 节，“哈希连接优化”。

keep_files_on_create

如果创建了一个没有 DATA DIRECTORY 选项的 MyISAM 表，在数据库目录中创建了 .MYD 文件。默认情况下，如果 MyISAM 在这种情况下找到现有的 .MYD 文件，它将覆盖该文件。同样，对于创建了没有 INDEX DIRECTORY 选项的表的 .MYI 文件也是如此。要抑制这种行为，请将 keep_files_on_create 变量设置为 ON (1)，在这种情况下，MyISAM 不会覆盖现有的文件，而是返回错误。默认值为 OFF (0)。

如果创建了一个带有 DATA DIRECTORY 或 INDEX DIRECTORY 选项的 MyISAM 表，并且找到现有的 .MYD 或 .MYI 文件，MyISAM 总是返回错误。它不会覆盖指定目录中的文件。

key_buffer_size

MyISAM 表的索引块被缓存并由所有线程共享。key_buffer_size 是用于索引块的缓冲区的大小。键缓存也称为键高速缓存。

最小允许设置为 0，但您不能在运行时将 key_buffer_size 设置为 0。将 key_buffer_size 设置为 0 只允许在启动时，在这种情况下键缓存不会被初始化。在运行时从 0 更改 key_buffer_size 设置为非零值将初始化键缓存。

key_buffer_size 只能以 4096 字节的增量或倍数增加或减少。以非符合值增加或减少设置将产生警告并将设置截断为符合值。

在 32 位平台上，key_buffer_size 的最大允许设置为 4GB-1。在 64 位平台上，允许更大的值。实际的最大大小可能小于可用物理 RAM 和操作系统或硬件平台施加的每进程 RAM 限制。该变量的值表示请求的内存量。内部，服务器将尽可能分配到该金额的内存，但实际分配可能小于该金额。

您可以增加该值以获得更好的索引处理所有读取和多写入；在主要运行 MySQL 的系统上，使用 MyISAM 存储引擎，机器总内存的 25% 是该变量的可接受值。然而，您应该注意，如果您使该值太大（例如，超过机器总内存的 50%），您的系统可能会开始分页并变得非常慢。这是因为 MySQL 依赖操作系统执行文件系统缓存以读取数据，因此您必须留出一些空间用于文件系统缓存。您还应该考虑其他存储引擎的内存要求，除了 MyISAM。

对于写入多行时的更多速度，请使用 LOCK TABLES。请参阅 第 10.2.5.1 节，“优化 INSERT 语句”。

您可以通过发出 SHOW STATUS 语句并检查 Key_read_requests、Key_reads、Key_write_requests 和 Key_writes 状态变量来检查键缓存的性能。（请参阅 第 15.7.7 节，“SHOW 语句”。）Key_reads/Key_read_requests 比率通常小于 0.01。Key_writes/Key_write_requests 比率通常接近 1，如果您主要使用更新和删除，或者如果您使用 DELAY_KEY_WRITE 表选项，可能会小得多。

可以使用 key_buffer_size 和 Key_blocks_unused 状态变量以及缓冲区块大小（可从 key_cache_block_size 系统变量中获得）来确定键缓存的使用率。

1 - ((Key_blocks_unused * key_cache_block_size) / key_buffer_size)

这个值是一个近似值，因为键缓冲区中的一些空间被内部分配用于管理结构。影响这些结构的开销的因素包括块大小和指针大小。随着块大小的增加，键缓冲区中损失的百分比趋于减少。较大的块将导致较少的读操作（因为每次读取更多的键），但相应地增加了读取不相关键的次数（如果块中的所有键都不是查询相关的）。

可以创建多个 MyISAM 键缓存。每个缓存的大小限制为 4GB，不是作为一个组。见 第 10.10.2 节，“MyISAM 键缓存”。

key_cache_age_threshold

该值控制键缓存的热子列表中的缓冲区被降级到温子列表中的速度。较低的值将导致降级发生得更快。最小值为 100。默认值为 300。见 第 10.10.2 节，“MyISAM 键缓存”。

key_cache_block_size

键缓存中的块大小，以字节为单位。默认值为 1024。见 第 10.10.2 节，“MyISAM 键缓存”。

key_cache_division_limit

键缓存缓冲区列表中的热子列表和温子列表之间的分界点。该值是温子列表的百分比。允许的值范围从 1 到 100。默认值为 100。见 第 10.10.2 节，“MyISAM 键缓存”。

large_files_support

是否 mysqld 编译了大文件支持选项。

large_pages

是否启用大页面支持（通过 --large-pages 选项）。见 第 10.12.3.3 节，“启用大页面支持”。

large_page_size

如果启用了大页面支持，这将显示内存页面的大小。大页面仅在 Linux 上受支持；在其他平台上，该变量的值始终为 0。见 第 10.12.3.3 节，“启用大页面支持”。

最后插入 ID

从 LAST_INSERT_ID() 返回的值。这将存储在二进制日志中，当您在更新表时使用 LAST_INSERT_ID()。设置该变量不会更新 mysql_insert_id() C API 函数返回的值。

错误消息语言

错误消息的语言。默认值为 en_US。服务器将参数转换为语言名称，并将其与 lc_messages_dir 的值组合，以生成错误消息文件的位置。见 第 12.12 节，“设置错误消息语言”。

错误消息目录

错误消息文件的目录。服务器将该值与 lc_messages 的值组合，以生成错误消息文件的位置。见 第 12.12 节，“设置错误消息语言”。

时间语言

该变量指定了控制日期和月份名称和缩写的语言。这将影响 DATE_FORMAT()、DAYNAME() 和 MONTHNAME() 函数的输出。语言名称是 POSIX 风格的值，例如 'ja_JP' 或 'pt_BR'。默认值为 'en_US'，无论系统的语言设置如何。详见 第 12.16 节，“MySQL 服务器语言支持”。

许可证

服务器的许可证类型。

本地 infile

此变量控制服务器端 LOCAL 能力对于 LOAD DATA 语句。根据 local_infile 设置，服务器拒绝或允许客户端加载本地数据，客户端启用了 LOCAL。

要明确地使服务器拒绝或允许 LOAD DATA LOCAL 语句（无论客户端程序和库如何在构建时或运行时配置），请使用 mysqld 启动时禁用或启用 local_infile。 local_infile 也可以在运行时设置。有关更多信息，请参阅 第 8.1.6 节，“LOAD DATA LOCAL 安全注意事项”。

lock_wait_timeout

该变量指定元数据锁的超时时间（以秒为单位）。允许的值范围从 1 到 31536000（1 年）。默认值为 31536000。

该超时时间适用于所有使用元数据锁的语句。这些包括 DML 和 DDL 操作、视图、存储过程和存储函数，以及 LOCK TABLES、FLUSH TABLES WITH READ LOCK 和 HANDLER 语句。

该超时时间不适用于系统表的隐式访问，例如 grant 表由 GRANT 或 REVOKE 语句修改的表，或者日志表语句。该超时时间适用于直接访问系统表，例如使用 SELECT 或 UPDATE。

超时值单独应用于每个元数据锁尝试。给定语句可能需要多个锁，因此语句可能会阻塞长于 lock_wait_timeout 值之前报告超时错误。当锁超时时，ER_LOCK_WAIT_TIMEOUT 将被报告。

lock_wait_timeout 也定义了 LOCK INSTANCE FOR BACKUP 语句等待锁定的时间。

locked_in_memory

是否 mysqld 使用 --memlock 锁定在内存中。

log_error

默认错误日志目标。如果目标是控制台，值为 stderr。否则，目标是一个文件，log_error 值是文件名。见 第 7.4.2 节，“错误日志”。

log_error_services

错误日志组件的启用列表。该变量可以包含 0、1 或多个元素的列表。在后一种情况下，元素可以用分号或逗号分隔，后跟空格。给定的设置不能同时使用分号和逗号分隔符。组件的顺序很重要，因为服务器按照列表顺序执行组件。

任何在 log_error_services 中命名的可加载（不是内置的）组件将隐式加载，如果它尚未加载。有关更多信息，请参阅 第 7.4.2.1 节，“错误日志配置”。

log_error_suppression_list

该 log_error_suppression_list 系统变量适用于错误日志中的事件，并指定了哪些事件在优先级为 WARNING 或 INFORMATION 时应被抑制。例如，如果某种类型的警告被认为是错误日志中的“噪音”，因为它经常发生但不感兴趣，可以将其抑制。该变量影响 log_filter_internal 错误日志过滤器组件的过滤操作，该组件默认启用（见 第 7.5.3 节，“错误日志组件”）。如果 log_filter_internal 被禁用，log_error_suppression_list 无效。

该 log_error_suppression_list 值可以为空字符串以不进行抑制，或者是一个或多个以逗号分隔的值，指示要抑制的错误代码。错误代码可以以符号或数字形式指定。数字代码可以带或不带 MY- 前缀。数字部分的前导零不重要。允许的代码格式示例：

ER_SERVER_SHUTDOWN_COMPLETE
MY-000031
000031
MY-31
31

符号值优于数字值，以提高可读性和可移植性。有关允许的错误符号和数字的信息，请参阅 MySQL 8.3 错误信息参考。

该 log_error_suppression_list 的效果与 log_error_verbosity 的效果结合。有关更多信息，请参阅 第 7.4.2.5 节，“基于优先级的错误日志过滤（log_filter_internal）”。

log_error_verbosity

该 log_error_verbosity 系统变量指定了错误日志的详细程度。此变量影响了 log_filter_internal 错误日志过滤器组件的过滤，后者默认启用（见 第 7.5.3 节，“错误日志组件”）。如果 log_filter_internal 被禁用，log_error_verbosity 无效。

意图写入错误日志的事件具有 ERROR、WARNING 或 INFORMATION 优先级。log_error_verbosity 根据允许写入日志的优先级控制详细程度，如下表所示。

还有一个 SYSTEM 优先级。系统消息关于非错误情况将被打印到错误日志，不管 log_error_verbosity 的值如何。这些消息包括启动和关闭消息，以及一些重要的设置更改。

log_error_verbosity 的效果与 log_error_suppression_list 的效果结合。有关更多信息，请参阅 第 7.4.2.5 节，“基于优先级的错误日志过滤（log_filter_internal）”。

log_output

通用查询日志和慢查询日志的目标或目标之一。该值是一个或多个以逗号分隔的单词，选择自 TABLE、FILE 和 NONE。 TABLE 选择记录到 general_log 和 slow_log 表中的 mysql 系统模式。 FILE 选择记录到日志文件。 NONE 禁用记录。如果 NONE 存在于值中，它将优先于其他单词。

该变量选择日志输出目标，但不启用日志输出。要启用日志输出，需要启用 general_log 和 slow_query_log 系统变量。对于 FILE 记录，general_log_file 和 slow_query_log_file 系统变量确定日志文件位置。有关更多信息，请参阅 第 7.4.1 节，“选择通用查询日志和慢查询日志输出目标”。

log_queries_not_using_indexes

如果启用该变量并启用慢查询日志，预计检索所有行的查询将被记录。参见第 7.4.5 节，“慢查询日志”。该选项并不一定意味着没有使用索引。例如，使用完整索引扫描的查询使用索引，但将被记录，因为索引不会限制行数。

log_raw

该 log_raw 系统变量最初设置为 --log-raw 选项的值。请参阅该选项的描述以获取更多信息。系统变量也可以在运行时设置以更改密码屏蔽行为。