MySQL5.7服务器系统变量(一)

发布时间：2023年12月27日

??官网地址：MySQL :: MySQL 5.7 Reference Manual :: 5.1.7 Server System Variables

欢迎关注留言，我是收集整理小能手，工具翻译，仅供参考，笔芯笔芯.

MySQL 5.7 参考手册??/??...??/??服务器系统变量

5.1.7 服务器系统变量

MySQL服务器维护着许多影响其运行的系统变量。大多数系统变量可以在服务器启动时使用命令行或选项文件中的选项进行设置。其中大多数可以使用?SET?语句在运行时动态更改，这使您能够修改服务器的操作，而无需停止并重新启动它。有些变量是只读的，它们的值由系统环境、MySQL 在系统上的安装方式或可能由用于编译 MySQL 的选项决定。大多数系统变量都有默认值，但也有例外，包括只读变量??。您还可以在表达式中使用系统变量值。

在运行时，设置全局系统变量值需要该?SUPER权限。设置会话系统变量值通常不需要特殊权限，并且可以由任何用户完成，但也有例外。有关更多信息，请参见第 5.1.8.1 节 “系统变量权限”

有多种方法可以查看系统变量的名称和值：

  • 要查看服务器根据其编译默认值及其读取的任何选项文件使用的值，请使用以下命令：

    mysqld --verbose --help

  • 要查看服务器仅根据其编译默认值使用的值，忽略任何选项文件中的设置，请使用以下命令：

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

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

本节提供每个系统变量的描述。有关系统变量汇总表，请参见?第 5.1.4 节 “服务器系统变量参考”。有关系统变量操作的更多信息，请参见?第 5.1.8 节 “使用系统变量”。

有关其他系统变量信息，请参阅以下部分：

笔记

以下一些变量描述涉及?“启用”或“禁用”变量。这些变量可以?SET?通过将它们设置为ON或 来使用语句启用1，或者通过将它们设置为?OFF或 来禁用0。布尔变量可以在启动时设置为值?ON、TRUE、?OFF和FALSE（不区分大小写）以及1和?0。请参见第 4.2.2.4 节“程序选项修饰符”。

一些系统变量控制缓冲区或高速缓存的大小。对于给定的缓冲区，服务器可能需要分配内部数据结构。这些结构通常是从分配给缓冲区的总内存中分配的，并且所需的空间量可能取决于平台。这意味着当您为控制缓冲区大小的系统变量分配值时，实际可用空间量可能与分配的值不同。在某些情况下，金额可能小于指定的值。服务器也可以向上调整值。例如，如果将值 0 分配给最小值为 1024 的变量，则服务器会将该值设置为 1024。

除非另有说明，缓冲区大小、长度和堆栈大小的值均以字节为单位给出。

笔记

某些系统变量描述包括块大小，在这种情况下，不是指定块大小整数倍的值在由服务器存储之前会向下舍入到块大小的下一个较小倍数，即?。?FLOOR(value)?*?block_size

示例：假设给定变量的块大小为 4096，并将该变量的值设置为 100000（我们假设该变量的最大值大于该数字）。由于 100000 / 4096 = 24.4140625，服务器会在存储之前自动将该值降低到 98304 (24 * 4096)。

在某些情况下，变量的规定最大值是 MySQL 解析器允许的最大值，但不是块大小的精确倍数。在这种情况下，有效最大值是块大小的下一个较小倍数。

示例：系统变量的最大值显示为 4294967295 (2?32?-1)，其块大小为 1024。4294967295 / 1024 = 4194303.9990234375，因此，如果将此变量设置为其规定的最大值，则实际存储的值为 4194303 * 1024 = 4294966272。

某些系统变量采用文件名值。除非另有指定，如果该值为相对路径名，则默认文件位置是数据目录。要显式指定位置，请使用绝对路径名。假设数据目录是?/var/mysql/data.?如果文件值变量作为相对路径名给出，则它位于?/var/mysql/data.?如果该值是绝对路径名，则其位置由路径名指定。

  • authentication_windows_log_level

    命令行格式--authentication-windows-log-level=#
    系统变量authentication_windows_log_level
    范围全球的
    动态的不
    类型整数
    默认值2
    最小值0
    最大值4

    authentication_windows仅当启用 Windows 身份验证插件并启用调试代码?时，此变量才可用 。请参见?第 6.4.1.8 节“Windows 可插入身份验证”。

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

    价值描述
    0没有日志记录
    1仅记录错误消息
    2日志级别 1 消息和警告消息
    3日志级别 2 消息和信息注释
    4日志级别 3 消息和调试消息

  • authentication_windows_use_principal_name

    命令行格式--authentication-windows-use-principal-name[={OFF|ON}]
    系统变量authentication_windows_use_principal_name
    范围全球的
    动态的不
    类型布尔值
    默认值ON

    authentication_windows仅当启用 Windows 身份验证插件?时，此变量才可用 。请参见?第 6.4.1.8 节“Windows 可插入身份验证”。

    使用该?InitSecurityContext()函数进行身份验证的客户端应提供一个字符串来标识其连接的服务 (?targetName)。MySQL 使用运行服务器的帐户的主体名称 (UPN)。UPN 有表格?，无需在任何地方注册即可使用。此 UPN 由服务器在身份验证握手开始时发送。?user_id@computer_name

    此变量控制服务器是否在初始质询中发送 UPN。默认情况下，该变量已启用。出于安全原因，可以禁用它以避免将服务器的帐户名以明文形式发送给客户端。如果禁用该变量，服务器始终?0x00在第一个质询中发送一个字节，客户端不指定targetName，因此使用 NTLM 身份验证。

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

  • autocommit

    命令行格式--autocommit[={OFF|ON}]
    系统变量autocommit
    范围全局、会话
    动态的是的
    类型布尔值
    默认值ON

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

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

    [mysqld]
autocommit=0

  • automatic_sp_privileges

    命令行格式--automatic-sp-privileges[={OFF|ON}]
    系统变量automatic_sp_privileges
    范围全球的
    动态的是的
    类型布尔值
    默认值ON

    当此变量的值为 1（默认值）时，?如果用户无法执行并更改或删除例程，服务器会自动向存储例程的创建者授予EXECUTE和 权限。ALTER ROUTINE（?ALTER ROUTINE删除例程需要该权限。）当例程被删除时，服务器还会自动删除创建者的这些权限。如果?automatic_sp_privileges为 0，服务器不会自动添加或删除这些权限。

    例程的创建者是用于执行?CREATE例程语句的帐户。DEFINER这可能与例程定义中?命名的帐户不同 。

    如果您使用 启动mysqld?，--skip-new则?automatic_sp_privileges设置为OFF。

    另请参见第 23.2.2 节“存储例程和 MySQL 权限”。

  • auto_generate_certs

    命令行格式--auto-generate-certs[={OFF|ON}]
    系统变量auto_generate_certs
    范围全球的
    动态的不
    类型布尔值
    默认值ON

    如果服务器是使用 OpenSSL 编译的，则此变量可用（请参见第 6.3.4 节 “SSL 库相关功能”）。它控制服务器是否在数据目录中自动生成 SSL 密钥和证书文件（如果它们尚不存在）。

    auto_generate_certs启动时，如果启用了系统变量，未?--ssl指定除其他 SSL 选项，并且数据中缺少服务器端?SSL 文件，则服务器会在数据目录中自动生成服务器端和客户端 SSL 证书和密钥文件?目录。这些文件使用 SSL 启用安全客户端连接；请参见?第 6.3.1 节“配置 MySQL 以使用加密连接”。

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

    系统?sha256_password_auto_generate_rsa_keys?变量是相关的，但控制通过未加密连接使用 RSA 进行安全密码交换所需的 RSA 密钥对文件的自动生成。

  • avoid_temporal_upgrade

    命令行格式--avoid-temporal-upgrade[={OFF|ON}]
    已弃用是的
    系统变量avoid_temporal_upgrade
    范围全球的
    动态的是的
    类型布尔值
    默认值OFF

    此变量控制是否ALTER TABLE隐式升级 5.6.4 之前格式的时间列（TIME、?DATETIME和?TIMESTAMP不支持小数秒精度的列）。升级此类列需要重建表，这会阻止使用可能适用于要执行的操作的快速更改。

    默认情况下禁用此变量。启用它会导致?ALTER TABLE不重建时间列，从而能够利用可能的快速更改。

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

  • back_log

    命令行格式--back-log=#
    系统变量back_log
    范围全球的
    动态的不
    类型整数
    默认值-1（表示自动调整大小；不要分配此文字值）
    最小值1
    最大值65535

    MySQL 可以拥有的未完成连接请求数。当 MySQL 主线程在很短的时间内收到大量连接请求时，这一点就会发挥作用。然后主线程需要一些时间（尽管很短）来检查连接并启动一个新线程。该?back_log值指示在 MySQL 暂时停止应答新请求之前的这段短时间内可以堆叠多少个请求。仅当您预计在短时间内有大量连接时，才需要增加此值。

    换句话说，该值是传入 TCP/IP 连接的侦听队列的大小。您的操作系统对此队列的大小有其自己的限制。Unix?listen()系统调用的手册页应该有更多详细信息。检查操作系统文档以了解此变量的最大值。back_log?不能设置高于您的操作系统限制。

    默认值基于以下公式，上限为 900：

    50 + (max_connections / 5)

  • basedir

    命令行格式--basedir=dir_name
    系统变量basedir
    范围全球的
    动态的不
    类型目录名称
    默认值configuration-dependent default

    MySQL 安装基目录的路径。

  • big_tables

    命令行格式--big-tables[={OFF|ON}]
    系统变量big_tables
    范围全局、会话
    动态的是的
    类型布尔值
    默认值OFF

    如果启用，服务器会将所有临时表存储在磁盘上而不是内存中。这可以防止需要大型临时表的操作出现大多数错误，但也会减慢内存表足以满足的查询速度。?The table?tbl_name?is fullSELECT

    新连接的默认值为?OFF（使用内存临时表）。通常，不需要启用此变量，因为服务器能够通过将内存用于小型临时表并根据需要切换到基于磁盘的表来自动处理大型结果集。

  • bind_address

    命令行格式--bind-address=addr
    系统变量bind_address
    范围全球的
    动态的不
    类型细绳
    默认值*

    MySQL 服务器在单个网络套接字上侦听 TCP/IP 连接。该套接字绑定到单个地址，但一个地址可以映射到多个网络接口。要指定地址，请?在服务器启动时设置，其中是 IPv4 或 IPv6 地址或主机名。如果?是主机名，服务器会将名称解析为 IP 地址并绑定到该地址。如果主机名解析为多个 IP 地址，则服务器将使用第一个 IPv4 地址（如果有），否则使用第一个 IPv6 地址。?bind_address=addraddraddr

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

    • 如果地址为*，则服务器接受所有服务器主机 IPv4 接口上的 TCP/IP 连接；如果服务器主机支持 IPv6，则接受所有 IPv6 接口上的 TCP/IP 连接。使用此地址允许所有服务器接口上的 IPv4 和 IPv6 连接。该值是默认值。

    • 如果地址为0.0.0.0，则服务器接受所有服务器主机 IPv4 接口上的 TCP/IP 连接。

    • 如果地址为::，则服务器接受所有服务器主机 IPv4 和 IPv6 接口上的 TCP/IP 连接。

    • 如果地址是 IPv4 映射地址，则服务器接受该地址的 TCP/IP 连接（采用 IPv4 或 IPv6 格式）。例如，如果服务器绑定到::ffff:127.0.0.1，则客户端可以使用--host=127.0.0.1或 进行连接--host=::ffff:127.0.0.1。

    • 如果地址是“常规”?IPv4 或 IPv6 地址（例如127.0.0.1或?::1），则服务器仅接受该 IPv4 或 IPv6 地址的 TCP/IP 连接。

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

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

    该变量对嵌入式服务器 ( ) 没有影响libmysqld，并且在嵌入式服务器内不可见。

  • block_encryption_mode

    命令行格式--block-encryption-mode=#
    系统变量block_encryption_mode
    范围全局、会话
    动态的是的
    类型细绳
    默认值aes-128-ecb

    此变量控制基于块的算法（例如 AES）的块加密模式。它影响?AES_ENCRYPT()和 的加密AES_DECRYPT()。

    block_encryption_mode采用格式值?，其中是密钥长度（以位为单位），是加密模式。该值不区分大小写。允许的?值为 128、192 和 256。允许的加密模式取决于 MySQL 是使用 OpenSSL 还是 yaSSL 编译的：?aes-keylen-modekeylenmodekeylen

    • 对于 OpenSSL，允许的mode?值为：ECB,?CBC,?CFB1,?CFB8,?CFB128,?OFB

    • 对于 yaSSL，允许的mode?值为：ECB,CBC

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

    SET block_encryption_mode = 'aes-256-cbc';

    block_encryption_mode如果尝试设置的值包含不受支持的密钥长度或 SSL 库不支持的模式，?则会发生错误 。

  • bulk_insert_buffer_size

    命令行格式--bulk-insert-buffer-size=#
    系统变量bulk_insert_buffer_size
    范围全局、会话
    动态的是的
    类型整数
    默认值8388608
    最小值0
    最大值（64 位平台）18446744073709551615
    最大值（32 位平台）4294967295
    单元字节/线程

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

  • character_set_client

    系统变量character_set_client
    范围全局、会话
    动态的是的
    类型细绳
    默认值utf8

    从客户端到达的语句的字符集。当客户端连接到服务器时，使用客户端请求的字符集设置该变量的会话值。（许多客户端支持一个?--default-character-set选项来显式指定该字符集。另请参见?第 10.4 节“连接字符集和排序规则”。）该变量的全局值用于在客户端请求的情况下设置会话值。值未知或不可用，或者服务器配置为忽略客户端请求：

    • 客户端请求服务器未知的字符集。例如，支持日语的客户端?sjis在连接到未配置支持的服务器时发出请求sjis。

    • 客户端的MySQL版本早于MySQL 4.1，因此不请求字符集。

    • mysqld是使用该?--skip-character-set-client-handshake?选项启动的，这会导致它忽略客户端字符集配置。这会重现 MySQL 4.0 的行为，如果您希望升级服务器而不升级所有客户端，这会非常有用。

    有些字符集不能用作客户端字符集。尝试将它们用作?character_set_client值会产生错误。请参阅?不允许的客户端字符集。

  • character_set_connection

    系统变量character_set_connection
    范围全局、会话
    动态的是的
    类型细绳
    默认值utf8

    用于在没有字符集引入器的情况下指定的文字以及用于数字到字符串转换的字符集。有关介绍人的信息，请参阅?第 10.3.8 节“字符集介绍人”。

  • character_set_database

    系统变量character_set_database
    范围全局、会话
    动态的是的
    类型细绳
    默认值latin1
    脚注该选项是动态的，但只能由服务器设置。您不应手动设置此变量。

    默认数据库使用的字符集。每当默认数据库发生更改时，服务器都会设置此变量。如果没有默认数据库，则该变量的值与 相同character_set_server。

    MySQL 5.7 中不推荐使用?全局 变量character_set_database和 系统变量；collation_database预计它们会在 MySQL 的未来版本中被删除。

    character_set_databaseMySQL 5.7 中不推荐为会话变量和 系统变量?赋值，?collation_database并且赋值会产生警告。您应该预期会话变量在 MySQL 的未来版本中将变为只读，并且赋值会产生错误，同时仍然可以访问会话变量以确定默认数据库的数据库字符集和排序规则。

  • character_set_filesystem

    命令行格式--character-set-filesystem=name
    系统变量character_set_filesystem
    范围全局、会话
    动态的是的
    类型细绳
    默认值binary

    文件系统字符集。此变量用于解释引用文件名的字符串文字，例如在LOAD DATAand?SELECT ... INTO OUTFILE语句和?LOAD_FILE()函数中。?在尝试打开文件之前，此类文件名会从 转换?character_set_client为 。character_set_filesystem默认值为?binary，表示不发生转换。对于允许多字节文件名的系统，不同的值可能更合适。例如，如果系统使用 UTF-8 表示文件名，则设置?character_set_filesystem为?'utf8mb4'.

  • character_set_results

    系统变量character_set_results
    范围全局、会话
    动态的是的
    类型细绳
    默认值utf8

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

  • character_set_server

    命令行格式--character-set-server=name
    系统变量character_set_server
    范围全局、会话
    动态的是的
    类型细绳
    默认值latin1

    服务器默认字符集。请参见?第 10.15 节“字符集配置”。如果设置此变量，还应该设置?collation_server指定字符集的排序规则。

  • character_set_system

    系统变量character_set_system
    范围全球的
    动态的不
    类型细绳
    默认值utf8

    服务器用于存储标识符的字符集。该值始终为utf8.

  • character_sets_dir

    命令行格式--character-sets-dir=dir_name
    系统变量character_sets_dir
    范围全球的
    动态的不
    类型目录名称

    安装字符集的目录。请参见?第 10.15 节“字符集配置”。

  • check_proxy_users

    命令行格式--check-proxy-users[={OFF|ON}]
    系统变量check_proxy_users
    范围全球的
    动态的是的
    类型布尔值
    默认值OFF

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

    如果check_proxy_users?启用系统变量，服务器将为发出此类请求的任何身份验证插件执行代理用户映射。但是，可能还需要启用特定于插件的系统变量才能利用服务器代理用户映射支持：

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

  • collation_connection

    系统变量collation_connection
    范围全局、会话
    动态的是的
    类型细绳

    连接字符集的排序规则。?collation_connection对于文字字符串的比较很重要。对于字符串与列值的比较，这?collation_connection并不重要，因为列有自己的排序规则，它具有更高的排序规则优先级（请参见?第 10.8.4 节，“表达式中的排序规则强制”）。

  • collation_database

    系统变量collation_database
    范围全局、会话
    动态的是的
    类型细绳
    默认值latin1_swedish_ci
    脚注该选项是动态的，但只能由服务器设置。您不应手动设置此变量。

    默认数据库使用的排序规则。每当默认数据库发生更改时，服务器都会设置此变量。如果没有默认数据库，则该变量的值与 相同?collation_server。

    MySQL 5.7 中不推荐使用?全局 变量character_set_database和 系统变量；collation_database预计它们会在 MySQL 的未来版本中被删除。

    character_set_databaseMySQL 5.7 中不推荐为会话变量和 系统变量?赋值，?collation_database并且赋值会产生警告。预计会话变量在 MySQL 的未来版本中将变为只读，并且赋值会产生错误，但仍然可以访问会话变量以确定默认数据库的数据库字符集和排序规则。

  • collation_server

    命令行格式--collation-server=name
    系统变量collation_server
    范围全局、会话
    动态的是的
    类型细绳
    默认值latin1_swedish_ci

    服务器的默认排序规则。请参见?第 10.15 节“字符集配置”。

  • completion_type

    命令行格式--completion-type=#
    系统变量completion_type
    范围全局、会话
    动态的是的
    类型枚举
    默认值NO_CHAIN
    有效值

    NO_CHAIN

    CHAIN

    RELEASE

    0

    1

    2

    交易完成类型。该变量可以采用下表中所示的值。可以使用名称值或相应的整数值来分配变量。

    价值描述
    NO_CHAIN（或0）COMMIT并且?ROLLBACK?不受影响。这是默认值。
    CHAIN（或 1）COMMIT和?ROLLBACK?分别相当于COMMIT AND CHAIN?和ROLLBACK AND CHAIN。（新事务立即启动，隔离级别与刚刚终止的事务相同。）
    RELEASE（或2）COMMIT和?ROLLBACK?分别相当于COMMIT RELEASE和?ROLLBACK RELEASE。（服务器在终止事务后断开连接。）

    completion_typeSTART TRANSACTION影响以or?开头?BEGIN并以COMMITor 结尾的事务ROLLBACK。它不适用于执行第 13.3.3 节“导致隐式提交的语句”中列出的语句所导致的隐式提交。它也不适用于?XA COMMIT、、?XA ROLLBACK或何时?autocommit=1。

  • concurrent_insert

    命令行格式--concurrent-insert[=value]
    系统变量concurrent_insert
    范围全球的
    动态的是的
    类型枚举
    默认值AUTO
    有效值

    NEVER

    AUTO

    ALWAYS

    0

    1

    2

    如果AUTO（默认），MySQL 允许 对数据文件中间没有空闲块的表?并发运行INSERT和 语句。SELECTMyISAM

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

    价值描述
    NEVER（或0）禁用并发插入
    AUTO（或 1）（默认）为MyISAM没有空洞的表启用并发插入
    ALWAYS（或2）允许对所有MyISAM表进行并发插入，甚至是那些有漏洞的表。对于有孔的表，如果另一个线程正在使用该表，则新行将插入到表的末尾。否则，MySQL 获取正常的写锁并将该行插入到孔中。

    如果您使用 启动mysqld?，--skip-new则?concurrent_insert设置为?NEVER。

    另请参见第 8.11.3 节“并发插入”。

  • connect_timeout

    命令行格式--connect-timeout=#
    系统变量connect_timeout
    范围全球的
    动态的是的
    类型整数
    默认值10
    最小值2
    最大值31536000
    单元秒

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

    connect_timeout如果客户经常遇到以下形式的错误，则?增加该 值可能会有所帮助。?Lost connection to MySQL server at 'XXX', system error:?errno

  • core_file

    系统变量core_file
    范围全球的
    动态的不
    类型布尔值
    默认值OFF

    服务器意外退出时是否写入核心文件。该变量由选项设置?--core-file。

  • datadir

    命令行格式--datadir=dir_name
    系统变量datadir
    范围全球的
    动态的不
    类型目录名称

    MySQL 服务器数据目录的路径。相对路径是相对于当前目录解析的。如果您希望服务器自动启动（即，在您无法假定当前目录是什么的上下文中），最好将该?datadir值指定为绝对路径。

  • date_format

    该变量未使用。它已被弃用并在 MySQL 8.0 中被删除。

  • datetime_format

    该变量未使用。它已被弃用并在 MySQL 8.0 中被删除。

  • debug

    命令行格式--debug[=debug_options]
    系统变量debug
    范围全局、会话
    动态的是的
    类型细绳
    默认值 (Unix)d:t:i:o,/tmp/mysqld.trace
    默认值（Windows）d:t:i:O,\mysqld.trace

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

    设置此系统变量的会话值是一项受限制的操作。会话用户必须具有足够的权限才能设置受限会话变量。请参见?第 5.1.8.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       |
+---------+

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

  • debug_sync

    系统变量debug_sync
    范围会议
    动态的是的
    类型细绳

    该变量是调试同步工具的用户界面。使用调试同步需要使用CMake选项配置 MySQL?（请参见?第 2.8.7 节“MySQL 源配置选项”）；否则，该系统变量不可用。?-DWITH_DEBUG=ON

    全局变量值是只读的，指示该设施是否启用。默认情况下，调试同步处于禁用状态，且debug_sync?值为OFF。如果服务器以 启动?，其中超时值大于 0，则启用调试同步，并且 的值?后跟信号名称。此外，?它也成为各个同步点的默认超时。?--debug-sync-timeout=NNdebug_syncON - current signalN

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

    设置此系统变量的会话值是一项受限制的操作。会话用户必须具有足够的权限才能设置受限会话变量。请参见?第 5.1.8.1 节“系统变量权限”。

    有关调试同步工具以及如何使用同步点的说明，请参阅?MySQL 内部：测试同步。

  • default_authentication_plugin

    命令行格式--default-authentication-plugin=plugin_name
    系统变量default_authentication_plugin
    范围全球的
    动态的不
    类型枚举
    默认值mysql_native_password
    有效值

    mysql_native_password

    sha256_password

    默认身份验证插件。允许使用以下值：

    笔记

    如果此变量的值不是?mysql_native_password，则早于 MySQL 5.5.7 的客户端无法连接，因为在允许的默认身份验证插件中，它们仅理解?mysql_native_password身份验证协议。

    该?default_authentication_plugin?值会影响服务器操作的以下方面：

    • 它确定服务器将哪个身份验证插件分配给由?未明确指定身份验证插件的语句?CREATE USER创建 的新帐户。GRANT

    • 系统old_passwords变量会影响使用mysql_native_password或?sha256_password身份验证插件的帐户的密码哈希。如果默认身份验证插件是这些插件之一，则服务器?old_passwords在启动时设置为插件密码哈希方法所需的值。

    • 对于使用以下任一语句创建的帐户，服务器会将帐户与默认身份验证插件关联起来，并为帐户分配给定的密码，并根据该插件的要求进行哈希处理：

      CREATE USER ... IDENTIFIED BY 'cleartext password';
GRANT ...  IDENTIFIED BY 'cleartext password';

    • 对于使用以下任一语句创建的帐户，服务器会将该帐户与默认身份验证插件相关联，并为该帐户分配给定的密码哈希（如果密码哈希具有插件所需的格式）：

      CREATE USER ... IDENTIFIED BY PASSWORD 'encrypted password';
GRANT ...  IDENTIFIED BY PASSWORD 'encrypted password';

      如果密码哈希不是默认身份验证插件所需的格式，则该语句将失败。

  • default_password_lifetime

    命令行格式--default-password-lifetime=#
    系统变量default_password_lifetime
    范围全球的
    动态的是的
    类型整数
    默认值（≥ 5.7.11）0
    默认值（≤5.7.10）360
    最小值0
    最大值65535
    单元天

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

    可以使用语句的密码过期选项根据个人帐户的需要覆盖全局密码过期策略ALTER USER?。请参见第 6.2.11 节“密码管理”。

    笔记

    在 MySQL 5.7.11 之前，默认?default_password_lifetime?值为 360（密码必须大约每年更改一次）。对于这些版本，请注意，如果您不对?default_password_lifetime?变量或单个用户帐户进行任何更改，则所有用户密码将在 360 天后过期，并且当发生这种情况时，所有用户帐户都会开始在受限模式下运行。连接到服务器的客户端（实际上是用户）会收到一条错误，指示必须更改密码：?ERROR 1820 (HY000): You must reset your password using ALTER USER statement before executing this statement.

    但是，对于自动连接到服务器的客户端（例如通过脚本进行的连接）来说，这一点很容易被忽略。为了避免此类客户端由于密码过期而突然停止工作，请确保更改这些客户端的密码过期设置，如下所示：

    ALTER USER 'script'@'localhost' PASSWORD EXPIRE NEVER;

    或者，将该?default_password_lifetime?变量设置为0，从而禁用所有用户的自动密码过期。

  • default_storage_engine

    命令行格式--default-storage-engine=name
    系统变量default_storage_engine
    范围全局、会话
    动态的是的
    类型枚举
    默认值InnoDB

    表的默认存储引擎。请参阅?第 15 章，替代存储引擎。该变量仅设置永久表的存储引擎。要设置表的存储引擎TEMPORARY，请设置?default_tmp_storage_engine?系统变量。

    要查看哪些存储引擎可用并已启用，请使用该SHOW ENGINES语句或查询INFORMATION_SCHEMA?ENGINES表。

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

  • default_tmp_storage_engine

    命令行格式--default-tmp-storage-engine=name
    系统变量default_tmp_storage_engine
    范围全局、会话
    动态的是的
    类型枚举
    默认值InnoDB

    表的默认存储引擎TEMPORARY?（使用 创建?CREATE TEMPORARY TABLE）。要设置永久表的存储引擎，请设置?default_storage_engine系统变量。另请参阅该变量有关可能值的讨论。

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

  • default_week_format

    命令行格式--default-week-format=#
    系统变量default_week_format
    范围全局、会话
    动态的是的
    类型整数
    默认值0
    最小值0
    最大值7

    用于该?WEEK()函数的默认模式值。请参见?第 12.7 节“日期和时间函数”。

  • delay_key_write

    命令行格式--delay-key-write[={OFF|ON|ALL}]
    系统变量delay_key_write
    范围全球的
    动态的是的
    类型枚举
    默认值ON
    有效值

    OFF

    ON

    ALL

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

    此变量可以具有以下值之一，以影响DELAY_KEY_WRITE可在CREATE TABLE语句中使用的表选项的处理。

    选项描述
    OFFDELAY_KEY_WRITE被忽略。
    ONMySQL 尊重语句DELAY_KEY_WRITE中指定的任何选项?CREATE TABLE。这是默认值。
    ALL所有新打开的表都被视为是在?DELAY_KEY_WRITE启用该选项的情况下创建的。
    笔记

    如果将此变量设置为，则在使用表时ALL不应使用MyISAM其他程序（例如另一个 MySQL 服务器或?myisamchk ）中的表。这样做会导致索引损坏。

    如果DELAY_KEY_WRITE为表启用，则不会在每次索引更新时刷新表的键缓冲区，而仅在表关闭时刷新。这大大加快了键的写入速度，但如果您使用此功能，您应该通过使用系统变量集（例如， ）MyISAM启动服务器来添加对所有表 的自动检查。请参见第 5.1.7 节“服务器系统变量”和?第 15.2.1 节“MyISAM 启动选项”。?myisam_recover_optionsmyisam_recover_options='BACKUP,FORCE'

    如果您使用 启动mysqld?，--skip-new则?delay_key_write设置为?OFF。

    警告

    如果使用 启用外部锁定?--external-locking，则无法防止使用延迟键写入的表的索引损坏。

  • delayed_insert_limit

    命令行格式--delayed-insert-limit=#
    已弃用是的
    系统变量delayed_insert_limit
    范围全球的
    动态的是的
    类型整数
    默认值100
    最小值1
    最大值（64 位平台）18446744073709551615
    最大值（32 位平台）4294967295

    该系统变量已弃用（因为?DELAYED不支持插入）；预计它会在未来的版本中被删除。

  • delayed_insert_timeout

    命令行格式--delayed-insert-timeout=#
    已弃用是的
    系统变量delayed_insert_timeout
    范围全球的
    动态的是的
    类型整数
    默认值300
    最小值1
    最大值31536000
    单元秒

    该系统变量已弃用（因为?DELAYED不支持插入）；预计它会在未来的版本中被删除。

  • delayed_queue_size

    命令行格式--delayed-queue-size=#
    已弃用是的
    系统变量delayed_queue_size
    范围全球的
    动态的是的
    类型整数
    默认值1000
    最小值1
    最大值（64 位平台）18446744073709551615
    最大值（32 位平台）4294967295

    该系统变量已弃用（因为?DELAYED不支持插入）；预计它会在未来的版本中被删除。

  • disabled_storage_engines

    命令行格式--disabled-storage-engines=engine[,engine]...
    系统变量disabled_storage_engines
    范围全球的
    动态的不
    类型细绳
    默认值empty string

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

    [mysqld]
disabled_storage_engines="MyISAM,FEDERATED"

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

    disabled_storage_engines不限制现有表的其他 DDL 语句，例如?CREATE INDEX、?TRUNCATE TABLE、?ANALYZE TABLE、?DROP TABLE或?DROP TABLESPACE。这允许平滑过渡，以便使用禁用引擎的现有表或表空间可以通过诸如 之类的方式迁移到允许的引擎?。?ALTER TABLE ... ENGINE?permitted_engine

    允许将?default_storage_engine或?default_tmp_storage_engine?系统变量设置为禁用的存储引擎。这可能会导致应用程序行为异常或失败，尽管这在开发环境中可能是一种有用的技术，可用于识别使用禁用引擎的应用程序，以便对其进行修改。

    disabled_storage_engines已禁用，并且如果使用以下任一选项启动服务器则无效：--bootstrap、?--initialize、?--initialize-insecure、?--skip-grant-tables。

    笔记

    设置 可能会导致mysql_upgradedisabled_storage_engines?出现问题。有关详细信息，请参见第 4.4.7 节“mysql_upgrade — 检查和升级 MySQL 表”。

  • disconnect_on_expired_password

    命令行格式--disconnect-on-expired-password[={OFF|ON}]
    系统变量disconnect_on_expired_password
    范围全球的
    动态的不
    类型布尔值
    默认值ON

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

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

  • div_precision_increment

    命令行格式--div-precision-increment=#
    系统变量div_precision_increment
    范围全局、会话
    动态的是的
    类型整数
    默认值4
    最小值0
    最大值30

    此变量指示要增加运算符执行的除法运算结果的位数?/。默认值为 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 |
+----------------+

  • end_markers_in_json

    命令行格式--end-markers-in-json[={OFF|ON}]
    系统变量end_markers_in_json
    范围全局、会话
    动态的是的
    类型布尔值
    默认值OFF

    优化器 JSON 输出是否应添加结束标记。请参阅?MySQL 内部结构：end_markers_in_json 系统变量。

  • eq_range_index_dive_limit

    命令行格式--eq-range-index-dive-limit=#
    系统变量eq_range_index_dive_limit
    范围全局、会话
    动态的是的
    类型整数
    默认值200
    最小值0
    最大值4294967295

    此变量指示当优化器在估计合格行数时应从使用索引潜水切换到索引统计信息时，相等比较条件中的相等范围数。它适用于具有以下任一等效形式的表达式的求值，其中优化器使用非唯一索引来查找?col_name值：

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

    在这两种情况下，表达式都包含?N相等范围。优化器可以使用索引潜水或索引统计信息进行行估计。如果eq_range_index_dive_limit?大于 0，并且存在?eq_range_index_dive_limit或更多相等范围，则优化器将使用现有索引统计信息而不是索引潜水。因此，要允许在等于范围内使用索引潜水N，请设置?eq_range_index_dive_limit为?N+ 1。要禁用索引统计信息的使用并始终使用索引潜水，而不管?N，请设置?eq_range_index_dive_limit为 0。

    有关详细信息，请参阅?多值比较的相等范围优化。

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

  • error_count

    生成消息的最后一条语句导致的错误数。该变量是只读的。请参见?第 13.7.5.17 节“显示错误语句”。

  • event_scheduler

    命令行格式--event-scheduler[=value]
    系统变量event_scheduler
    范围全球的
    动态的是的
    类型枚举
    默认值OFF
    有效值

    OFF

    ON

    DISABLED

    该变量启用或禁用以及启动或停止事件调度程序。可能的状态值为?ON、OFF和?DISABLED。开启事件调度程序?OFF与禁用事件调度程序不同，后者需要将状态设置为?DISABLED。该变量及其对事件调度程序操作的影响将在第 23.4.2 节“事件调度程序配置”中详细讨论。

  • explicit_defaults_for_timestamp

    命令行格式--explicit-defaults-for-timestamp[={OFF|ON}]
    已弃用是的
    系统变量explicit_defaults_for_timestamp
    范围全局、会话
    动态的是的
    类型布尔值
    默认值OFF

    此系统变量确定服务器是否为 列NULL中的默认值和值处理 启用某些非标准行为TIMESTAMP。默认情况下，?explicit_defaults_for_timestamp?处于禁用状态，这会启用非标准行为。

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

    • TIMESTAMP未使用该属性显式声明的列NULL?将自动使用该NOT NULL属性进行声明。允许为此类列分配值NULL，并将该列设置为当前时间戳。

    • TIMESTAMP表中的?第一列，如果未使用NULL属性或显式?DEFAULT或ON UPDATE?属性显式声明，则自动使用?DEFAULT CURRENT_TIMESTAMP和?ON UPDATE CURRENT_TIMESTAMP属性进行声明。

    • TIMESTAMP第一个列之后的列，如果未使用属性显式声明?NULL或显式?DEFAULT属性，将自动声明为DEFAULT '0000-00-00 00:00:00'（“零”时间戳）。对于未为此类列指定显式值的插入行，将分配该列'0000-00-00 00:00:00'并且不会出现警告。

      根据是否?NO_ZERO_DATE启用严格 SQL 模式或 SQL 模式，默认值'0000-00-00 00:00:00'可能无效。请注意，?TRADITIONALSQL 模式包括严格模式和?NO_ZERO_DATE.?请参见?第 5.1.10 节“服务器 SQL 模式”。

    刚刚描述的非标准行为已被弃用；预计它们会在 MySQL 的未来版本中被删除。

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

    • 无法为?TIMESTAMP列分配值?NULL以将其设置为当前时间戳。要分配当前时间戳，请将列设置为CURRENT_TIMESTAMP或同义词，例如NOW()。

    • TIMESTAMP未使用该属性显式声明的列NOT NULL?将自动使用该?NULL属性和允许?NULL值进行声明。为此类列分配值NULL将其设置为?NULL，而不是当前时间戳。

    • TIMESTAMP使用该属性声明的列NOT NULL不允许NULL值。对于指定NULL此类列的插入，如果启用了严格 SQL 模式，则结果是单行插入错误；或者'0000-00-00 00:00:00'是禁用严格 SQL 模式的多行插入插入。在任何情况下都不会为列分配值并将NULL其设置为当前时间戳。

    • TIMESTAMP使用该属性显式声明的列NOT NULL?和没有显式?DEFAULT属性的列将被视为没有默认值。对于未为此类列指定显式值的插入行，结果取决于 SQL 模式。如果启用严格 SQL 模式，则会发生错误。如果未启用严格 SQL 模式，则会使用隐式默认值声明该列'0000-00-00 00:00:00'，并会出现警告。这类似于 MySQL 处理其他时间类型（例如?DATETIME.

    • 不会TIMESTAMP自动使用DEFAULT CURRENT_TIMESTAMP或ON UPDATE CURRENT_TIMESTAMP属性声明任何列。必须明确指定这些属性。

    • 表中第一列的处理方式与第一列之后的列的?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?在服务器启动时启用系统变量。

    笔记

    explicit_defaults_for_timestamp?它本身已被弃用，因为它的唯一目的是允许控制已弃用的?TIMESTAMP行为，这些行为将在 MySQL 的未来版本中删除。当删除这些行为时，这些行为?explicit_defaults_for_timestamp?就不再有任何目的，您可以预期它也会被删除。

    有关其他信息，请参见?第 11.2.6 节 “TIMESTAMP 和 DATETIME 的自动初始化和更新”。

  • external_user

    系统变量external_user
    范围会议
    动态的不
    类型细绳

    身份验证过程中使用的外部用户名，由用于身份验证客户端的插件设置。使用本机（内置）MySQL 身份验证，或者如果插件未设置该值，则此变量为NULL。请参见第 6.2.14 节“代理用户”。

  • flush

    命令行格式--flush[={OFF|ON}]
    系统变量flush
    范围全球的
    动态的是的
    类型布尔值
    默认值OFF

    如果ON，则服务器在每个 SQL 语句之后将所有更改刷新（同步）到磁盘。通常，MySQL 仅在每个 SQL 语句之后将所有更改写入磁盘，并让操作系统处理与磁盘的同步。请参见第 B.3.3.3 节“如果 MySQL 不断崩溃该怎么办”。如果您使用该 选项ON启动?mysqld?，则该变量被设置为--flush。

    笔记

    如果flush启用，则 的值flush_time并不重要，并且更改?flush_time对刷新行为没有影响。

  • flush_time

    命令行格式--flush-time=#
    系统变量flush_time
    范围全球的
    动态的是的
    类型整数
    默认值0
    最小值0
    最大值31536000
    单元秒

    如果将其设置为非零值，则所有表每秒都会关闭一次，?flush_time以释放资源并将未刷新的数据同步到磁盘。此选项最好仅在资源最少的系统上使用。

    笔记

    如果flush启用，则 的值flush_time并不重要，并且更改?flush_time对刷新行为没有影响。

  • foreign_key_checks

    系统变量foreign_key_checks
    范围全局、会话
    动态的是的
    类型布尔值
    默认值ON

    如果设置为 1（默认值），则检查外键约束。如果设置为 0，则忽略外键约束，但有几个例外。重新创建已删除的表时，如果表定义不符合引用该表的外键约束，则会返回错误。同样，ALTER TABLE?如果外键定义的格式不正确，则操作会返回错误。有关更多信息，请参见?第 13.1.18.5 节“外键约束”。

    设置此变量对?NDB表的影响与对?InnoDB表的影响相同。通常，您可以在正常操作期间启用此设置，以强制?引用完整性。InnoDB禁用外键检查对于以不同于父/子关系所需的顺序重新加载表很有用。请参见?第 13.1.18.5 节“外键约束”。

    设置foreign_key_checks为 0 也会影响数据定义语句：?DROP SCHEMA删除架构，即使它包含具有由架构外部的表引用的外键的表，并DROP TABLE?删除具有由其他表引用的外键的表。

    笔记

    设置foreign_key_checks为 1 不会触发现有表数据的扫描。因此，添加到表中的行?foreign_key_checks=0不会进行一致性验证。

    不允许删除外键约束所需的索引，即使使用?foreign_key_checks=0.?在删除索引之前必须删除外键约束（错误#70260）。

  • ft_boolean_syntax

    命令行格式--ft-boolean-syntax=name
    系统变量ft_boolean_syntax
    范围全球的
    动态的是的
    类型细绳
    默认值+ -><()~*:""&|

    使用 执行的布尔全文搜索支持的运算符列表IN BOOLEAN MODE。请参见?第 12.9.2 节“布尔全文搜索”。

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

    • 运算符功能由字符串中的位置决定。

    • 替换值必须是 14 个字符。

    • 每个字符必须是 ASCII 非字母数字字符。

    • 第一个或第二个字符必须是空格。

    • 除了位置 11 和 12 中的短语引用运算符之外，不允许重复。这两个字符不需要相同，但它们是唯一可以相同的两个字符。

    • 位置 10、13 和 14（默认设置为?:、&和?|）保留用于将来的扩展。

  • ft_max_word_len

    命令行格式--ft-max-word-len=#
    系统变量ft_max_word_len
    范围全球的
    动态的不
    类型整数
    默认值84
    最小值10
    最大值84

    要包含在索引中的单词的最大长度?MyISAM?FULLTEXT。

    笔记

    FULLTEXTMyISAM更改此变量后必须重建表上的索引 。使用。?REPAIR TABLE?tbl_name?QUICK

  • ft_min_word_len

    命令行格式--ft-min-word-len=#
    系统变量ft_min_word_len
    范围全球的
    动态的不
    类型整数
    默认值4
    最小值1
    最大值82

    要包含在索引中的单词的最小长度?MyISAM?FULLTEXT。

    笔记

    FULLTEXTMyISAM更改此变量后必须重建表上的索引 。使用。?REPAIR TABLE?tbl_name?QUICK

  • ft_query_expansion_limit

    命令行格式--ft-query-expansion-limit=#
    系统变量ft_query_expansion_limit
    范围全球的
    动态的不
    类型整数
    默认值20
    最小值0
    最大值1000

    用于使用 执行的全文搜索的热门匹配项的数量WITH QUERY EXPANSION。

  • ft_stopword_file

    命令行格式--ft-stopword-file=file_name
    系统变量ft_stopword_file
    范围全球的
    动态的不
    类型文件名

    从中读取停用词列表以对MyISAM表进行全文搜索的文件。服务器在数据目录中查找文件，除非给出绝对路径名来指定不同的目录。使用文件中的所有单词；评论?不予尊重。默认情况下，使用内置的停用词列表（如文件中定义?storage/myisam/ft_static.c）。将此变量设置为空字符串 (?'') 将禁用停用词过滤。另请参见?第 12.9.4 节“全文停用词”。

    笔记

    FULLTEXTMyISAM更改此变量或停用词文件的内容后，必须重建表上的索引 。使用。?REPAIR TABLE?tbl_name?QUICK

  • general_log

    命令行格式--general-log[={OFF|ON}]
    系统变量general_log
    范围全球的
    动态的是的
    类型布尔值
    默认值OFF

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

  • general_log_file

    命令行格式--general-log-file=file_name
    系统变量general_log_file
    范围全球的
    动态的是的
    类型文件名
    默认值host_name.log

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

  • group_concat_max_len

    命令行格式--group-concat-max-len=#
    系统变量group_concat_max_len
    范围全局、会话
    动态的是的
    类型整数
    默认值1024
    最小值4
    最大值（64 位平台）18446744073709551615
    最大值（32 位平台）4294967295

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

  • have_compress

    YES压缩库是否zlib?可用于服务器，?NO否则。如果不是，则?不能使用?COMPRESS()和 函数。UNCOMPRESS()

  • have_crypt

    YES系统调用是否crypt()?可用于服务器，NO?否则。如果没有，则ENCRYPT()?无法使用该功能。

    笔记

    该ENCRYPT()函数在 MySQL 5.7 中已弃用，将在 MySQL 的未来版本中删除，并且不应再使用。（对于单向散列，请考虑改用?SHA2()。）因此，have_crypt?also 已被弃用；预计它会在未来的版本中被删除。

  • have_dynamic_loading

    YESmysqld是否支持动态加载插件，NO如果不支持。如果值为NO，则不能使用--plugin-load服务器启动时加载插件、INSTALL PLUGIN运行时加载插件等选项。

  • have_geometry

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

  • have_openssl

    该变量是 的同义词?have_ssl。

  • have_profiling

    YESif 语句分析功能存在，NO否则。如果存在，?profiling系统变量控制是否启用或禁用此功能。请参见?第 13.7.5.31 节“SHOW PROFILES 语句”。

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

  • have_query_cache

    YESmysqld是否支持查询缓存，NO如果不支持。

    笔记

    从 MySQL 5.7.20 开始，查询缓存已被弃用，并在 MySQL 8.0 中被删除。弃用包括?have_query_cache.

  • have_rtree_keys

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

  • have_ssl

    系统变量have_ssl
    范围全球的
    动态的不
    类型细绳
    有效值

    YES（可用 SSL 支持）

    DISABLED（SSL 支持已编译到服务器中，但服务器未启动并使用必要的选项来启用它）

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

  • have_statement_timeout

    系统变量have_statement_timeout
    范围全球的
    动态的不
    类型布尔值

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

  • have_symlink

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

    该变量在 Windows 上没有意义。

  • host_cache_size

    命令行格式--host-cache-size=#
    系统变量host_cache_size
    范围全球的
    动态的是的
    类型整数
    默认值-1（表示自动调整大小；不要分配此文字值）
    最小值0
    最大值65536

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

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

    • 将大小设置为 0 将禁用主机缓存。禁用缓存后，服务器每次客户端连接时都会执行 DNS 查找。

    • 在运行时更改大小会导致隐式主机缓存刷新操作，该操作会清除主机缓存、截断表host_cache并解除阻止任何被阻止的主机。

    默认值自动调整为 128，如果值?max_connections不超过 500，则加 1；如果超过 500，每增加 20，则加 1?max_connections，上限为 2000。

    使用该--skip-host-cache?选项类似于将?host_cache_size系统变量设置为 0，但?host_cache_size更灵活，因为它还可以用于在运行时（而不仅仅是在服务器启动时）调整大小、启用和禁用主机缓存。

    使用 启动服务器?--skip-host-cache不会阻止运行时更改 的值 ，但此类更改没有任何效果，并且即使设置大于 0，也?host_cache_size不会重新启用缓存 。host_cache_size

    由于上一段中给出的原因，最好?设置host_cache_size系统变量而不是 选项。--skip-host-cache此外，该--skip-host-cache选项在 MySQL 8.0 中已弃用，预计会在 MySQL 的未来版本中删除。

  • hostname

    系统变量hostname
    范围全球的
    动态的不
    类型细绳

    服务器在启动时将此变量设置为服务器主机名。

  • identity

    该变量是变量的同义词?last_insert_id。它的存在是为了与其他数据库系统兼容。您可以使用 读取其值SELECT @@identity，并使用 进行设置SET identity。

  • ignore_db_dirs

    已弃用5.7.16
    系统变量ignore_db_dirs
    范围全球的
    动态的不
    类型细绳

    以逗号分隔的名称列表，这些名称不被视为数据目录中的数据库目录。该值是从?--ignore-db-dir服务器启动时给定的任何实例设置的。

    从 MySQL 5.7.11 开始，?--ignore-db-dir可以在数据目录初始化时使用mysqld --initialize来指定服务器应忽略的目录，以评估现有数据目录是否被视为空。请参见?第 2.9.1 节“初始化数据目录”。

    该系统变量在 MySQL 5.7 中已弃用。随着 MySQL 8.0 中数据字典的引入，它变得多余并在该版本中被删除。

  • init_connect

    命令行格式--init-connect=name
    系统变量init_connect
    范围全球的
    动态的是的
    类型细绳

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

    对于有权限的用户，不执行SUPER?的内容 。init_connect这样做是为了确保错误值?init_connect不会阻止所有客户端连接。例如，该值可能包含有语法错误的语句，从而导致客户端连接失败。不?init_connect为具有SUPER权限的用户执行，使他们能够打开连接并修复该?init_connect值。

    从 MySQL 5.7.22 开始，?init_connect任何密码过期的客户端用户都会跳过执行。这样做是因为这样的用户无法执行任意语句，因此init_connect?执行失败，导致客户端无法连接。跳过init_connect?执行使用户能够连接并更改密码。

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

  • init_file

    命令行格式--init-file=file_name
    系统变量init_file
    范围全球的
    动态的不
    类型文件名

    如果指定，此变量会命名一个包含要在启动过程中读取和执行的 SQL 语句的文件。每个语句必须占一行，并且不应包含注释。

    如果服务器使用任何?--bootstrap、?--initialize、 或?--initialize-insecure选项启动，它将在引导模式下运行，并且某些功能不可用，从而限制了文件中允许的语句。其中包括与帐户管理（例如CREATE USER或?GRANT）、复制和全局事务标识符相关的语句。请参见?第 16.1.3 节“使用全局事务标识符进行复制”。

  • innodb_xxx

    InnoDB系统变量在第 14.15 节“InnoDB 启动选项和系统变量”中列出。这些变量控制表的存储、内存使用和 I/O 模式的许多方面，现在作为默认存储引擎?InnoDB尤其重要。InnoDB

  • insert_id

    插入值时?以下?INSERT或 语句要使用的值。这主要与二进制日志一起使用。?ALTER TABLEAUTO_INCREMENT

  • interactive_timeout

    命令行格式--interactive-timeout=#
    系统变量interactive_timeout
    范围全局、会话
    动态的是的
    类型整数
    默认值28800
    最小值1
    最大值31536000
    单元秒

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

  • internal_tmp_disk_storage_engine

    命令行格式--internal-tmp-disk-storage-engine=#
    系统变量internal_tmp_disk_storage_engine
    范围全球的
    动态的是的
    类型枚举
    默认值INNODB
    有效值

    MYISAM

    INNODB

    磁盘内部临时表的存储引擎（请参见?第 8.4.4 节，“MySQL 中的内部临时表使用”）。允许的值为MYISAM和INNODB?（默认值）。

    优化器internal_tmp_disk_storage_engine使用 为磁盘内部临时表?定义的存储引擎 。

    使用?internal_tmp_disk_storage_engine=INNODB?（默认）时，生成超出?InnoDB行或列限制的磁盘内部临时表的查询将返回行大小太大或列太多?错误。解决方法是设置?internal_tmp_disk_storage_engine?为MYISAM。

  • join_buffer_size

    命令行格式--join-buffer-size=#
    系统变量join_buffer_size
    范围全局、会话
    动态的是的
    类型整数
    默认值262144
    最小值128
    最大值 (Windows)4294967168
    最大值（其他，64 位平台）18446744073709551488
    最大值（其他，32 位平台）4294967168
    单元字节
    块大小128

    用于普通索引扫描、范围索引扫描以及不使用索引并因此执行全表扫描的联接的缓冲区的最小大小。通常，获得快速连接的最佳方法是添加索引。join_buffer_size当无法添加索引时，增加 的值 以获得更快的完全连接。为两个表之间的每个完全连接分配一个连接缓冲区。对于不使用索引的多个表之间的复杂联接，可能需要多个联接缓冲区。

    默认值为 256KB。允许的最大设置为?join_buffer_size?4GB?1。64 位平台允许使用更大的值（64 位 Windows 除外，对于该 Windows，较大的值将被截断为 4GB?1 并带有警告）。块大小为 128，如果值不是块大小的精确倍数，则在存储系统变量的值之前，MySQL 服务器将向下舍入为块大小的下一个较小倍数。解析器允许的值最大为平台的最大无符号整数值（32 位系统为4294967295 或 2?32 ?1，18446744073709551615 或 2?64对于 64 位系统为 -1），但实际最大值是一个较小的块大小。

    除非使用块嵌套循环或批量键访问算法，否则将缓冲区设置为大于保存每个匹配行所需的大小，并且所有连接至少分配最小大小，因此在将此变量设置为全球价值巨大。最好保持全局设置较小，并仅在进行大型连接的会话中将会话设置更改为较大的值。如果全局大小大于大多数使用它的查询所需的大小，内存分配时间可能会导致性能大幅下降。

    当使用块嵌套循环时，较大的连接缓冲区可能会很有用，直到第一个表中所有行的所有必需列都存储在连接缓冲区中。这取决于查询；最佳大小可能小于保存第一个表中的所有行。

    当使用批量密钥访问时， 的值?join_buffer_size定义了对存储引擎的每个请求中的批量密钥有多大。缓冲区越大，对连接操作的右侧表进行的顺序访问就越多，这可以显着提高性能。

    有关连接缓冲的其他信息，请参阅?第 8.2.1.6 节 “嵌套循环连接算法”。有关批量密钥访问的信息，请参阅?第 8.2.1.11 节 “阻止嵌套循环和批量密钥访问连接”。

  • keep_files_on_create

    命令行格式--keep-files-on-create[={OFF|ON}]
    系统变量keep_files_on_create
    范围全局、会话
    动态的是的
    类型布尔值
    默认值OFF

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

    如果使用or选项MyISAM创建表?并且找到现有的?or文件，MyISAM 总是返回错误。它不会覆盖指定目录中的文件。?DATA DIRECTORYINDEX DIRECTORY.MYD.MYI

  • key_buffer_size

    命令行格式--key-buffer-size=#
    系统变量key_buffer_size
    范围全球的
    动态的是的
    类型整数
    默认值8388608
    最小值0
    最大值（64 位平台）OS_PER_PROCESS_LIMIT
    最大值（32 位平台）4294967295
    单元字节

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

    允许的最小设置为 0，但不能?key_buffer_size动态设置为 0。设置为 0 会删除密钥缓存，这在运行时是不允许的。仅允许在启动时设置?key_buffer_size为 0，在这种情况下密钥缓存不会初始化。在运行时将设置从值 0更改?key_buffer_size为允许的非零值会初始化密钥缓存。

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

    key_buffer_size在 32 位平台上?允许的最大设置为 4GB?1。64 位平台允许使用更大的值。有效的最大大小可能会更小，具体取决于可用的物理 RAM 以及操作系统或硬件平台施加的每个进程 RAM 限制。该变量的值表示请求的内存量。在内部，服务器会分配尽可能多的内存，但实际分配的内存可能会更少。

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

    为了在同时写入多行时获得更快的速度，请使用LOCK TABLES.?请参见?第 8.2.4.1 节“优化 INSERT 语句”。

    SHOW STATUS您可以通过发出语句并检查?Key_read_requests、?Key_reads、?Key_write_requests和?Key_writes状态变量?来检查密钥缓冲区的性能 。（参见第 13.7.5 节“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 的大小限制适用于单独的每个缓存，而不是作为一个组。请参见?第 8.10.2 节“MyISAM 密钥缓存”。

  • key_cache_age_threshold

    命令行格式--key-cache-age-threshold=#
    系统变量key_cache_age_threshold
    范围全球的
    动态的是的
    类型整数
    默认值300
    最小值100
    最大值（64 位平台）18446744073709551516
    最大值（32 位平台）4294967196
    块大小100

    该值控制缓冲区从键缓存的热子列表降级到热子列表。较低的值会导致降级更快。最小值为 100。默认值为 300。请参见第 8.10.2 节“MyISAM 密钥缓存”。

  • key_cache_block_size

    命令行格式--key-cache-block-size=#
    系统变量key_cache_block_size
    范围全球的
    动态的是的
    类型整数
    默认值1024
    最小值512
    最大值16384
    单元字节
    块大小512

    键缓存中块的大小（以字节为单位）。默认值为 1024。请参见第 8.10.2 节“MyISAM 密钥缓存”。

  • key_cache_division_limit

    命令行格式--key-cache-division-limit=#
    系统变量key_cache_division_limit
    范围全球的
    动态的是的
    类型整数
    默认值100
    最小值1
    最大值100

    键缓存缓冲区列表的热子列表和温子列表之间的划分点。该值是用于热子列表的缓冲区列表的百分比。允许的值范围为 1 到 100。默认值为 100。请参见?第 8.10.2 节“MyISAM 密钥缓存”。

  • large_files_support

    系统变量large_files_support
    范围全球的
    动态的不
    类型布尔值

    mysqld?是否使用大文件支持选项进行编译。

  • large_pages

    命令行格式--large-pages[={OFF|ON}]
    系统变量large_pages
    范围全球的
    动态的不
    平台特定Linux
    类型布尔值
    默认值OFF

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

  • large_page_size

    系统变量large_page_size
    范围全球的
    动态的不
    类型整数
    默认值0
    最小值0
    最大值65535
    单元字节

    如果启用大页面支持，则会显示内存页面的大小。仅 Linux 支持大内存页；在其他平台上，该变量的值始终为 0。请参见第 8.12.4.3 节 “启用大页面支持”。

  • last_insert_id

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

  • lc_messages

    命令行格式--lc-messages=name
    系统变量lc_messages
    范围全局、会话
    动态的是的
    类型细绳
    默认值en_US

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

  • lc_messages_dir

    命令行格式--lc-messages-dir=dir_name
    系统变量lc_messages_dir
    范围全球的
    动态的不
    类型目录名称

    错误消息所在的目录。服务器使用该值和 的值?lc_messages来生成错误消息文件的位置。请参见?第 10.12 节 “设置错误消息语言”。

  • lc_time_names

    命令行格式--lc-time-names=value
    系统变量lc_time_names
    范围全局、会话
    动态的是的
    类型细绳

    此变量指定控制用于显示日期和月份名称及缩写的语言的区域设置。DATE_FORMAT()该变量影响,?DAYNAME()和 函数的输出?MONTHNAME()。区域设置名称是 POSIX 样式的值，例如?'ja_JP'或'pt_BR'。默认值'en_US'与系统的区域设置无关。有关更多信息，请参见?第 10.16 节 “MySQL 服务器区域设置支持”。

  • license

    系统变量license
    范围全球的
    动态的不
    类型细绳
    默认值GPL

    服务器拥有的许可证类型。

  • local_infile

    命令行格式--local-infile[={OFF|ON}]
    系统变量local_infile
    范围全球的
    动态的是的
    类型布尔值
    默认值ON

    该变量控制语句的服务器端LOCAL?功能LOAD DATA?。根据?local_infile设置，服务器拒绝或允许客户端启用的本地数据加载LOCAL。

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

  • lock_wait_timeout

    命令行格式--lock-wait-timeout=#
    系统变量lock_wait_timeout
    范围全局、会话
    动态的是的
    类型整数
    默认值31536000
    最小值1
    最大值31536000
    单元秒

    此变量指定尝试获取元数据锁的超时（以秒为单位）。允许值的范围为 1 到 31536000（1 年）。默认值为 31536000。

    此超时适用于所有使用元数据锁的语句。其中包括对表、视图、存储过程和存储函数以及?LOCK TABLES、?FLUSH TABLES WITH READ LOCK和HANDLER语句的 DML 和 DDL 操作。

    此超时不适用于对数据库中系统表的隐式访问mysql，例如由GRANT或?REVOKE语句或表日志记录语句修改的授予表。超时确实适用于直接访问的系统表，例如使用?SELECT或?UPDATE。

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

    lock_wait_timeout不适用于延迟插入，延迟插入的执行超时时间始终为 1 年。这样做是为了避免不必要的超时，因为发出延迟插入的会话不会收到延迟插入超时的通知。

  • locked_in_memory

    系统变量locked_in_memory
    范围全球的
    动态的不
    类型布尔值
    默认值OFF

    mysqld?是否被锁定在内存中?--memlock。

  • log_error

    命令行格式--log-error[=file_name]
    系统变量log_error
    范围全球的
    动态的不
    类型文件名

    错误日志输出目的地。如果目标是控制台，则值为stderr。否则，目标是文件，?log_error值是文件名。请参见第 5.4.2 节“错误日志”。

  • log_error_verbosity

    命令行格式--log-error-verbosity=#
    系统变量log_error_verbosity
    范围全球的
    动态的是的
    类型整数
    默认值3
    最小值1
    最大值3

    服务器将错误、警告和注释消息写入错误日志的详细程度。下表显示了允许的值。默认值为 3。

    log_error_verbosity 值允许的消息
    1错误信息
    2错误和警告消息
    3错误、警告和信息消息

    log_error_verbosityMySQL 5.7.2 中添加。它优于旧的系统变量，并且应该用来代替旧的?log_warnings系统变量。log_warnings有关该变量如何与 相关的信息，?请参阅 的描述?log_error_verbosity。特别是，赋值给?log_warnings赋值给赋值log_error_verbosity，反之亦然。

  • log_output

    命令行格式--log-output=name
    系统变量log_output
    范围全球的
    动态的是的
    类型放
    默认值FILE
    有效值

    TABLE

    FILE

    NONE

    普通查询日志和慢查询日志输出的一个或多个目的地。TABLE该值是从、?FILE和 中选择的一个或多个以逗号分隔的单词的列表NONE。?TABLE选择记录到 系统数据库中的?general_log和 表。?选择记录到日志文件。?禁用日志记录。如果?值中存在 ，则它优先于存在的任何其他单词。?可以同时指定 和 来选择两个日志输出目的地。?slow_logmysqlFILENONENONETABLEFILE

    该变量选择日志输出目的地，但不启用日志输出。为此，请启用?general_log和?slow_query_log系统变量。对于FILE日志记录，?general_log_file和?slow_query_log_file系统变量确定日志文件位置。有关更多信息，请参见第 5.4.1 节 “选择普通查询日志和慢查询日志输出目的地”。

  • log_queries_not_using_indexes

    命令行格式--log-queries-not-using-indexes[={OFF|ON}]
    系统变量log_queries_not_using_indexes
    范围全球的
    动态的是的
    类型布尔值
    默认值OFF

    如果在启用慢查询日志的情况下启用此变量，则会记录预期检索所有行的查询。请参见?第 5.4.5 节“慢查询日志”。该选项并不一定意味着不使用索引。例如，使用完整索引扫描的查询会使用索引，但会被记录，因为索引不会限制行数。

  • log_slow_admin_statements

    命令行格式--log-slow-admin-statements[={OFF|ON}]
    系统变量log_slow_admin_statements
    范围全球的
    动态的是的
    类型布尔值
    默认值OFF

    在写入慢速查询日志的语句中包含慢速管理语句。行政声明?包括?ALTER TABLE、、、、、、?和?。?ANALYZE TABLE_?CHECK TABLE_?CREATE INDEXDROP INDEXOPTIMIZE TABLEREPAIR TABLE

  • log_syslog

    命令行格式--log-syslog[={OFF|ON}]
    系统变量log_syslog
    范围全球的
    动态的是的
    类型布尔值
    默认值 (Unix)OFF
    默认值（Windows）ON

    是否将错误日志输出写入系统日志。syslog这是 Windows、 Unix 和类 Unix 系统上的事件日志。默认值是特定于平台的：

    • 在 Windows 上，默认情况下启用事件日志输出。

    • 在 Unix 和类 Unix 系统上，syslog?默认情况下禁用输出。

    无论默认值如何，?log_syslog都可以显式设置以控制任何支持的平台上的输出。

    系统日志输出控制不同于将错误输出发送到文件或控制台。根据需要，除了系统日志之外或代替系统日志，错误输出还可以定向到文件或控制台。请参见第 5.4.2 节“错误日志”。

  • log_syslog_facility

    命令行格式--log-syslog-facility=value
    系统变量log_syslog_facility
    范围全球的
    动态的是的
    类型细绳
    默认值daemon

    写入错误日志输出的工具?syslog（发送消息的程序类型）。log_syslog除非启用系统变量，否则该变量无效 。请参见第 5.4.2.3 节“将错误记录到系统日志”。

    允许的值可能因操作系统而异；请查阅您的系统syslog文档。

    Windows 上不存在此变量。

  • log_syslog_include_pid

    命令行格式--log-syslog-include-pid[={OFF|ON}]
    系统变量log_syslog_include_pid
    范围全球的
    动态的是的
    类型布尔值
    默认值ON

    是否在写入的错误日志输出的每一行中包含服务器进程 ID?syslog。log_syslog除非启用系统变量，否则该变量无效 。请参见第 5.4.2.3 节“将错误记录到系统日志”。

    Windows 上不存在此变量。

  • log_syslog_tag

    命令行格式--log-syslog-tag=tag
    系统变量log_syslog_tag
    范围全球的
    动态的是的
    类型细绳
    默认值empty string

    要添加到写入的错误日志输出中的服务器标识符的标记syslog。log_syslog除非启用系统变量，否则该变量无效 。请参见第 5.4.2.3 节“将错误记录到系统日志”。

    默认情况下，服务器标识符mysqld?不带标签。如果指定了标记值tag?，则会将其附加到带有前导连字符的服务器标识符，从而产生标识符?。?mysqld-tag

    在 Windows 上，要使用尚不存在的标记，必须使用具有管理员权限的帐户运行服务器，以允许为该标记创建注册表项。如果标签已存在，则不需要提升权限。

  • log_timestamps

    命令行格式--log-timestamps=#
    系统变量log_timestamps
    范围全球的
    动态的是的
    类型枚举
    默认值UTC
    有效值

    UTC

    SYSTEM

    此变量控制写入错误日志的消息中的时间戳的时区，以及写入文件的一般查询日志和慢查询日志消息的时间戳。不影响写入表（mysql.general_log、?mysql.slow_log）的普通查询日志和慢查询日志消息的时区。CONVERT_TZ()通过设置会话系统变量，可以将从这些表中检索到的行从本地系统时区转换为任何所需的时区?time_zone。

    允许的log_timestamps?值为UTC（默认值）和?SYSTEM（本地系统时区）。

    时间戳使用 ISO 8601 / RFC 3339 格式编写： 加上表示祖鲁时间 (UTC) 或（相对于 UTC 的偏移量）?的尾部值。?YYYY-MM-DDThh:mm:ss.uuuuuuZ±hh:mm

  • log_throttle_queries_not_using_indexes

    命令行格式--log-throttle-queries-not-using-indexes=#
    系统变量log_throttle_queries_not_using_indexes
    范围全球的
    动态的是的
    类型整数
    默认值0
    最小值0
    最大值4294967295

    如果?log_queries_not_using_indexes?启用，该?log_throttle_queries_not_using_indexes?变量会限制每分钟可写入慢速查询日志的此类查询的数量。值 0（默认值）表示“无限制”。有关更多信息，请参阅?第 5.4.5 节“慢查询日志”。

  • log_warnings

    命令行格式--log-warnings[=#]
    已弃用是的
    系统变量log_warnings
    范围全球的
    动态的是的
    类型整数
    默认值2
    最小值0
    最大值（64 位平台）18446744073709551615
    最大值（32 位平台）4294967295

    是否在错误日志中生成额外的警告消息。从 MySQL 5.7.2 开始，以前由 控制的信息项由log_warnings控制log_error_verbosity，它优于旧系统变量，并且应该用来代替旧?log_warnings系统变量。（log_warnings系统变量和--log-warnings?命令行选项已弃用；预计它们将在 MySQL 的未来版本中删除。）

    log_warnings默认启用（MySQL 5.7.2之前默认为1，5.7.2之后默认为2）。要禁用它，请将其设置为 0。如果该值大于 0，服务器将记录有关基于语句的日志记录不安全的语句的消息。如果该值大于 1，服务器会记录中止的连接和新连接尝试的访问被拒绝错误。请参见?第 B.3.2.9 节“通信错误和中止连接”。

    如果您使用复制，建议通过将其设置为大于 0 来启用此变量，以获取有关正在发生的情况的更多信息，例如有关网络故障和重新连接的消息。

    如果副本服务器以?log_warnings启用状态启动，则副本服务器会将消息打印到错误日志以提供有关其状态的信息，例如二进制日志和中继日志坐标，它开始其作业的位置，何时切换到另一个中继日志，何时断开连接后重新连接，等等。

    为 赋值给?log_warnings赋值log_error_verbosity，反之亦然。各变量之间的关系如下：

    从 MySQL 5.7.2 开始，默认日志级别由 控制?log_error_verbosity，默认为 3。此外，默认日志级别?log_warnings从 1 更改为 2，对应于?log_error_verbosity=3。要实现与之前的默认值类似的日志记录级别，请设置?log_error_verbosity=2。

    log_warnings在 MySQL 5.7.2 及更高版本中，仍然允许?使用 ，但映射到使用log_error_verbosity如下：

  • long_query_time

    命令行格式--long-query-time=#
    系统变量long_query_time
    范围全局、会话
    动态的是的
    类型数字
    默认值10
    最小值0
    最大值31536000
    单元秒

    如果查询花费的时间超过这么多秒，服务器就会增加Slow_queries?状态变量。如果启用了慢查询日志，则查询将记录到慢查询日志文件中。该值是实时测量的，而不是 CPU 时间，因此在负载较轻的系统上低于阈值的查询可能在负载较重的系统上高于阈值。的最小值和默认值?long_query_time?分别为 0 和 10。最大值为 31536000，即 365 天（以秒为单位）。该值可以指定为微秒的分辨率。请参见?第 5.4.5 节“慢查询日志”。

    该变量的值较小会导致更多语句被视为长时间运行，从而导致慢速查询日志需要更多空间。对于非常小的值（小于一秒），日志可能会在短时间内变得非常大。增加被视为长时间运行的语句的数量也可能会导致 MySQL Enterprise Monitor 中的“长时间运行的进程数量过多”?警报出现误报，特别是在启用组复制的情况下。由于这些原因，应仅在测试环境中使用非常小的值，或者在生产环境中仅在短时间内使用。

  • low_priority_updates

    命令行格式--low-priority-updates[={OFF|ON}]
    系统变量low_priority_updates
    范围全局、会话
    动态的是的
    类型布尔值
    默认值OFF

    如果设置为1，则所有?INSERT、?UPDATE、?DELETE和语句都会等待，直到受影响的表上LOCK TABLE WRITE没有挂起的?SELECT或。仅降低一个查询的优先级LOCK TABLE READ可以获得相同的效果。{INSERT | REPLACE | DELETE | UPDATE} LOW_PRIORITY ...此变量仅影响仅使用表级锁定的存储引擎（例如MyISAM、?MEMORY和MERGE）。请参见?第 8.11.2 节“表锁定问题”。

  • lower_case_file_system

    系统变量lower_case_file_system
    范围全球的
    动态的不
    类型布尔值

    该变量描述数据目录所在文件系统上文件名的大小写敏感性。?OFF表示文件名区分大小写，?ON表示文件名不区分大小写。该变量是只读的，因为它反映了文件系统属性，设置它不会对文件系统产生影响。

  • lower_case_table_names

    命令行格式--lower-case-table-names[=#]
    系统变量lower_case_table_names
    范围全球的
    动态的不
    类型整数
    默认值 (macOS)2
    默认值 (Unix)0
    默认值（Windows）1
    最小值0
    最大值2

    如果设置为 0，表名将按指定存储，并且比较区分大小写。如果设置为 1，表名将以小写形式存储在磁盘上，并且比较不区分大小写。如果设置为 2，则表名按给定方式存储，但以小写形式进行比较。此选项也适用于数据库名称和表别名。有关其他详细信息，请参阅?第 9.2.3 节“标识符区分大小写”。

    该变量的默认值与平台相关（请参阅 参考资料?lower_case_file_system）。在 Linux 和其他类 Unix 系统上，默认值为?0.?在 Windows 上，默认值为?1。在 macOS 上，默认值为?2.?2在Linux（和其他类Unix系统）上，不支持将值设置为；服务器强制使用该值0。

    如果您在数据目录驻留在不区分大小写的文件系统（例如 Windows 或 macOS）上的系统上运行 MySQL，则不应设置为0。?这是一个不受支持的组合，在使用错误的字母大小写lower_case_table_names运行操作时可能会导致挂起情况?。使用 时，使用不同字母大小写访问表名可能会导致索引损坏。?INSERT INTO ... SELECT ... FROM?tbl_nametbl_nameMyISAM

    --lower_case_table_names=0如果您尝试在不区分大小写的文件系统上?启动服务器，则会打印一条错误消息并且服务器退出 。

    该变量的设置会影响复制过滤选项在区分大小写方面的行为。有关更多信息，请参见第 16.2.5 节 “服务器如何评估复制过滤规则”。

  • max_allowed_packet

    命令行格式--max-allowed-packet=#
    系统变量max_allowed_packet
    范围全局、会话
    动态的是的
    类型整数
    默认值4194304
    最小值1024
    最大值1073741824
    单元字节
    块大小1024

    一个数据包或任何生成/中间字符串或 C API 函数发送的任何参数的最大大小?mysql_stmt_send_long_data()。默认值为 4MB。

    数据包消息缓冲区初始化为?net_buffer_length字节，但在需要时可以增长到?max_allowed_packet字节。默认情况下，该值较小，以捕获较大（可能不正确）的数据包。

    如果您使用大?BLOB列或长字符串，则必须增加此值。BLOB它应该与您想要使用的最大的一样大 。协议限制为?max_allowed_packet1GB。该值应该是1024的倍数；非倍数向下舍入到最接近的倍数。

    当您通过更改变量的值来更改消息缓冲区大小时max_allowed_packet?，如果客户端程序允许，您还应该更改客户端的缓冲区大小。max_allowed_packet客户端库内置的默认 值为 1GB，但各个客户端程序可能会覆盖此值。例如，?mysql和mysqldump的默认值分别为 16MB 和 24MB。max_allowed_packet它们还允许您通过在命令行或选项文件中?设置来更改客户端值 。

    该变量的会话值是只读的。客户端最多可以接收与会话值一样多的字节。但是，服务器向客户端发送的字节数不能多于当前全局?max_allowed_packet值。（如果在客户端连接后更改全局值，则全局值可能小于会话值。）

  • max_connect_errors

    命令行格式--max-connect-errors=#
    系统变量max_connect_errors
    范围全球的
    动态的是的
    类型整数
    默认值100
    最小值1
    最大值（64 位平台）18446744073709551615
    最大值（32 位平台）4294967295

    当max_connect_errors?来自主机的连续连接请求被中断而没有成功连接后，服务器将阻止该主机进行进一步的连接。如果在前一个连接中断后，在少于几次?max_connect_errors尝试内成功建立来自主机的连接，则该主机的错误计数将被清除为零。要解锁被阻止的主机，请刷新主机缓存；请参阅?刷新主机缓存。

  • max_connections

    命令行格式--max-connections=#
    系统变量max_connections
    范围全球的
    动态的是的
    类型整数
    默认值151
    最小值1
    最大值100000

    允许的最大同时客户端连接数。最大有效值为 的有效值?与 的实际设置值中 的较小者。?open_files_limit?- 810max_connections

    有关更多信息，请参见?第 5.1.11.1 节 “连接接口”。

  • max_delayed_threads

    命令行格式--max-delayed-threads=#
    已弃用是的
    系统变量max_delayed_threads
    范围全局、会话
    动态的是的
    类型整数
    默认值20
    最小值0
    最大值16384

    该系统变量已弃用（因为?DELAYED不支持插入）；预计它会在未来的版本中被删除。

  • max_digest_length

    命令行格式--max-digest-length=#
    系统变量max_digest_length
    范围全球的
    动态的不
    类型整数
    默认值1024
    最小值0
    最大值1048576
    单元字节

    每个会话为计算规范化语句摘要而保留的最大内存字节数。一旦在摘要计算期间使用了该空间量，就会发生截断：不会收集已解析语句中的更多标记或计入其摘要值。仅当许多字节的已解析标记产生相同的规范化语句摘要后，语句才会有所不同，并且如果进行比较或聚合摘要统计信息，则认为它们是相同的。

    警告

    设置max_digest_length?为零会禁用摘要生成，这也会禁用需要摘要的服务器功能，例如 MySQL Enterprise Firewall。

    减小该?max_digest_length值会减少内存使用，但如果更多语句仅在末尾有所不同，则会导致更多语句的摘要值变得难以区分。增加该值允许区分较长的语句，但会增加内存使用量，特别是对于涉及大量并发会话的工作负载（服务器为?max_digest_length每个会话分配字节）。

    解析器使用此系统变量作为对其计算的规范化语句摘要的最大长度的限制。如果性能模式跟踪语句摘要，则使用?performance_schema_max_digest_length.?系统变量作为对其存储的摘要最大长度的限制。因此，如果?performance_schema_max_digest_length?小于?max_digest_length，则存储在性能模式中的摘要值相对于原始摘要值将被截断。

    有关语句摘要的更多信息，请参阅?第 25.10 节 “性能模式语句摘要”。

  • max_error_count

    命令行格式--max-error-count=#
    系统变量max_error_count
    范围全局、会话
    动态的是的
    类型整数
    默认值64
    最小值0
    最大值65535

    存储以供SHOW ERRORS和SHOW WARNINGS语句显示的错误、警告和信息消息的最大数量。这与诊断区域中的条件区域的数量相同，因此可以通过 来检查条件的数量?GET DIAGNOSTICS。

  • max_execution_time

    命令行格式--max-execution-time=#
    系统变量max_execution_time
    范围全局、会话
    动态的是的
    类型整数
    默认值0
    最小值0
    最大值4294967295
    单元毫秒

    语句的执行超时时间?SELECT，以毫秒为单位。如果值为 0，则不启用超时。

    max_execution_time适用如下：

  • max_heap_table_size

    命令行格式--max-heap-table-size=#
    系统变量max_heap_table_size
    范围全局、会话
    动态的是的
    类型整数
    默认值16777216
    最小值16384
    最大值（64 位平台）18446744073709550592
    最大值（32 位平台）4294966272
    单元字节
    块大小1024

    MEMORY该变量设置允许用户创建的表增长的?最大大小 。变量的值用于计算?MEMORY表MAX_ROWS?值。

    设置此变量对任何现有表都没有影响 ，除非使用诸如或 用?或 之?MEMORY类的语句重新创建该表?。服务器重新启动还会将现有?表的最大大小设置为全局?值。?CREATE TABLEALTER TABLETRUNCATE TABLEMEMORYmax_heap_table_size

    该变量还与 结合使用?tmp_table_size来限制内部内存表的大小。请参见?第 8.4.4 节，“MySQL 中内部临时表的使用”。

    max_heap_table_size不被复制。有关更多信息，?请参见?第 16.4.1.20 节“复制和内存表”和?第 16.4.1.37 节“复制和变量” 。

  • max_insert_delayed_threads

    已弃用是的
    系统变量max_insert_delayed_threads
    范围全局、会话
    动态的是的
    类型整数
    默认值0
    最小值20
    最大值16384

    该变量是 的同义词?max_delayed_threads。

    该系统变量已弃用（因为?DELAYED不支持插入）；预计它会在未来的版本中被删除。

  • max_join_size

    命令行格式--max-join-size=#
    系统变量max_join_size
    范围全局、会话
    动态的是的
    类型整数
    默认值18446744073709551615
    最小值1
    最大值18446744073709551615

    不允许可能需要检查多于max_join_size行（对于单表语句）或行组合（对于多表语句）的语句，或者可能执行的不仅仅是?max_join_size磁盘查找操作。通过设置此值，您可以捕获未正确使用键且可能需要很长时间的语句。如果您的用户倾向于执行缺少子句?WHERE、需要很长时间或返回数百万行的联接，请设置它。有关详细信息，请参阅?使用安全更新模式 (--safe-updates)。

    将此变量设置为除?DEFAULT将值重置?sql_big_selects为 以外的值0。如果再次设置该?sql_big_selects值，该max_join_size变量将被忽略。

    如果查询结果在查询缓存中，则不会执行结果大小检查，因为结果之前已经计算过，并且不会增加服务器将其发送到客户端的负担。

  • max_length_for_sort_data

    命令行格式--max-length-for-sort-data=#
    系统变量max_length_for_sort_data
    范围全局、会话
    动态的是的
    类型整数
    默认值1024
    最小值4
    最大值8388608
    单元字节

    filesort确定使用?哪种算法的索引值大小的截止值 。请参见?第 8.2.1.14 节“ORDER BY 优化”。

  • max_points_in_geometry

    命令行格式--max-points-in-geometry=#
    系统变量max_points_in_geometry
    范围全局、会话
    动态的是的
    类型整数
    默认值65536
    最小值3
    最大值1048576

    points_per_circle函数参数?的最大值?ST_Buffer_Strategy()。

  • max_prepared_stmt_count

    命令行格式--max-prepared-stmt-count=#
    系统变量max_prepared_stmt_count
    范围全球的
    动态的是的
    类型整数
    默认值16382
    最小值0
    最大值1048576

    该变量限制服务器中准备好的语句的总数。它可用于可能因准备大量语句而导致服务器内存不足而导致拒绝服务攻击的环境中。如果该值设置为低于当前已准备语句的数量，则现有语句不受影响并且可以使用，但在当前数量低于限制之前无法准备新语句。将该值设置为 0 将禁用准备好的语句。

  • max_seeks_for_key

    命令行格式--max-seeks-for-key=#
    系统变量max_seeks_for_key
    范围全局、会话
    动态的是的
    类型整数
    默认值（Windows）4294967295
    默认值（其他，64 位平台）18446744073709551615
    默认值（其他，32 位平台）4294967295
    最小值1
    最大值 (Windows)4294967295
    最大值（其他，64 位平台）18446744073709551615
    最大值（其他，32 位平台）4294967295

    限制基于键查找行时假定的最大查找次数。MySQL 优化器假定通过扫描索引在表中搜索匹配行时不需要超过此数量的键查找，而不管索引的实际基数如何（请参见第?13.7.5.22 节“SHOW INDEX 语句”）。通过将其设置为较低的值（例如 100），您可以强制 MySQL 优先使用索引而不是表扫描。

  • max_sort_length

    命令行格式--max-sort-length=#
    系统变量max_sort_length
    范围全局、会话
    动态的是的
    类型整数
    默认值1024
    最小值4
    最大值8388608
    单元字节

    对数据值排序时使用的字节数。服务器仅使用?max_sort_length每个值的前字节并忽略其余字节。因此，仅在第一个字节之后不同的值 对于、和操作?max_sort_length来说是相等的。GROUP BYORDER BYDISTINCT

    增加 的值 可能也max_sort_length需要增加 的值 。sort_buffer_size有关详细信息，请参见第 8.2.1.14 节“ORDER BY 优化”

  • max_sp_recursion_depth

    命令行格式--max-sp-recursion-depth[=#]
    系统变量max_sp_recursion_depth
    范围全局、会话
    动态的是的
    类型整数
    默认值0
    最小值0
    最大值255

    任何给定存储过程可以递归调用的次数。该选项的默认值为 0，它完全禁用存储过程中的递归。最大值为 255。

    存储过程递归增加了对线程堆栈空间的需求。如果增加 的值?max_sp_recursion_depth，则可能需要通过thread_stack在服务器启动时增加 的值来增加线程堆栈大小。

  • max_tmp_tables

    该变量未使用。它已被弃用并在 MySQL 8.0 中被删除。

  • max_user_connections

    命令行格式--max-user-connections=#
    系统变量max_user_connections
    范围全局、会话
    动态的是的
    类型整数
    默认值0
    最小值0
    最大值4294967295

    任何给定 MySQL 用户帐户允许的最大同时连接数。值 0（默认值）表示?“无限制”。”

    该变量具有可以在服务器启动或运行时设置的全局值。它还具有一个只读会话值，该值指示适用于与当前会话关联的帐户的有效同时连接限制。会话值初始化如下：

    帐户资源限制是使用?CREATE USERor?ALTER USER语句指定的。请参阅?第 6.2.16 节“设置帐户资源限制”。

文章来源:https://blog.csdn.net/a309450028a/article/details/135219730
本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
最新文章