值为真或假的系统变量可以通过在启动时命名它们来启用，或者通过使用 --skip- 前缀来禁用。例如，要启用或禁用 InnoDB 自适应哈希索引，您可以在命令行上使用 --innodb-adaptive-hash-index 或 --skip-innodb-adaptive-hash-index，或者在选项文件中使用 innodb_adaptive_hash_index 或 skip_innodb_adaptive_hash_index。

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

取数值的系统变量可以在命令行上指定为 --var_name=value，或者在选项文件中指定为 var_name=value。

许多系统变量可以在运行时更改（请参阅 第 7.1.9.2 节“动态系统变量”）。

有关 GLOBAL 和 SESSION 变量作用域修饰符的信息，请参阅 SET 语句文档。

某些选项控制 InnoDB 数据文件的位置和布局。 第 17.8.1 节“InnoDB 启动配置” 说明了如何使用这些选项。

一些选项（您可能不会立即使用）有助于根据机器容量和数据库 工作负载 调整 InnoDB 性能特征。

有关指定选项和系统变量的更多信息，请参阅 第 6.2.2 节“指定程序选项”。

--innodb-status-file

启动选项 --innodb-status-file 控制着 InnoDB 是否在数据目录中创建一个名为 innodb_status.pid 的文件，并每 15 秒（大约）将 SHOW ENGINE INNODB STATUS 的输出写入该文件。

默认情况下，不会创建 innodb_status.pid 文件。要创建它，请使用 --innodb-status-file 选项启动 mysqld。服务器正常关闭时，InnoDB 会删除该文件。如果发生异常关闭，则可能需要手动删除状态文件。

选项 --innodb-status-file 旨在用于临时用途，因为 SHOW ENGINE INNODB STATUS 输出生成会影响性能，并且 innodb_status.pid 文件会随着时间的推移而变得相当大。

有关相关信息，请参见 第 17.17.2 节，“启用 InnoDB 监控器”。

innodb_adaptive_flushing

指定是否根据工作负载动态调整 InnoDB 缓冲池 中刷新 脏页 的速率。动态调整刷新速率旨在避免 I/O 活动突发。此设置默认情况下处于启用状态。有关更多信息，请参见 第 17.8.3.5 节，“配置缓冲池刷新”。有关常规 I/O 调整建议，请参见 第 10.5.8 节，“优化 InnoDB 磁盘 I/O”。

innodb_adaptive_flushing_lwm

定义低水位标记，表示启用 自适应刷新 时 重做日志 容量的百分比。有关更多信息，请参见 第 17.8.3.5 节，“配置缓冲池刷新”。

innodb_adaptive_hash_index

是否启用或禁用 InnoDB 自适应哈希索引。根据您的工作负载，动态启用或禁用 自适应哈希索引 以提高查询性能可能是可取的。由于自适应哈希索引可能不适合所有工作负载，因此请使用现实的工作负载进行启用和禁用它的基准测试。有关详细信息，请参见 第 17.5.3 节，“自适应哈希索引”。

此变量默认情况下处于禁用状态。您可以使用 SET GLOBAL 语句修改此参数，无需重启服务器。在运行时更改设置需要足够的权限来设置全局系统变量。请参见 第 7.1.9.1 节，“系统变量权限”。您也可以在服务器启动时使用 --innodb-adaptive-hash-index 来启用它。

禁用自适应哈希索引会立即清空哈希表。当哈希表被清空时，正常操作可以继续，而执行使用哈希表访问的查询将直接访问索引 B 树。重新启用自适应哈希索引后，哈希表将在正常操作期间重新填充。

在 MySQL 8.4 之前，此选项默认情况下处于启用状态。

innodb_adaptive_hash_index_parts

对自适应哈希索引搜索系统进行分区。每个索引都绑定到特定的分区，每个分区都受单独的闩锁保护。

自适应哈希索引搜索系统默认情况下分为 8 个分区。最大设置是 512。

有关相关信息，请参见 第 17.5.3 节，“自适应哈希索引”。

innodb_adaptive_max_sleep_delay

允许 InnoDB 根据当前工作负载自动向上或向下调整 innodb_thread_sleep_delay 的值。任何非零值都会启用 innodb_thread_sleep_delay 值的自动动态调整，最高可达 innodb_adaptive_max_sleep_delay 选项中指定的最大值。该值表示微秒数。此选项在繁忙的系统中可能很有用，其中 InnoDB 线程数超过 16 个。（实际上，它对具有数百或数千个同时连接的 MySQL 系统最有效。）

有关更多信息，请参见 第 17.8.4 节，“为 InnoDB 配置线程并发性”。

innodb_autoextend_increment

扩展自扩展 InnoDB 系统表空间 文件大小时的增量大小（以兆字节为单位），当它变满时。默认值为 64。有关相关信息，请参见 系统表空间数据文件配置，以及 调整系统表空间大小。

设置 innodb_autoextend_increment 不会影响 每个表一个文件 表空间文件或 通用表空间 文件。无论 innodb_autoextend_increment 设置如何，这些文件都是自扩展的。初始扩展量很小，之后每次扩展的增量为 4MB。

innodb_autoinc_lock_mode

用于生成 自动递增 值的 锁定模式。允许的值分别为 0、1 或 2，表示传统、连续或交错。

默认设置是 2（交错），与基于行的复制兼容。

有关每种锁定模式的特征，请参见 InnoDB AUTO_INCREMENT 锁定模式。

innodb_background_drop_list_empty

启用 innodb_background_drop_list_empty 调试选项有助于避免测试用例失败，方法是延迟创建表，直到后台删除列表为空。例如，如果测试用例 A 将表 t1 放入后台删除列表，测试用例 B 将等待后台删除列表为空，然后再创建表 t1。

innodb_buffer_pool_chunk_size

innodb_buffer_pool_chunk_size 定义了 InnoDB 缓冲池调整大小操作的块大小。

为了避免在调整大小操作期间复制所有缓冲池页面，该操作将以 “块” 为单位执行。默认情况下，innodb_buffer_pool_chunk_size 为 128MB（134217728 字节）。块中包含的页面数量取决于 innodb_page_size 的值。可以以 1MB（1048576 字节）为单位增加或减少 innodb_buffer_pool_chunk_size。

以下条件适用于更改 innodb_buffer_pool_chunk_size 值

为了避免潜在的性能问题，块数（innodb_buffer_pool_size / innodb_buffer_pool_chunk_size）不应超过 1000。

innodb_buffer_pool_size 变量是动态的，允许在服务器在线时调整缓冲池的大小。但是，缓冲池大小必须等于或为 innodb_buffer_pool_chunk_size * innodb_buffer_pool_instances 的倍数，更改这两个变量设置中的任何一个都需要重新启动服务器。

有关更多信息，请参见 第 17.8.3.1 节，“配置 InnoDB 缓冲池大小”。

innodb_buffer_pool_debug

启用此选项允许在缓冲池小于 1GB 时使用多个缓冲池实例，忽略对 innodb_buffer_pool_instances 强加的 1GB 最小缓冲池大小约束。如果使用 WITH_DEBUG CMake 选项在编译时启用了调试支持，则 innodb_buffer_pool_debug 选项才可用。

innodb_buffer_pool_dump_at_shutdown

指定在 MySQL 服务器关闭时是否记录在 InnoDB 缓冲池 中缓存的页面，以缩短下次重启时的 预热 过程。通常与 innodb_buffer_pool_load_at_startup 结合使用。 innodb_buffer_pool_dump_pct 选项定义要转储的最常用的缓冲池页面的百分比。

innodb_buffer_pool_dump_at_shutdown 和 innodb_buffer_pool_load_at_startup 默认情况下都已启用。

有关更多信息，请参见 第 17.8.3.6 节，“保存和还原缓冲池状态”。

innodb_buffer_pool_dump_now

立即记录在 InnoDB 缓冲池 中缓存的页面。通常与 innodb_buffer_pool_load_now 结合使用。

启用 innodb_buffer_pool_dump_now 会触发记录操作，但不会更改变量设置，变量设置始终保持为 OFF 或 0。要查看触发转储后缓冲池转储状态，请查询 Innodb_buffer_pool_dump_status 变量。

启用 innodb_buffer_pool_dump_now 会触发转储操作，但不会更改变量设置，变量设置始终保持为 OFF 或 0。要查看触发转储后缓冲池转储状态，请查询 Innodb_buffer_pool_dump_status 变量。

有关更多信息，请参见 第 17.8.3.6 节，“保存和还原缓冲池状态”。

innodb_buffer_pool_dump_pct

指定要读出和转储的每个缓冲池中最常用的页面的百分比。范围是 1 到 100。默认值为 25。例如，如果有 4 个缓冲池，每个缓冲池有 100 个页面，并且 innodb_buffer_pool_dump_pct 设置为 25，则会转储每个缓冲池中最常用的 25 个页面。

innodb_buffer_pool_filename

指定保存 innodb_buffer_pool_dump_at_shutdown 或 innodb_buffer_pool_dump_now 生成的表空间 ID 和页面 ID 列表的文件的名称。表空间 ID 和页面 ID 以以下格式保存：space, page_id。默认情况下，该文件名为 ib_buffer_pool，位于 InnoDB 数据目录中。必须相对于数据目录指定非默认位置。

可以使用 SET 语句在运行时指定文件名

SET GLOBAL innodb_buffer_pool_filename='file_name';

您也可以在启动时在启动字符串或 MySQL 配置文件中指定文件名。在启动时指定文件名时，该文件必须存在，否则 InnoDB 会返回启动错误，表明没有此文件或目录。

有关更多信息，请参见 第 17.8.3.6 节，“保存和还原缓冲池状态”。

innodb_buffer_pool_in_core_file

禁用（默认）innodb_buffer_pool_in_core_file 变量会通过排除 InnoDB 缓冲池页面来减少核心文件的大小。

要使用此变量，必须启用 core_file 变量，要禁用此选项，操作系统必须支持 MADV_DONTDUMP 对 madvise() 的非 POSIX 扩展，该扩展在 Linux 3.4 及更高版本中受支持。有关更多信息，请参见 第 17.8.3.7 节，“从核心文件中排除或包含缓冲池页面”。

在支持 MADV_DONTDUMP 的系统上，默认情况下此选项处于禁用状态，该扩展通常仅在 Linux 中受支持，而不在 macOS 或 Windows 中受支持。

在 MySQL 8.4 之前，此选项默认情况下处于启用状态。

innodb_buffer_pool_instances

InnoDB 缓冲池 分成的区域数。对于缓冲池处于多个千兆字节范围内的系统，将缓冲池划分为单独的实例可以提高并发性，方法是减少不同线程读写缓存页面时的争用。存储在缓冲池中或从缓冲池读取的每个页面都使用哈希函数随机分配给一个缓冲池实例。每个缓冲池都管理自己的空闲列表、刷新列表、LRU 以及与缓冲池关联的所有其他数据结构，并受到其自身缓冲池 互斥锁 的保护。

总缓冲池大小在所有缓冲池之间分配。为了获得最佳效率，请指定 innodb_buffer_pool_instances 和 innodb_buffer_pool_size 的组合，以便每个缓冲池实例至少为 1GB。

如果 innodb_buffer_pool_size <= 1 GiB，则默认的 innodb_buffer_pool_instances 值为 1。

如果 innodb_buffer_pool_size > 1 GiB，则默认的 innodb_buffer_pool_instances 值为以下两个计算提示中的最小值，范围在 1-64 之内

有关相关信息，请参见 第 17.8.3.1 节，“配置 InnoDB 缓冲池大小”。

innodb_buffer_pool_load_abort

中断由 innodb_buffer_pool_load_at_startup 或 innodb_buffer_pool_load_now 触发的恢复 InnoDB 缓冲池 内容的过程。

启用 innodb_buffer_pool_load_abort 会触发中止操作，但不会改变变量设置，变量始终保持 OFF 或 0。要查看触发中止操作后的缓冲池加载状态，请查询 Innodb_buffer_pool_load_status 变量。

有关更多信息，请参见 第 17.8.3.6 节，“保存和还原缓冲池状态”。

innodb_buffer_pool_load_at_startup

指定在 MySQL 服务器启动时，InnoDB 缓冲池 会通过加载它在之前时间段所持有的相同页面来自动 预热。通常与 innodb_buffer_pool_dump_at_shutdown 结合使用。

innodb_buffer_pool_dump_at_shutdown 和 innodb_buffer_pool_load_at_startup 默认情况下都已启用。

有关更多信息，请参见 第 17.8.3.6 节，“保存和还原缓冲池状态”。

innodb_buffer_pool_load_now

立即通过加载数据页面 预热 InnoDB 缓冲池，无需等待服务器重启。这在基准测试期间将缓存内存恢复到已知状态或在运行报表或维护查询后使 MySQL 服务器准备好恢复正常工作负载时非常有用。

启用 innodb_buffer_pool_load_now 会触发加载操作，但不会改变变量设置，变量始终保持 OFF 或 0。要查看触发加载操作后的缓冲池加载进度，请查询 Innodb_buffer_pool_load_status 变量。

有关更多信息，请参见 第 17.8.3.6 节，“保存和还原缓冲池状态”。

innodb_buffer_pool_size

缓冲池 的大小（以字节为单位），缓冲池是 InnoDB 缓存表和索引数据的内存区域。默认值为 134217728 字节（128 MB）。最大值取决于 CPU 架构；在 32 位系统上最大值为 4294967295（2³²-1），在 64 位系统上最大值为 18446744073709551615（2⁶⁴-1）。在 32 位系统上，CPU 架构和操作系统可能会对实际最大大小设置比规定最大值更低的限制。当缓冲池的大小大于 1GB 时，将 innodb_buffer_pool_instances 设置为大于 1 的值可以提高繁忙服务器的可扩展性。

更大的缓冲池需要更少的磁盘 I/O 才能多次访问相同的表数据。在专用的数据库服务器上，您可以将缓冲池大小设置为机器物理内存大小的 80%。在配置缓冲池大小时，请注意以下潜在问题，并准备好根据需要缩小缓冲池的大小。

当您增加或减少缓冲池大小时，操作是以块进行的。块大小由 innodb_buffer_pool_chunk_size 变量定义，默认值为 128 MB。

缓冲池大小必须始终等于或为 innodb_buffer_pool_chunk_size * innodb_buffer_pool_instances 的倍数。如果您将缓冲池大小更改为不等于或不为 innodb_buffer_pool_chunk_size * innodb_buffer_pool_instances 的倍数的值，缓冲池大小将自动调整为等于或为 innodb_buffer_pool_chunk_size * innodb_buffer_pool_instances 的倍数的值。

innodb_buffer_pool_size 可以动态设置，这允许您调整缓冲池的大小，而无需重新启动服务器。状态变量 Innodb_buffer_pool_resize_status 报告在线缓冲池调整大小操作的状态。有关更多信息，请参阅 第 17.8.3.1 节“配置 InnoDB 缓冲池大小”。

如果启用了 innodb_dedicated_server，如果未显式定义 innodb_buffer_pool_size 值，则会自动配置该值。有关更多信息，请参阅 第 17.8.12 节“为专用的 MySQL 服务器启用自动配置”。

innodb_change_buffer_max_size

InnoDB 更改缓冲区 的最大大小，以 缓冲池 总大小的百分比表示。对于具有大量插入、更新和删除活动的 MySQL 服务器，您可以增加此值；对于用于报表的具有不变数据的 MySQL 服务器，您可以减小此值。有关更多信息，请参阅 第 17.5.2 节“更改缓冲区”。有关一般 I/O 调整建议，请参阅 第 10.5.8 节“优化 InnoDB 磁盘 I/O”。

innodb_change_buffering

是否执行 InnoDB 更改缓冲，这是一种优化，可以延迟对辅助索引的写入操作，以便可以顺序执行 I/O 操作。允许的值在以下表格中描述。值也可以用数字表示。

在 MySQL 8.4 之前，默认值为 all。

有关更多信息，请参阅 第 17.5.2 节“更改缓冲区”。有关一般 I/O 调整建议，请参阅 第 10.5.8 节“优化 InnoDB 磁盘 I/O”。

innodb_change_buffering_debug

为 InnoDB 更改缓冲设置调试标志。值为 1 会强制所有更改到更改缓冲区。值为 2 会在合并时导致意外退出。默认值为 0，表示未设置更改缓冲调试标志。此选项仅在使用 WITH_DEBUG CMake 选项编译调试支持时可用。

innodb_checkpoint_disabled

这是一个调试选项，仅供专家调试使用。它会禁用检查点，以便故意服务器退出始终会启动 InnoDB 恢复。它只应在短时间内启用，通常在运行会写入重做日志条目（在服务器退出后需要恢复）的 DML 操作之前启用。此选项仅在使用 WITH_DEBUG CMake 选项编译调试支持时可用。

innodb_checksum_algorithm

指定如何生成和验证存储在 InnoDB 表空间 磁盘块中的 校验和。 innodb_checksum_algorithm 的默认值为 crc32。

值 innodb 向后兼容早期版本的 MySQL。值 crc32 使用的算法计算每个修改块的校验和的速度更快，并且检查每个磁盘读取的校验和的速度也更快。它一次扫描 64 位的块，比 innodb 校验和算法（一次扫描 8 位的块）更快。值 none 会在校验和字段中写入一个常数值，而不是根据块数据计算一个值。表空间中的块可以使用旧校验和值、新校验和值和无校验和值的混合，并在数据修改时逐步更新；一旦表空间中的块被修改为使用 crc32 算法，早期版本的 MySQL 就无法读取相关的表。

校验和算法的严格形式会在遇到表空间中有效的但与校验和值不匹配的值时报告错误。建议您只在新实例中使用严格设置，以首次设置表空间。严格设置稍微快一些，因为它们不需要在磁盘读取期间计算所有校验和值。

下表显示了 none、innodb 和 crc32 选项值及其严格对应值之间的差异。 none、innodb 和 crc32 会将指定的校验和值类型写入每个数据块中，但出于兼容性考虑，在读取操作期间验证块时会接受其他校验和值。严格设置也会接受有效的校验和值，但会在遇到有效的与校验和值不匹配的值时打印错误消息。如果实例中的所有 InnoDB 数据文件都在相同的 innodb_checksum_algorithm 值下创建，则使用严格形式可以使验证更快。

innodb_cmp_per_index_enabled

在信息架构 INNODB_CMP_PER_INDEX 表中启用与每个索引相关的压缩统计信息。由于收集这些统计信息可能很昂贵，因此仅在性能调整与 InnoDB 压缩 表相关的开发、测试或副本实例上启用此选项。

有关更多信息，请参见 第 28.4.8 节，“INFORMATION_SCHEMA INNODB_CMP_PER_INDEX 和 INNODB_CMP_PER_INDEX_RESET 表” 和 第 17.9.1.4 节，“在运行时监控 InnoDB 表压缩”。

innodb_commit_concurrency

可以同时 提交 的 线程 数量。值为 0（默认值）允许任意数量的 事务 同时提交。

在运行时，无法将 innodb_commit_concurrency 的值从零更改为非零，反之亦然。该值可以从一个非零值更改为另一个非零值。

innodb_compress_debug

使用指定的压缩算法压缩所有表，而无需为每个表定义 COMPRESSION 属性。此选项仅在使用 WITH_DEBUG CMake 选项编译调试支持时可用。

有关相关信息，请参见 第 17.9.2 节，“InnoDB 页面压缩”。

innodb_compression_failure_threshold_pct

定义表的压缩失败率阈值（以百分比表示），当压缩失败率达到该阈值时，MySQL 会开始在 压缩 页面中添加填充以避免昂贵的 压缩失败。当超过此阈值时，MySQL 会开始在每个新的压缩页面中保留额外的空闲空间，动态调整空闲空间量，直到达到由 innodb_compression_pad_pct_max 指定的页面大小百分比。值为零将禁用监控压缩效率和动态调整填充量的机制。

有关更多信息，请参见 第 17.9.1.6 节，“OLTP 工作负载的压缩”。

innodb_compression_level

指定 InnoDB 压缩 表和索引要使用的 zlib 压缩级别。较高的值可以让您将更多数据放入存储设备，但压缩过程的 CPU 开销会更大。较低的值可以让您在存储空间不紧张的情况下减少 CPU 开销，或者您预计数据不容易压缩。

有关更多信息，请参见 第 17.9.1.6 节，“OLTP 工作负载的压缩”。

innodb_compression_pad_pct_max

指定可以在每个压缩的 页面 中作为空闲空间保留的最大百分比，允许在更新 压缩 表或索引时在页面内重新组织数据和修改日志，因为数据可能需要重新压缩。仅在 innodb_compression_failure_threshold_pct 设置为非零值且 压缩失败 率超过临界点时适用。

有关更多信息，请参见 第 17.9.1.6 节，“OLTP 工作负载的压缩”。

innodb_concurrency_tickets

确定可以同时进入 InnoDB 的 线程 数量。如果线程数量已达到并发限制，则线程在尝试进入 InnoDB 时会被放入队列中。当允许线程进入 InnoDB 时，它会获得一定数量的 “ 票据”，数量等于 innodb_concurrency_tickets 的值，并且线程可以自由地进入和离开 InnoDB，直到它用完票据。在此之后，线程在下次尝试进入 InnoDB 时，会再次受到并发检查（以及可能的排队）的约束。默认值为 5000。

如果 innodb_concurrency_tickets 值较小，则仅需处理几行的小型事务就可以与处理大量行的大型事务进行公平竞争。innodb_concurrency_tickets 值较小的缺点是，大型事务必须在队列中循环多次才能完成，这会延长它们完成任务所需的时间。

如果 innodb_concurrency_tickets 值较大，则大型事务在等待队列末尾的位置（受 innodb_thread_concurrency 控制）上花费的时间更少，在检索行上花费的时间更多。大型事务还需要更少的往返次数才能完成任务。innodb_concurrency_tickets 值较大的缺点是，同时运行太多大型事务可能会使小型事务饿死，因为小型事务需要等待更长时间才能执行。

如果 innodb_thread_concurrency 值为非零，则您可能需要调整 innodb_concurrency_tickets 的值，以找到大型事务和小型事务之间的最佳平衡。 SHOW ENGINE INNODB STATUS 报告显示了正在执行的事务在其当前的队列传递过程中剩余的票据数量。此数据也可以从信息架构 INNODB_TRX 表的 TRX_CONCURRENCY_TICKETS 列中获取。

有关更多信息，请参见 第 17.8.4 节，“为 InnoDB 配置线程并发性”。

innodb_data_file_path

定义 InnoDB 系统表空间数据文件的名称、大小和属性。如果您未为 innodb_data_file_path 指定值，则默认行为是创建一个名为 ibdata1 的单个自动扩展数据文件，其大小略大于 12MB。

数据文件规范的完整语法包括文件名、文件大小、autoextend 属性和 max 属性

file_name:file_size[:autoextend[:max:max_file_size]]

文件大小以 KB、MB 或 GB 为单位指定，在大小值后附加 K、M 或 G。如果以 KB 为单位指定数据文件大小，请以 1024 的倍数指定。否则，KB 值将四舍五入到最接近的 MB 边界。文件大小之和至少应略大于 12MB。

有关其他配置信息，请参见 系统表空间数据文件配置。有关调整大小说明，请参见 调整系统表空间大小。

innodb_data_home_dir

InnoDB 系统表空间 数据文件的目录路径的公共部分。默认值为 MySQL data 目录。该设置与 innodb_data_file_path 设置连接在一起，除非该设置定义了绝对路径。

为 innodb_data_home_dir 指定值时，需要在末尾加上斜杠。例如

[mysqld]
innodb_data_home_dir = /path/to/myibdata/

此设置不会影响 每个表一个文件 表空间的位置。

有关相关信息，请参见 第 17.8.1 节，“InnoDB 启动配置”。

innodb_ddl_buffer_size

定义 DDL 操作的最大缓冲区大小。默认设置为 1048576 字节（约 1 MB）。适用于创建或重建辅助索引的在线 DDL 操作。请参见 第 17.12.4 节，“在线 DDL 内存管理”。每个 DDL 线程的最大缓冲区大小为最大缓冲区大小除以 DDL 线程数量 (innodb_ddl_buffer_size/innodb_ddl_threads)。

innodb_ddl_log_crash_reset_debug

启用此调试选项以将 DDL 日志崩溃注入计数器重置为 1。此选项仅在使用 WITH_DEBUG CMake 选项编译调试支持时可用。

innodb_ddl_threads

定义索引创建的排序和构建阶段的并行线程的最大数量。适用于创建或重建辅助索引的在线 DDL 操作。有关相关信息，请参见 第 17.12.5 节，“配置在线 DDL 操作的并行线程” 和 第 17.12.4 节，“在线 DDL 内存管理”。

innodb_deadlock_detect

此选项用于禁用死锁检测。在高并发系统中，死锁检测会导致大量线程等待同一锁时出现速度变慢。有时，禁用死锁检测并依赖于innodb_lock_wait_timeout设置来回滚事务（当发生死锁时）可能更有效。

有关相关信息，请参见第 17.7.5.2 节，“死锁检测”。

innodb_dedicated_server

当innodb_dedicated_server启用时，InnoDB会自动配置以下变量

仅当 MySQL 实例驻留在可以使用所有可用系统资源的专用服务器上时，才考虑启用innodb_dedicated_server。如果 MySQL 实例与其他应用程序共享系统资源，则不建议启用innodb_dedicated_server。

有关更多信息，请参见第 17.8.12 节，“为专用 MySQL 服务器启用自动配置”。

innodb_default_row_format

innodb_default_row_format选项定义了InnoDB表和用户创建的临时表的默认行格式。默认设置为DYNAMIC。其他允许的值是COMPACT和REDUNDANT。在系统表空间中不支持使用COMPRESSED行格式，因此不能将其定义为默认格式。

当未明确指定ROW_FORMAT选项或使用ROW_FORMAT=DEFAULT时，新创建的表将使用innodb_default_row_format定义的行格式。

当未明确指定ROW_FORMAT选项或使用ROW_FORMAT=DEFAULT时，任何重建表的操作也会静默地将表的行格式更改为innodb_default_row_format定义的格式。有关更多信息，请参见定义表的行格式。

服务器创建的用于处理查询的内部InnoDB临时表将使用DYNAMIC行格式，而不管innodb_default_row_format设置如何。

innodb_directories

定义在启动时扫描以查找表空间文件目录。当服务器处于脱机状态时，此选项用于将表空间文件移动或还原到新位置。它还用于指定使用绝对路径创建的或位于数据目录之外的表空间文件的目录。

崩溃恢复期间的表空间发现依赖于innodb_directories设置来标识重做日志中引用的表空间。有关更多信息，请参见崩溃恢复期间的表空间发现。

默认值为 NULL，但由innodb_data_home_dir、innodb_undo_directory和datadir定义的目录始终追加到innodb_directories参数值，当InnoDB在启动时构建要扫描的目录列表时。无论是否明确指定innodb_directories设置，都会追加这些目录。

innodb_directories可以作为启动命令中的选项或 MySQL 选项文件中的选项指定。使用引号将参数值括起来，因为否则一些命令解释器会将分号 (;) 解释为特殊字符。（例如，Unix shell 将其视为命令终止符。）

启动命令

mysqld --innodb-directories="directory_path_1;directory_path_2"

MySQL 选项文件

[mysqld]
innodb_directories="directory_path_1;directory_path_2"

不能使用通配符表达式来指定目录。

innodb_directories扫描还会遍历指定目录的子目录。重复的目录和子目录将从要扫描的目录列表中丢弃。

有关更多信息，请参见第 17.6.3.6 节，“服务器处于脱机状态时移动表空间文件”。

innodb_disable_sort_file_cache

禁用合并排序临时文件的操作系统文件系统缓存。其效果是使用等效于O_DIRECT的方式打开这些文件。

innodb_doublewrite

innodb_doublewrite变量控制双写缓冲。在大多数情况下，双写缓冲默认启用。

在启动服务器时，可以将innodb_doublewrite设置为ON或OFF，分别启用或禁用双写缓冲。 DETECT_AND_RECOVER与ON相同。使用此设置，除了双写缓冲已完全启用外，数据库页面内容还将写入双写缓冲，在恢复期间访问该缓冲，以修复不完整的页面写入。使用DETECT_ONLY，仅元数据写入双写缓冲。数据库页面内容不会写入双写缓冲，恢复不会使用双写缓冲来修复不完整的页面写入。此轻量级设置旨在仅用于检测不完整的页面写入。

MySQL 支持对innodb_doublewrite设置的动态更改，该设置启用双写缓冲，介于ON、DETECT_AND_RECOVER和DETECT_ONLY之间。MySQL 不支持启用双写缓冲的设置和OFF之间的动态更改，反之亦然。

如果双写缓冲位于支持原子写入的 Fusion-io 设备上，则双写缓冲将自动禁用，数据文件写入将使用 Fusion-io 原子写入代替。但是，请注意，innodb_doublewrite设置是全局的。当双写缓冲禁用时，它将对所有数据文件禁用，包括那些不在 Fusion-io 硬件上的文件。此功能仅在 Fusion-io 硬件上受支持，并且仅针对 Linux 上的 Fusion-io NVMFS 启用。为了充分利用此功能，建议innodb_flush_method设置为O_DIRECT。

有关相关信息，请参见第 17.6.4 节，“双写缓冲”。

innodb_doublewrite_batch_size

此变量最初用于表示要批处理写入的双写页面的数量。此功能已由innodb_doublewrite_pages取代。

有关更多信息，请参见第 17.6.4 节，“双写缓冲”。

innodb_doublewrite_dir

定义双写文件的目录。如果未指定目录，则双写文件将在innodb_data_home_dir目录中创建，该目录默认为未指定的数据目录。

有关更多信息，请参见第 17.6.4 节，“双写缓冲”。

innodb_doublewrite_files

定义双写文件的数量。默认情况下，每个缓冲池实例会创建两个双写文件。

至少有两个双写文件。双写文件的最大数量是缓冲池实例数量的两倍。（缓冲池实例的数量由innodb_buffer_pool_instances变量控制。）

有关更多信息，请参见第 17.6.4 节，“双写缓冲”。

innodb_doublewrite_pages

定义每个线程的批处理写入的最大双写页面数量。如果未指定值，则innodb_doublewrite_pages默认为 128。

在 MySQL 8.4 之前，默认值为innodb_write_io_threads值，默认值为 4。

有关更多信息，请参见第 17.6.4 节，“双写缓冲”。

innodb_extend_and_initialize

控制在 Linux 系统上如何为每个文件一个表和通用表空间分配空间。

启用后，InnoDB会将 NULL 写入新分配的页面。禁用后，将使用posix_fallocate()调用分配空间，该调用会保留空间，但不会实际写入 NULL。

有关更多信息，请参见第 17.6.3.8 节，“优化 Linux 上的表空间空间分配”。

innodb_fast_shutdown

InnoDB 关闭模式。如果值为 0，则InnoDB执行缓慢关闭，完整清除和更改缓冲合并，然后关闭。如果值为 1（默认值），则InnoDB会在关闭时跳过这些操作，这是一个称为快速关闭的过程。如果值为 2，则InnoDB会刷新其日志并冷关闭，就像 MySQL 崩溃了一样；不会丢失已提交的事务，但崩溃恢复操作会使下次启动时间更长。

缓慢关闭可能需要几分钟，甚至在数据量很大且仍在缓冲的情况下可能需要几个小时。在 MySQL 主要版本之间进行升级或降级之前，请使用缓慢关闭技术，以便在升级过程更新文件格式时，所有数据文件都已完全准备就绪。

在紧急情况下或进行故障排除时，请使用innodb_fast_shutdown=2，以便在数据有损坏风险时获得最快的关闭速度。

innodb_fil_make_page_dirty_debug

默认情况下，将 innodb_fil_make_page_dirty_debug 设置为表空间的 ID 会立即使表空间的第一页变脏。如果 innodb_saved_page_number_debug 设置为非默认值，则将 innodb_fil_make_page_dirty_debug 设置为指定页会使该页变脏。 innodb_fil_make_page_dirty_debug 选项仅在使用 WITH_DEBUG CMake 选项编译了调试支持的情况下可用。

innodb_file_per_table

当 innodb_file_per_table 启用时，默认情况下，表将创建在每表文件表空间中。禁用时，默认情况下，表将创建在系统表空间中。有关每表文件表空间的信息，请参见 第 17.6.3.2 节，“每表文件表空间”。有关 InnoDB 系统表空间的信息，请参见 第 17.6.3.1 节，“系统表空间”。

可以使用 SET GLOBAL 语句在运行时配置 innodb_file_per_table 变量，在启动时在命令行上指定，或在选项文件中指定。运行时配置需要足够的权限来设置全局系统变量（请参见 第 7.1.9.1 节，“系统变量权限”），并立即影响所有连接的操作。

当位于每表文件表空间中的表被截断或删除时，释放的空间将返回到操作系统。截断或删除位于系统表空间中的表仅释放系统表空间中的空间。系统表空间中的释放空间可以再次用于 InnoDB 数据，但不会返回到操作系统，因为系统表空间数据文件永远不会缩小。

innodb_file_per-table 设置不会影响临时表的创建；临时表将在会话临时表空间中创建。请参见 第 17.6.3.5 节，“临时表空间”。

innodb_fill_factor

InnoDB 在创建或重建索引时执行批量加载。这种索引创建方法被称为 “排序索引构建”。

innodb_fill_factor 定义了在排序索引构建期间填充每个 B 树页面的空间百分比，剩余空间保留用于未来的索引增长。例如，将 innodb_fill_factor 设置为 80 会保留每个 B 树页面 20% 的空间以供未来的索引增长。实际百分比可能会有所不同。 innodb_fill_factor 设置被解释为一个提示而不是一个硬限制。

innodb_fill_factor 设置为 100 会在聚簇索引页面中留下 1/16 的空间以供未来的索引增长。

innodb_fill_factor 适用于 B 树叶页面和非叶页面。它不适用于用于 TEXT 或 BLOB 条目的外部页面。

有关更多信息，请参见 第 17.6.2.3 节，“排序索引构建”。

innodb_flush_log_at_timeout

每 N 秒写入并刷新日志。 innodb_flush_log_at_timeout 允许增加刷新之间的超时时间，以减少刷新并避免影响二进制日志组提交的性能。 innodb_flush_log_at_timeout 的默认设置为每秒一次。

innodb_flush_log_at_trx_commit

控制严格的 ACID 兼容性与 提交 操作之间以及更高性能之间的平衡，这种性能可以在提交相关的 I/O 操作重新排列并以批处理方式完成时实现。您可以通过更改默认值来获得更好的性能，但这样您可能会在崩溃时丢失事务。

对于使用带有事务的 InnoDB 的复制设置的持久性和一致性

有关在最能抵御意外停止的副本上设置组合的信息，请参见 第 19.4.2 节，“处理副本的意外停止”。

innodb_flush_method

定义用于将数据 刷新 到 InnoDB 数据文件 和 日志文件 的方法，这会影响 I/O 吞吐量。

在类 Unix 系统上，默认值为 O_DIRECT（如果支持），否则默认为 fsync。在 Windows 上，默认值为 unbuffered。

innodb_flush_method 的类 Unix 系统选项包括

在支持 fdatasync() 系统调用的平台上， innodb_use_fdatasync 变量允许使用 fsync() 的 innodb_flush_method 选项改用 fdatasync()。 fdatasync() 系统调用不会刷新对文件元数据的更改，除非后续数据检索需要这样做，从而提供潜在的性能优势。

Windows 系统的 innodb_flush_method 选项包括

每个设置如何影响性能取决于硬件配置和工作负载。对您的特定配置进行基准测试以确定使用哪个设置，或是否保留默认设置。检查 Innodb_data_fsyncs 状态变量以查看每个设置的 fsync() 调用（或如果启用了 innodb_use_fdatasync，则为 fdatasync() 调用）的总数。工作负载中读写操作的混合会影响设置的执行方式。例如，在具有硬件 RAID 控制器和电池支持的写入缓存的系统上，O_DIRECT 可以帮助避免 InnoDB 缓冲池和操作系统文件系统缓存之间的双重缓冲。在某些系统上，InnoDB 数据和日志文件位于 SAN 上，对于主要包含 SELECT 语句的读密集型工作负载，默认值或 O_DSYNC 可能更快。始终使用反映您的生产环境的硬件和工作负载测试此参数。有关一般 I/O 调优建议，请参阅 第 10.5.8 节，“优化 InnoDB 磁盘 I/O”。

innodb_flush_neighbors

指定从 InnoDB 缓冲池 刷新页面是否也会刷新同一 扩展 中的其他 脏页面。

当表数据存储在传统的 HDD 存储设备上时，与分别在不同时间刷新单个页面相比，在一项操作中刷新此类 相邻页面 会减少 I/O 开销（主要是磁盘寻道操作）。对于存储在 SSD 上的表数据，寻道时间不是一个重要因素，您可以将此选项设置为 0 以分散写入操作。有关相关信息，请参阅 第 17.8.3.5 节，“配置缓冲池刷新”。

innodb_flush_sync

innodb_flush_sync 变量默认启用，会导致 innodb_io_capacity 和 innodb_io_capacity_max 设置在 检查点 处发生的 I/O 活动突发期间被忽略。要遵守 innodb_io_capacity 和 innodb_io_capacity_max 定义的 I/O 速率，请禁用 innodb_flush_sync。

有关配置 innodb_flush_sync 变量的信息，请参阅 第 17.8.7 节，“配置 InnoDB I/O 容量”。

innodb_flushing_avg_loops

InnoDB 保持先前计算的刷新状态快照的迭代次数，控制 自适应刷新 对不断变化的 工作负载 的响应速度。增加值会使刷新操作的速率随着工作负载的变化而平稳且逐渐地改变。减小值会使自适应刷新快速调整以适应工作负载的变化，如果工作负载突然增加和减少，这会导致刷新活动的峰值。

有关相关信息，请参阅 第 17.8.3.5 节，“配置缓冲池刷新”。

innodb_force_load_corrupted

允许 InnoDB 在启动时加载标记为损坏的表。仅在故障排除期间使用，以恢复否则无法访问的数据。故障排除完成后，禁用此设置并重新启动服务器。

innodb_force_recovery

崩溃恢复 模式，通常仅在严重的故障排除情况下更改。可能的值从 0 到 6。有关这些值的含义以及有关 innodb_force_recovery 的重要信息，请参阅 第 17.20.3 节，“强制 InnoDB 恢复”。

innodb_fsync_threshold

默认情况下，当 InnoDB 创建新的数据文件（例如新的日志文件或表空间文件）时，文件将在刷新到磁盘之前完全写入操作系统缓存，这会导致大量磁盘写入活动同时发生。要强制从操作系统缓存中进行较小、定期地刷新数据，可以使用 innodb_fsync_threshold 变量定义一个阈值（以字节为单位）。当达到字节阈值时，操作系统缓存的内容将刷新到磁盘。默认值为 0，强制执行默认行为，即仅在文件完全写入缓存后才将数据刷新到磁盘。

指定阈值以强制进行较小、定期地刷新在多个 MySQL 实例使用同一存储设备的情况下可能是有益的。例如，创建新的 MySQL 实例及其关联的数据文件会导致大量的磁盘写入活动突发，从而阻碍使用同一存储设备的其他 MySQL 实例的性能。配置阈值有助于避免此类写入活动突发。

innodb_ft_aux_table

指定包含 FULLTEXT 索引的 InnoDB 表的限定名称。此变量用于诊断目的，只能在运行时设置。例如

SET GLOBAL innodb_ft_aux_table = 'test/t1';

在将此变量设置为 db_name/table_name 格式的名称后，INFORMATION_SCHEMA 表 INNODB_FT_INDEX_TABLE、INNODB_FT_INDEX_CACHE、INNODB_FT_CONFIG、INNODB_FT_DELETED 和 INNODB_FT_BEING_DELETED 将显示有关指定表的搜索索引的信息。

有关更多信息，请参阅 第 17.15.4 节，“InnoDB INFORMATION_SCHEMA FULLTEXT 索引表”。

innodb_ft_cache_size

为 InnoDB FULLTEXT 搜索索引缓存分配的内存（以字节为单位），该缓存在创建 InnoDB FULLTEXT 索引时将解析后的文档保存在内存中。仅当达到 innodb_ft_cache_size 大小限制时，索引插入和更新才会提交到磁盘。 innodb_ft_cache_size 定义了每个表的缓存大小。要为所有表设置全局限制，请参阅 innodb_ft_total_cache_size。

有关更多信息，请参阅 InnoDB 全文索引缓存。

innodb_ft_enable_diag_print

是否启用其他全文搜索 (FTS) 诊断输出。此选项主要用于高级 FTS 调试，大多数用户不感兴趣。输出将打印到错误日志，包括以下信息：

innodb_ft_enable_stopword

指定在创建索引时，一组 停用词 与 InnoDB FULLTEXT 索引相关联。如果设置了 innodb_ft_user_stopword_table 选项，则停用词将取自该表。否则，如果设置了 innodb_ft_server_stopword_table 选项，则停用词将取自该表。否则，将使用一组内置的默认停用词。

有关更多信息，请参阅 第 14.9.4 节，“全文停用词”。

innodb_ft_max_token_size

存储在 InnoDB FULLTEXT 索引中的单词的最大字符长度。通过省略不属于真实单词且不太可能是搜索词的长关键字或任意字母组合来设置此值的限制可以减小索引的大小，从而通过省略长关键字或任意字母组合来加快查询速度。

有关更多信息，请参阅 第 14.9.6 节，“微调 MySQL 全文搜索”。

innodb_ft_min_token_size

存储在 InnoDB FULLTEXT 索引中的词的最小长度。增加此值会减小索引的大小，从而通过省略在搜索上下文中不太可能重要的常见词来加快查询速度，例如英语单词 “a” 和 “to”。对于使用 CJK（中文、日语、韩语）字符集的内容，请指定值为 1。

有关更多信息，请参阅 第 14.9.6 节，“微调 MySQL 全文搜索”。

innodb_ft_num_word_optimize

在对 InnoDB FULLTEXT 索引执行每次 OPTIMIZE TABLE 操作期间要处理的单词数。由于对包含全文搜索索引的表的批量插入或更新操作可能需要大量的索引维护才能合并所有更改，因此您可能需要执行一系列 OPTIMIZE TABLE 语句，每个语句都从上一个语句停止的地方继续。

有关更多信息，请参阅 第 14.9.6 节，“微调 MySQL 全文搜索”。

innodb_ft_result_cache_limit

每个全文搜索查询或每个线程的 InnoDB 全文搜索查询结果缓存限制（以字节为单位）。中间和最终的 InnoDB 全文搜索查询结果在内存中处理。使用 innodb_ft_result_cache_limit 对全文搜索查询结果缓存设置大小限制，以避免在 InnoDB 全文搜索查询结果非常大（例如，数百万或数亿行）的情况下过度消耗内存。在处理全文搜索查询时，会根据需要分配内存。如果达到结果缓存大小限制，则会返回一个错误，指示查询超过了允许的最大内存。

对于所有平台类型和位大小，innodb_ft_result_cache_limit 的最大值为 2**32-1。

innodb_ft_server_stopword_table

此选项用于为所有 InnoDB 表指定您自己的 InnoDB FULLTEXT 索引停用词列表。要为特定 InnoDB 表配置您自己的停用词列表，请使用 innodb_ft_user_stopword_table。

将 innodb_ft_server_stopword_table 设置为包含停用词列表的表的名称，格式为 db_name/table_name。

您必须在配置 innodb_ft_server_stopword_table 之前创建停用词表。您必须在创建 FULLTEXT 索引之前启用 innodb_ft_enable_stopword 并且配置 innodb_ft_server_stopword_table 选项。

停用词表必须是 InnoDB 表，包含一个名为 value 的单个 VARCHAR 列。

有关更多信息，请参阅 第 14.9.4 节，“全文停用词”。

innodb_ft_sort_pll_degree

在构建 搜索索引 时，用于并行索引和标记 InnoDB FULLTEXT 索引中文本的线程数。

有关相关信息，请参阅 第 17.6.2.4 节，“InnoDB 全文索引” 和 innodb_sort_buffer_size。

innodb_ft_total_cache_size

为所有表的 InnoDB 全文搜索索引缓存分配的总内存（以字节为单位）。创建多个每个表都具有 FULLTEXT 搜索索引的表可能会消耗大量可用内存。innodb_ft_total_cache_size 为所有全文搜索索引定义一个全局内存限制，以帮助避免过度消耗内存。如果索引操作达到全局限制，则会触发强制同步。

有关更多信息，请参阅 InnoDB 全文索引缓存。

innodb_ft_user_stopword_table

此选项用于在特定表上指定您自己的 InnoDB FULLTEXT 索引停用词列表。要为所有 InnoDB 表配置您自己的停用词列表，请使用 innodb_ft_server_stopword_table。

将 innodb_ft_user_stopword_table 设置为包含停用词列表的表的名称，格式为 db_name/table_name。

您必须在配置 innodb_ft_user_stopword_table 之前创建停用词表。您必须在创建 FULLTEXT 索引之前启用 innodb_ft_enable_stopword 并且配置 innodb_ft_user_stopword_table。

停用词表必须是 InnoDB 表，包含一个名为 value 的单个 VARCHAR 列。

有关更多信息，请参阅 第 14.9.4 节，“全文停用词”。

innodb_idle_flush_pct

限制 InnoDB 空闲时的页面刷新。innodb_idle_flush_pct 值是 innodb_io_capacity 设置的百分比，该设置定义了可用于 InnoDB 的每秒 I/O 操作数。有关更多信息，请参阅 限制空闲期间的缓冲区刷新。

innodb_io_capacity

innodb_io_capacity 变量定义了可用于 InnoDB 后台任务（如从 缓冲池 刷新页面以及合并来自 更改缓冲区 的数据的每秒 I/O 操作数（IOPS）。

有关配置 innodb_io_capacity 变量的信息，请参阅 第 17.8.7 节，“配置 InnoDB I/O 容量”。

innodb_io_capacity_max

如果刷新活动落后，InnoDB 可以更积极地刷新，以比 innodb_io_capacity 变量定义的更高的每秒 I/O 操作数（IOPS）速率执行刷新。innodb_io_capacity_max 变量在这种情况下定义了 InnoDB 后台任务执行的 IOPS 的最大数量。此选项不控制 innodb_flush_sync 行为。

默认值为 innodb_io_capacity 值的两倍。

有关配置 innodb_io_capacity_max 变量的信息，请参阅 第 17.8.7 节，“配置 InnoDB I/O 容量”。

innodb_limit_optimistic_insert_debug

限制每个 B 树 页面的记录数。默认值为 0 表示没有施加限制。此选项仅在使用 WITH_DEBUG CMake 选项编译了调试支持的情况下才可用。

innodb_lock_wait_timeout

InnoDB 事务 在放弃之前等待 行锁 的时间长度（以秒为单位）。默认值为 50 秒。尝试访问被另一个 InnoDB 事务锁定的行的交易最多等待这么长时间才能获得对该行的写入访问权限，然后发出以下错误

ERROR 1205 (HY000): Lock wait timeout exceeded; try restarting transaction

发生锁等待超时时，当前语句将 回滚（而不是整个事务）。要使整个事务回滚，请使用 --innodb-rollback-on-timeout 选项启动服务器。另请参阅 第 17.20.5 节，“InnoDB 错误处理”。

您可以为高度交互式应用程序或 OLTP 系统减少此值，以便快速显示用户反馈或将更新排队以供稍后处理。您可以为长时间运行的后台操作（例如数据仓库中等待其他大型插入或更新操作完成的转换步骤）增加此值。

innodb_lock_wait_timeout 应用于 InnoDB 行锁。MySQL 表锁 不会在 InnoDB 内部发生，因此此超时不适用于等待表锁的时间。

锁等待超时值不适用于 死锁，因为当 innodb_deadlock_detect 启用（默认值）时，InnoDB 会立即检测到死锁并回滚其中一个死锁事务。当 innodb_deadlock_detect 禁用时，InnoDB 依赖 innodb_lock_wait_timeout 来在发生死锁时回滚事务。请参阅 第 17.7.5.2 节，“死锁检测”。

innodb_lock_wait_timeout 可以使用 SET GLOBAL 或 SET SESSION 语句在运行时设置。更改 GLOBAL 设置需要设置全局系统变量的权限（请参阅 第 7.1.9.1 节，“系统变量权限”），并且会影响随后连接的所有客户端。任何客户端都可以更改 innodb_lock_wait_timeout 的 SESSION 设置，这只会影响该客户端。

innodb_log_buffer_size

用于InnoDB将数据写入磁盘日志文件的缓冲区大小（以字节为单位）。默认值为 64MB。较大的日志缓冲区 允许较大的事务运行，而无需在事务提交之前将日志写入磁盘。因此，如果您的事务更新、插入或删除了大量行，增大日志缓冲区的大小可以节省磁盘 I/O。有关相关信息，请参见内存配置和第 10.5.4 节“优化 InnoDB 重做日志记录”。有关一般 I/O 调整建议，请参见第 10.5.8 节“优化 InnoDB 磁盘 I/O”。

innodb_log_checkpoint_fuzzy_now

启用此调试选项以强制InnoDB写入模糊检查点。此选项仅在使用WITH_DEBUG CMake选项编译了调试支持的情况下才可用。

innodb_log_checkpoint_now

启用此调试选项以强制InnoDB写入检查点。此选项仅在使用WITH_DEBUG CMake选项编译了调试支持的情况下才可用。

innodb_log_checksums

启用或禁用重做日志页面的校验和。

innodb_log_checksums=ON启用重做日志页面CRC-32C校验和算法。禁用innodb_log_checksums时，将忽略重做日志页面校验和字段的内容。

重做日志头页面和重做日志检查点页面的校验和永远不会被禁用。

innodb_log_compressed_pages

指定是否将重新压缩的页面的镜像写入重做日志。当对压缩数据进行更改时，可能会发生重新压缩。

innodb_log_compressed_pages默认情况下处于启用状态，以防止在恢复期间使用不同版本的zlib压缩算法时可能发生的损坏。如果您确定zlib版本不会发生更改，您可以禁用innodb_log_compressed_pages，以减少修改压缩数据的负载的重做日志生成。

要衡量启用或禁用innodb_log_compressed_pages的影响，请在相同负载下比较两种设置下的重做日志生成。衡量重做日志生成的方法包括观察SHOW ENGINE INNODB STATUS输出的LOG部分中的Log sequence number (LSN)，或者监控Innodb_os_log_written状态以获取写入重做日志文件的字节数。

有关相关信息，请参见第 17.9.1.6 节“OLTP 工作负载的压缩”。

innodb_log_file_size

每个日志文件在日志组中的大小（以字节为单位）。日志文件的大小总和（innodb_log_file_size * innodb_log_files_in_group）不能超过略小于 512GB 的最大值。例如，一对 255 GB 日志文件接近限制，但不会超过限制。默认值为 48MB。

通常，日志文件的大小总和应该足够大，以使服务器能够平滑工作负载活动的峰值和低谷，这通常意味着有足够的重做日志空间来处理超过一小时的写入活动。该值越大，缓冲池中所需的检查点刷新活动越少，从而节省磁盘 I/O。较大的日志文件也会使崩溃恢复变慢。

innodb_log_file_size的最小值为 4MB。

有关相关信息，请参见重做日志配置。有关一般 I/O 调整建议，请参见第 10.5.8 节“优化 InnoDB 磁盘 I/O”。

如果启用了innodb_dedicated_server，则如果未明确定义innodb_log_file_size值，则会自动配置该值。有关更多信息，请参见第 17.8.12 节“为专用 MySQL 服务器启用自动配置”。

innodb_log_files_in_group

日志组中的日志文件数量。InnoDB以循环方式写入文件。默认值（推荐值）为 2。文件的位置由innodb_log_group_home_dir指定。日志文件的大小总和（innodb_log_file_size * innodb_log_files_in_group）可以高达 512GB。

有关相关信息，请参见重做日志配置。

如果启用了innodb_dedicated_server，则如果未明确定义innodb_log_files_in_group，则会自动配置该值。有关更多信息，请参见第 17.8.12 节“为专用 MySQL 服务器启用自动配置”。

innodb_log_group_home_dir

InnoDB 重做日志文件的目录路径。

有关相关信息，请参见重做日志配置。

innodb_log_spin_cpu_abs_lwm

定义用户线程在等待刷新重做时不再旋转的 CPU 使用量的最小值。该值表示为 CPU 核心使用量的总和。例如，默认值 80 代表单个 CPU 核心 80% 的使用量。在多核处理器系统上，值 150 代表一个 CPU 核心 100% 的使用量加上第二个 CPU 核心 50% 的使用量。

有关相关信息，请参见第 10.5.4 节“优化 InnoDB 重做日志记录”。

innodb_log_spin_cpu_pct_hwm

定义用户线程在等待刷新重做时不再旋转的 CPU 使用量的最大值。该值表示为所有 CPU 核心总处理能力的百分比。默认值为 50%。例如，两个 CPU 核心 100% 的使用量代表具有四个 CPU 核心的服务器上 50% 的总 CPU 处理能力。

innodb_log_spin_cpu_pct_hwm变量尊重处理器亲和性。例如，如果服务器有 48 个核心，但mysqld进程仅绑定到四个 CPU 核心，则会忽略其他 44 个 CPU 核心。

有关相关信息，请参见第 10.5.4 节“优化 InnoDB 重做日志记录”。

innodb_log_wait_for_flush_spin_hwm

定义用户线程在等待刷新重做时不再旋转的平均日志刷新时间的最大值。默认值为 400 微秒。

有关相关信息，请参见第 10.5.4 节“优化 InnoDB 重做日志记录”。

innodb_log_write_ahead_size

定义重做日志的预写块大小（以字节为单位）。为避免“写时读”，将innodb_log_write_ahead_size设置为与操作系统或文件系统缓存块大小匹配。默认设置为 8192 字节。当重做日志的预写块大小与操作系统或文件系统缓存块大小不匹配时，由于重做日志块未完全缓存到操作系统或文件系统，就会发生写时读。

innodb_log_write_ahead_size的有效值为InnoDB日志文件块大小的倍数 (2ⁿ)。最小值为InnoDB日志文件块大小 (512)。指定最小值时不会发生预写。最大值等于innodb_page_size值。如果您指定的值大于innodb_page_size值，则innodb_log_write_ahead_size设置将被截断为innodb_page_size值。

将innodb_log_write_ahead_size值设置得太低（相对于操作系统或文件系统缓存块大小而言），会导致“写时读”。将该值设置得太高可能会对日志文件写入的fsync性能产生轻微影响，因为一次写入多个块。

有关相关信息，请参见第 10.5.4 节“优化 InnoDB 重做日志记录”。

innodb_log_writer_threads

为将重做日志记录从日志缓冲区写入系统缓冲区以及将系统缓冲区刷新到重做日志文件启用专用日志写入线程。专用日志写入线程可以提高高并发系统的性能，但对于低并发系统，禁用专用日志写入线程可以提供更好的性能。

有关更多信息，请参见第 10.5.4 节，“优化 InnoDB 重做日志记录”。

innodb_lru_scan_depth

影响 InnoDB 缓冲池 的 刷新 操作的算法和启发式方法的参数。主要针对性能专家调优 I/O 密集型工作负载。它为每个缓冲池实例指定页面清理线程扫描缓冲池 LRU 页面列表寻找要刷新的 脏页面 的深度。这是一个每秒执行一次的后台操作。

对于大多数工作负载，小于默认值的设置通常就足够了。比必要值高得多的值可能会影响性能。只有在典型工作负载下有空闲 I/O 容量的情况下，才考虑增加该值。相反，如果写密集型工作负载使 I/O 容量饱和，请降低该值，尤其是在缓冲池很大的情况下。

在调优 innodb_lru_scan_depth 时，从较低的值开始，并向上配置该设置，目标是很少看到零个空闲页面。此外，在更改缓冲池实例数时，请考虑调整 innodb_lru_scan_depth，因为 innodb_lru_scan_depth * innodb_buffer_pool_instances 定义了页面清理线程每秒执行的工作量。

有关相关信息，请参见第 17.8.3.5 节，“配置缓冲池刷新”。有关一般 I/O 调优建议，请参见第 10.5.8 节，“优化 InnoDB 磁盘 I/O”。

innodb_max_dirty_pages_pct

InnoDB 尝试从 缓冲池 刷新 数据，以使 脏页面 的百分比不超过此值。

innodb_max_dirty_pages_pct 设置为刷新活动建立了一个目标。它不影响刷新的速度。有关管理刷新速度的信息，请参见第 17.8.3.5 节，“配置缓冲池刷新”。