可以通过在服务器启动时命名系统变量来启用它们（如果它们的值为 true 或 false），或者使用 --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 的值。innodb_buffer_pool_chunk_size 可以以 1MB（1048576 字节）为单位增加或减少。

更改 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 最小缓冲池大小限制。innodb_buffer_pool_debug 选项仅在使用 WITH_DEBUG CMake 选项编译调试支持时可用。

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 以以下格式保存：空间, 页面 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 变量，并且要禁用此选项，操作系统必须支持 madvise() 的 MADV_DONTDUMP 非 POSIX 扩展，Linux 3.4 及更高版本支持该扩展。有关更多信息，请参阅 第 17.8.3.7 节“从核心文件中排除或包含缓冲池页面”。

默认情况下，在支持 MADV_DONTDUMP 的系统（通常是 Linux，而不是 macOS 或 Windows）上，此选项是禁用的。

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

innodb_buffer_pool_instances

InnoDB 缓冲池 被划分的区域数量。对于缓冲池位于数 GB 范围内的系统，将缓冲池划分为单独的实例可以提高并发性，方法是减少不同线程读取和写入缓存页面时的争用。存储在缓冲池中或从缓冲池中读取的每个页面都会使用哈希函数随机分配给其中一个缓冲池实例。每个缓冲池都管理自己的空闲列表、刷新列表、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 字节（128MB）。最大值取决于 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]]

文件大小以千字节、兆字节或千兆字节为单位指定，方法是在大小值后附加 K、M 或 G。如果以千字节为单位指定数据文件大小，请以 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 会弄脏指定的页面。仅当使用 WITH_DEBUG CMake 选项编译调试支持时，innodb_fil_make_page_dirty_debug 选项才可用。

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，则默认值为 O_DIRECT，否则默认为 fsync。在 Windows 上，默认值为 unbuffered。

类 Unix 系统的 innodb_flush_method 选项包括

在支持 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 变量会导致在 检查点 发生的 I/O 活动突发期间忽略 innodb_io_capacity 和 innodb_io_capacity_max 设置。要遵循 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 设置为包含停用词列表的表的名称，格式为 数据库名称/表名称。

在配置 innodb_ft_server_stopword_table 之前，停用词表必须存在。innodb_ft_enable_stopword 必须启用，并且必须在创建 FULLTEXT 索引之前配置 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 设置为包含停用词列表的表的名称，格式为 数据库名称/表名称。

在配置 innodb_ft_user_stopword_table 之前，停用词表必须存在。innodb_ft_enable_stopword 必须启用，并且必须在创建 FULLTEXT 索引之前配置 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 可以更积极地刷新，其每秒 I/O 操作数 (IOPS) 比 innodb_io_capacity 变量定义的速率更高。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 节“死锁检测”。

可以使用 SET GLOBAL 或 SET SESSION 语句在运行时设置 innodb_lock_wait_timeout。更改 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 部分中的 日志序列号 (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 核心的服务器上，两个 CPU 核心的 100% 使用率是组合 CPU 处理能力的 50%。

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_log_write_ahead_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