mysql variables（3）

sql_quote_show_create

如果启用(默认)，服务器将引用SHOW CREATE TABLE和SHOW CREATE DATABASE语句的标识符。如果禁用，则禁用引用。默认情况下启用此选项，以便复制可用于需要引用的标识符。

sql_require_primary_key

创建新表或更改现有表结构的语句是否强制要求表具有主键。

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

启用此变量有助于避免在基于行的复制中出现表没有主键时可能出现的性能问题。假设一个表没有主键，update或delete修改多个行。在主服务器上，可以使用单个表扫描执行此操作，但是，当使用基于行的复制进行复制时，将导致对从服务器上要修改的每一行进行表扫描。对于主键，这些表扫描不会发生。

sql_require_primary_key应用于基本表和临时表，对其值的更改被复制到从服务器。
启用sql_require_primary_key时，会产生以下效果:

• 创建没有主键的新表的尝试失败，并出现错误。这包括CREATE TABLE…like。它还包括CREATE TABLE…SELECT，除非CREATE TABLE部分包含主键定义。

• 从现有表中删除主键的尝试失败，并出现错误，但允许在相同的ALTER table语句中删除主键并添加主键。

• 即使表中还包含唯一的NOT NULL索引，删除主键也会失败。

• 试图导入没有主键的表时失败，并出现错误

sql_safe_updates

如果启用了此变量，则不使用WHERE子句或LIMIT子句中的键的UPDATE和DELETE语句将产生错误。这使得捕捉键未正确使用的UPDATE和DELETE语句成为可能，这可能会更改或删除大量行。默认值为OFF。

对于mysql客户机，sql_safe_updates可以通过使用–safe-updates选项来启用。

sql_select_limit

从SELECT语句返回的最大行数。

新连接的默认值是服务器允许每个表的最大行数。典型的默认值(232)−1或(264)−1。如果您更改了限制，则可以通过指定默认值来恢复默认值。

如果SELECT具有LIMIT子句，则该限制优先于sql_select_limit的值。

sql_warnings

此变量控制在出现警告时单行插入语句是否生成信息字符串。默认值为OFF。将该值设置为ON以生成一个信息字符串。

ssl_ca

具有受信任SSL证书颁发机构列表的文件的路径

ssl_capath

到包含PEM格式的受信任SSL CA证书的目录的路径。

ssl_cert

用于建立安全连接的SSL证书文件的名称。

ssl_cipher

SSL加密允许的密码的列表。

ssl_crl

包含PEM格式的证书撤销列表的文件的路径。撤销列表适用于使用OpenSSL(而不是wolfSSL)编译的MySQL发行版。

ssl_crlpath

目录的路径，该目录包含PEM格式的证书撤销列表文件。撤销列表适用于使用OpenSSL(而不是wolfSSL)编译的MySQL发行版。

ssl_fips_mode

控制是否在服务器端启用FIPS模式。ssl_fips_mode系统变量与其他——ssl-xxx选项的不同之处在于，它不用于控制服务器是否允许加密连接，而是用于影响允许哪些加密操作。参见第6.6节“FIPS支持”。

这些ssl_fips_mode值是允许的:

• OFF(或0):禁用FIPS模式。

• ON(或1):启用FIPS模式。

• STRICT(或2):启用“STRICT”FIPS模式。

如果OpenSSL FIPS对象模块不可用，则ssl_fips_mode的唯一允许值为OFF。在这种情况下，在启动时将ssl_fips_mode设置为ON或STRICT会导致服务器生成错误消息并退出。

ssl_key

用于建立安全连接的SSL密钥文件的名称。

stored_program_cache

设置每个连接缓存的存储例程数量的软上限。这个变量的值是根据MySQL服务器为存储过程和存储函数维护的两个缓存中每个缓存中存储的例程数量指定的。

每当执行一个存储例程时，在解析该例程中的第一个或顶级语句之前，都会检查该缓存大小;如果相同类型的例程(根据正在执行的存储过程或存储函数)的数量超过此变量指定的限制，则刷新相应的缓存并释放以前为缓存对象分配的内存。这允许安全地刷新缓存，即使存储例程之间存在依赖关系。

存储过程和存储函数缓存与dictionary对象缓存的存储程序定义缓存分区并行存在。存储过程和存储函数缓存是每个连接的缓存，而存储的程序定义缓存是共享的。存储过程和存储函数缓存中对象的存在不依赖于存储程序定义缓存中对象的存在，反之亦然

stored_program_definition_cache

定义可保存在dictionary对象缓存中的已使用和未使用的存储程序定义对象的数量限制。

未使用的存储程序定义对象仅在使用的数量小于stored_program_definition_cache定义的容量时保存在字典对象缓存中。

0的设置意味着存储的程序定义对象只在使用时保存在字典对象缓存中。

存储程序定义缓存分区与使用stored_program_cache选项配置的存储过程和存储函数缓存并行存在。

stored_program_cache选项为每个连接的缓存存储过程或函数的数量设置一个软上限，每次连接执行一个存储过程或函数时都会检查这个上限。另一方面，存储程序定义缓存分区是一个共享缓存，用于存储用于其他目的的存储程序定义对象。存储程序定义缓存分区中对象的存在不依赖于存储过程缓存或存储函数缓存中对象的存在，反之亦然。

super_read_only

如果启用了read_only系统变量，服务器只允许具有超级特权的用户更新客户机。如果还启用了super_read_only系统变量，服务器甚至禁止拥有SUPER的用户更新客户机。有关只读模式的描述以及read_only和super_read_only如何交互的信息，请参见read_only系统变量的描述。

主服务器上对super_read_only的更改不会复制到从服务器上。可以在从属服务器上独立于主服务器上的设置设置该值。

syseventlog.facility

写入syslog(发送消息的程序类型)的错误日志输出的工具。除非安装了log_sink_syseventlog错误日志组件，否则此变量不可用。

每个操作系统允许的值可能不同;查阅系统syslog文档。

此变量在Windows上不存在。

syseventlog.include_pid

是否在写入syslog的错误日志输出的每一行中包含服务器进程ID。除非安装了log_sink_syseventlog错误日志组件，否则此变量不可用。

此变量在Windows上不存在。

syseventlog.tag

在写入syslog或Windows事件日志的错误日志输出中添加到服务器标识符的标记。除非安装了log_sink_syseventlog错误日志组件，否则此变量不可用。

默认情况下，不设置任何标记，因此服务器标识符在Windows上是MySQL，在其他平台上是mysqld。如果指定了tag的标记值，那么它将使用前导连字符追加到服务器标识符，从而产生mysqld-tag(或Windows上的MySQL-tag)的syslog标识符。

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

system_time_zone

服务器系统时区。当服务器开始执行时，它从机器默认值继承一个时区设置，可能由用于运行服务器或启动脚本的帐户的环境修改。该值用于设置system_time_zone。通常，时区由TZ环境变量指定。还可以使用mysqld_safe脚本的–timezone选项指定它。

system_time_zone变量与time_zone不同。虽然它们可能具有相同的值，但是后者变量用于为每个连接的客户机初始化时区。

table_definition_cache

可以存储在定义缓存中的表定义的数量。如果使用大量表，则可以创建大型表定义缓存来加速表的打开。与普通表缓存不同，表定义缓存占用更少的空间，并且不使用文件描述符。最小值是400。默认值基于以下公式，上限为2000:

对于InnoDB, table_definition_cache作为InnoDB数据字典缓存中打开的表实例数量的软限制。如果打开的表实例的数量超过了table_definition_cache设置，LRU机制将开始标记表实例进行回收，并最终从数据字典缓存中删除它们。此限制有助于处理以下情况:在下一个服务器重新启动之前，将使用大量内存缓存很少使用的表实例。具有缓存元数据的表实例的数量可能会高于table_definition_cache定义的限制，因为具有外键关系的父表实例和子表实例不会放在LRU列表中，也不会被从内存中删除。

另外，table_definition_cache为每次可以打开的每个表空间的InnoDB文件数量定义了一个软限制，该限制也由innodb_open_files控制。如果设置了table_definition_cache和innodb_open_files，则使用最高设置。如果两个变量都没有设置，则使用默认值更高的table_definition_cache。如果打开的表空间文件句柄的数量超过了table_definition_cache或innodb_open_files所定义的限制，LRU机制将在表空间文件LRU列表中搜索已完全刷新且当前未扩展的文件。每次打开新的表空间时，都会执行此过程。如果没有“非活动”的表空间，就不会关闭表空间文件。

表定义缓存与字典对象缓存的表定义缓存分区并行存在。这两个缓存存储表定义，但服务于MySQL服务器的不同部分。一个缓存中的对象不依赖于另一个缓存中的存在对象。

(table_definition_cache:缓存表定义(.frm)文件的数量。如果表较多，可以增大该值加快打开表。与一般表缓存不同，表定义缓存不占用文件描述符，占用空间也小。最小为400，上线为2000，默认为：
400 + (table_open_cache / 2)。如果打开表数量高于table_definition_cache，则会通过LRU机制搜索表空间LRU文件列表并刷新列表。对于InnoDB，打开文件的限制为max(table_definition_cache, innodb_open_files)。
)

table_open_cache

所有线程打开的表的数量。增加这个值会增加mysqld所需的文件描述符的数量。您可以通过检查Opened_tables status变量来检查是否需要增加表缓存。如果Opened_tables的值很大，并且您不经常使用FLUSH TABLES(这会强制关闭和重新打开所有表)，那么您应该增加table_open_cache变量的值。

(所有线程打开表的数目。它的作用就是缓存表文件描述符，降低打开关闭表的频率， 如果这个参数设置得过小，就不得不关闭一些已打开的表以便为缓存新表，从而出现频繁的打开关闭MyISAM表文件的情况，而INNODB表的打开不受这个参数控制，而是放到其数据字典当中，即在ibd文件中。当Opened_tables状态值较大，且不经常使用FLUSH TABLES 关闭并重新打开表，就需要增加该值。)

table_open_cache_instances

打开的表缓存实例的数量。为了通过减少会话之间的争用来提高可伸缩性，可以将开放表缓存划分为几个较小的缓存实例，其大小为table_open_cache / table_open_cache_instances。一个会话只需要锁定一个实例就可以访问DML语句。这在实例之间分段缓存访问，允许在有许多会话访问表时使用缓存的操作具有更高的性能。(DDL语句仍然需要对整个缓存进行锁定，但是这样的语句比DML语句要少得多。)

对于通常使用16个或更多内核的系统，建议使用8或16。

temptable_max_ram

定义TempTable存储引擎在开始将数据存储在磁盘上之前可以占用的最大内存量。默认值是1073741824字节(1GiB)。

temptable_use_mmap

定义当TempTable存储引擎占用的内存超过temptable_max_ram变量定义的限制时，TempTable存储引擎是否将内存中内部临时表的空间分配为内存映射的临时文件。当temptable_use_mmap被禁用时，TempTable存储引擎将使用InnoDB磁盘上的内部临时表。

thread_cache_size

服务器应该缓存多少线程以供重用。当客户端断开连接时，如果那里的线程少于thread_cache_size，那么客户端的线程将被放入缓存中。如果可能的话，通过重用从缓存中获取的线程来满足对线程的请求，并且只有在缓存为空时才创建新线程。如果您有很多新连接，可以增加这个变量来提高性能。通常，如果您有一个良好的线程实现，这不会提供显著的性能改进。但是，如果服务器每秒看到数百个连接，通常应该将thread_cache_size设置得足够高，以便大多数新连接使用缓存的线程。通过检查连接和Threads_created状态变量之间的差异，您可以看到线程缓存的效率。
默认值基于以下公式，上限为100:

thread_handling

服务器用于连接线程的线程处理模型。允许的值是no-threads(服务器使用一个线程处理一个连接)和one-thread-per-connection (服务器使用一个线程处理每个客户机连接)。在Linux下，no-threads调试非常有用;

thread_pool_algorithm

这个变量控制线程池插件使用的算法:

值0(默认值)使用保守的低并发算法，该算法经过了很好的测试，并且已知会产生非常好的结果。

值1会增加并发性，并使用一种更激进的算法，这种算法有时在最优线程数方面的性能会提高5-10%，但随着连接数量的增加，性能会下降。它的使用应该被认为是实验性的，不受支持。

此变量仅在启用线程池插件时可用

thread_pool_high_priority_connection

此变量影响执行前新语句的排队。如果值为0 (false，默认值)，语句队列将同时使用低优先级队列和高优先级队列。如果值为1 (true)，那么排队的语句总是进入高优先级队列。

此变量仅在启用线程池插件时可用

thread_pool_max_unused_threads

线程池中未使用线程的最大允许数量。这个变量可以限制休眠线程使用的内存量。

值0(默认值)意味着不限制休眠线程的数量。N, N值大于0意味着1消费者线程和N−1储备线程。在这种情况下，如果一个线程准备休眠，但是休眠线程的数量已经达到最大值，那么该线程将退出，而不是进入休眠状态。

休眠线程要么作为消费线程休眠，要么作为备用线程休眠。线程池允许一个线程在休眠时作为消费线程。如果一个线程进入睡眠状态，并且没有现有的使用者线程，那么它将作为使用者线程进入睡眠状态。当一个线程必须被唤醒时，如果存在使用者线程，则选择使用者线程。仅当没有要唤醒的使用者线程时，才选择备用线程。

此变量仅在启用线程池插件时可用

thread_pool_prio_kickup_timer

此变量影响在低优先级队列中等待执行的语句。该值是将等待语句移动到高优先级队列之前的毫秒数。默认值是1000(1秒)。值的范围是0到2^32−2。

此变量仅在启用线程池插件时可用

thread_pool_size

线程池中线程组的数量。这是控制线程池性能最重要的参数。它会影响同时执行多少条语句。默认值是16，允许值的范围从1到64。如果指定了超出此范围的值，则线程池插件不加载，服务器将向错误日志写入一条消息。
(一般设置为当前CPU核心数目)

此变量仅在启用线程池插件时可用

thread_pool_stall_limit

这个变量影响语句的执行。该值是一个语句在开始执行后必须完成的时间，然后才会被定义为停止，此时线程池允许线程组开始执行另一个语句。该值以10毫秒为单位测量，因此6的值(默认值)意味着60ms。取值范围为4到600 (40ms到6s)。短等待值允许线程更快地启动。短值对于避免死锁情况也更好。对于包含长时间运行的语句的工作负载，长等待值非常有用，可以避免在当前语句执行时启动太多新语句。

此变量仅在启用线程池插件时可用

thread_stack

每个线程的堆栈大小。默认的192KB(64位系统为256KB)足够大以正常操作。如果线程堆栈的大小太小，则会限制服务器可以处理的SQL语句的复杂性、存储过程的递归深度和其他内存消耗操作。

time_format

This system variable was removed in MySQL 8.0.3.

time_zone

当前时区。此变量用于为每个连接的客户机初始化时区。默认情况下，它的初始值是“SYSTEM”(这意味着“使用system_time_zone的值”)。该值可以在服务器启动时使用——default-time-zone选项显式指定

如果设置为SYSTEM，每个需要时区计算的MySQL函数调用都会调用一个系统库来确定当前的系统时区。此调用可能受到全局互斥锁的保护，从而导致争用。

timestamp

为这个客户设置时间。如果您使用二进制日志来恢复行，那么它用于获取原始时间戳。timestamp_value应该是Unix历元时间戳(类似于UNIX_TIMESTAMP()返回的值)，而不是’YYYY-MM-DD hh:mm:ss’格式的值)或默认值。

将时间戳设置为常量值会使其保留该值，直到再次更改为止。将timestamp设置为DEFAULT将使其值为访问它时的当前日期和时间。

在MySQL 8.0中，时间戳是DOUBLE而不是BIGINT，因为它的值包含微秒部分。

SET timestamp影响NOW()返回的值，但不影响SYSDATE()返回的值。这意味着二进制日志中的时间戳设置对SYSDATE()的调用没有影响。可以使用——SYSDATE -is- NOW选项启动服务器，使SYSDATE()成为NOW()的别名，在这种情况下，SET timestamp会影响这两个函数。

tls_version

服务器允许的用于加密连接的协议。该值是一个逗号分隔的列表，其中包含一个或多个协议名。可以为这个变量命名的协议取决于用于编译MySQL的SSL库

tmp_table_size

内存内临时表的最大大小。此变量不适用于用户创建的内存表。

实际的限制是由tmp_table_size和max_heap_table_size中较小的值决定的。如果内存中的临时表超过限制，MySQL会自动将其转换为磁盘上的临时表。internal_tmp_disk_storage_engine选项定义用于磁盘上临时表的存储引擎

如果您执行许多高级组BY查询，并且您有大量内存，那么可以增加tmp_table_size(如果需要，还可以增加max_heap_table_size)的值。

通过比较Created_tmp_disk_tables和Created_tmp_tables变量的值，可以将创建的内部磁盘临时表的数量与创建的内部临时表的总数进行比较。

tmpdir

用于临时文件和临时表的目录。可以将此变量设置为以循环方式使用的多个路径的列表。Unix上的路径应该用冒号(:)分隔，Windows上的路径应该用分号(;)分隔。

多目录特性可用于在多个物理磁盘之间分散负载。如果MySQL服务器充当复制从属服务器，则不应将tmpdir设置为指向基于内存的文件系统上的目录，或指向服务器主机重新启动时清除的目录。复制从属服务器需要一些临时文件才能在机器重新启动时存活，以便能够复制临时表或加载数据操作。如果在服务器重新启动时丢失临时文件目录中的文件，则复制失败。您可以使用slave_load_tmpdir变量设置从目录的临时目录。在这种情况下，从目录将不会使用一般的tmpdir值，您可以将tmpdir设置为非永久位置。

transaction_alloc_block_size

用于增加需要内存的每个事务内存池的字节数。

transaction_isolation

事务隔离级别。默认值是可重复读取。

事务隔离级别有三个作用域:全局、会话和下一个事务。这三种范围的实现导致了一些非标准的隔离级分配语义，如后面所述。

要在启动时设置全局事务隔离级别，请使用——transaction-isolation server选项。

在运行时，可以直接使用set语句设置隔离级别，以便为transaction_isolation系统变量赋值，或者间接使用set事务语句设置隔离级别。如果直接将transaction_isolation设置为包含空格的隔离级别名称，则该名称应该用引号括起来，空格用破折号替换。例如，使用这个SET语句来设置全局值:

设置全局transaction_isolation值将设置所有后续会话的隔离级别。现有会话不受影响。

要设置会话或下一级transaction_isolation值，请使用set语句。对于大多数会话系统变量，这些语句是设置值的等效方法:

如前所述，除了全局和会话作用域之外，事务隔离级别还有一个下一个事务作用域。要设置下一个事务作用域，用于分配会话系统变量值的set语法具有transaction_isolation的非标准语义:

要设置会话隔离级别，请使用以下任何语法:

对于这些语法，这些语义适用:

• 设置会话中执行的所有后续事务的隔离级别。

• 在事务中允许，但不影响当前正在进行的事务。

• 如果在事务之间执行，则重写前面设置下一个事务隔离级别的任何语句。

• 对应于设置会话事务隔离级别(使用会话关键字)。
  要设置下一个事务隔离级别，使用以下语法:
  
  对于该语法，这些语义适用:

• 仅为会话中执行的下一个事务设置隔离级别。

• 后续事务恢复到会话隔离级别。

• 事务中不允许的。

• 对应于 SET TRANSACTION ISOLATION LEVEL(没有会话关键字)。

transaction_prealloc_size

每个事务都有一个内存池，各种事务相关的分配从这个内存池中获取内存。池的初始大小(以字节为单位)是transaction_prealloc_size。对于由于可用内存不足而无法从池中满足的每个分配，可以通过transaction_alloc_block_size字节增加池。当事务结束时，池被截断为transaction_prealloc_size字节。

通过使transaction_prealloc_size足够大以在单个事务中包含所有语句，您可以避免许多malloc()调用。

transaction_read_only

事务访问模式。值可以OFF(读/写;默认)或ON(只读)。

事务访问模式有三个作用域:全局、会话和下一个事务。这三种范围的实现导致了一些非标准的访问模式分配语义，如后面所述。

要在启动时设置全局事务访问模式，请使用 --transaction-read-only服务器选项。

在运行时，可以直接使用set语句设置访问模式，以便为transaction_read_only系统变量赋值，或者间接使用 SET TRANSACTION 语句设置访问模式。例如，使用这个SET语句来设置全局值:

设置全局transaction_read_only值将设置所有后续会话的访问模式。现有会话不受影响。

若要设置会话或下一级transaction_read_only值，请使用set语句。对于大多数会话系统变量，这些语句是设置值的等效方法:

如前所述，事务访问模式除了全局和会话范围之外，还有一个下一个事务范围。要设置下一个事务作用域，用于分配会话系统变量值的set语法对于transaction_read_only具有非标准语义，要设置会话访问模式，请使用以下任何语法:

对于这些语法，这些语义适用:

• 设置在会话中执行的所有后续事务的访问模式。

• 在事务中允许，但不影响当前正在进行的事务。

• 如果在事务之间执行，则覆盖前面设置下一个事务访问模式的任何语句。

• 对应于设置会话事务{READ WRITE | READ ONLY}(使用会话关键字)。
  要设置下一个事务访问模式，使用以下语法:
  
  对于该语法，这些语义适用:

• 仅为会话中执行的下一个事务设置访问模式。

• 后续事务恢复到会话访问模式。

• 事务中不允许的。

• 对应于SET事务{READ WRITE | READ ONLY}(不带SESSION关键字)。

tx_isolation

在MySQL 8.0.3中删除了这个系统变量。使用transaction_isolation代替

tx_read_only

在MySQL 8.0.3中删除了这个系统变量。使用transaction_read_only代替。

unique_checks

如果设置为1(默认值)，则执行InnoDB表中辅助索引的唯一性检查。如果设置为0，则允许存储引擎假设输入数据中不存在重复的键。如果您确定您的数据不包含唯一性违规，可以将其设置为0，以加快对InnoDB的大型表导入。

将此变量设置为0不需要存储引擎忽略重复的键。引擎仍然允许检查它们并在检测到它们时发出重复键错误。

updatable_views_with_limit

如果视图不包含基础表中定义的主键的所有列(如果update语句包含LIMIT子句)，则此变量控制是否可以对视图进行更新。(此类更新通常是由GUI工具生成的。)update是update或DELETE语句。这里的主键是指主键或惟一索引，其中没有列可以包含NULL。

变量可以有两个值:

1或YES:只发出警告(不是错误消息)。这是默认值。

0或否:禁止更新。

use_secondary_engine

以备将来使用

validate_user_plugins

如果启用了此变量(默认值)，服务器将检查每个用户帐户，如果发现使帐户不可用的情况，则生成警告:

该帐户需要一个未加载的身份验证插件。

该帐户需要sha256_password或caching_sha2_password身份验证插件，但服务器启动时没有按照插件的要求启用SSL或RSA。

启用validate_user_plugins会减慢服务器初始化和刷新特权。如果不需要额外的检查，可以在启动时禁用该变量，以避免性能下降。

version

服务器的版本号。该值还可能包含一个后缀，指示服务器构建或配置信息。-debug表示服务器是在启用调试支持的情况下构建的。

version_comment

CMake配置程序有一个COMPILATION_COMMENT_SERVER选项，该选项允许在构建MySQL时指定注释。该变量包含该注释的值。(在MySQL 8.0.14之前，version_comment是由COMPILATION_COMMENT选项设置的。)

version_compile_machine

服务器二进制文件的类型。

version_compile_os

MySQL所基于的操作系统类型。

version_compile_zlib

编译的zlib库的版本。

wait_timeout

服务器在关闭非交互式连接之前等待活动的秒数。

在线程启动时，根据客户机的类型(由CLIENT_INTERACTIVE connect选项定义为mysql_real_connect())，会话wait_timeout值由全局wait_timeout值或全局interactive_timeout值初始化。

warning_count

由生成消息的最后一条语句导致的错误、警告和注释的数量。此变量仅被读取。

windowing_use_high_precision

是否在不损失精度的情况下计算窗口操作。