MySQL :: MySQL 8.3 Reference Manual :: 17.8.11 Configuring the Merge Threshold for Index Pages

version 8.3

8.0 current
5.7

8.0 Japanese

MySQL 8.3 Reference Manual / ... / Configuring the Merge Threshold for Index Pages

17.8.11 为索引页面配置合并阈值

您可以配置索引页面的 MERGE_THRESHOLD 值。如果索引页面的“页面满”百分比低于 MERGE_THRESHOLD 值时删除或缩短行时，InnoDB 将尝试将索引页面与相邻索引页面合并。默认 MERGE_THRESHOLD 值为 50，这是之前硬编码的值。最小 MERGE_THRESHOLD 值为 1，最大值为 50。

当索引页面的“页面满”百分比低于 50%，即默认 MERGE_THRESHOLD 设置时，InnoDB 将尝试将索引页面与相邻页面合并。如果两个页面接近 50% 满，页面拆分可能很快发生。如果这种合并拆分行为频繁发生，将对性能产生不良影响。为了避免频繁的合并拆分，您可以降低 MERGE_THRESHOLD 值，以便 InnoDB 在较低的“页面满”百分比下尝试页面合并。合并页面在较低的页面满百分比下留出更多空间，帮助减少合并拆分行为。

索引页面的 MERGE_THRESHOLD 可以为表或单个索引定义。如果未定义，MERGE_THRESHOLD 值默认为 50。

为表设置 MERGE_THRESHOLD

您可以使用 table_option COMMENT 子句的 CREATE TABLE 语句来设置表的 MERGE_THRESHOLD 值。例如：

CREATE TABLE t1 (
   id INT,
  KEY id_index (id)
) COMMENT='MERGE_THRESHOLD=45';

您也可以使用 table_option COMMENT 子句和 ALTER TABLE 来设置现有表的 MERGE_THRESHOLD 值：

CREATE TABLE t1 (
   id INT,
  KEY id_index (id)
);

ALTER TABLE t1 COMMENT='MERGE_THRESHOLD=40';

为单个索引设置 MERGE_THRESHOLD

要设置单个索引的 MERGE_THRESHOLD 值，您可以使用 index_option COMMENT 子句与 CREATE TABLE、ALTER TABLE 或 CREATE INDEX，如下所示：

使用 CREATE TABLE 设置单个索引的 MERGE_THRESHOLD 值：

CREATE TABLE t1 (
   id INT,
  KEY id_index (id) COMMENT 'MERGE_THRESHOLD=40'
);

使用 ALTER TABLE 设置单个索引的 MERGE_THRESHOLD 值：

CREATE TABLE t1 (
   id INT,
  KEY id_index (id)
);

ALTER TABLE t1 DROP KEY id_index;
ALTER TABLE t1 ADD KEY id_index (id) COMMENT 'MERGE_THRESHOLD=40';

使用 CREATE INDEX 设置单个索引的 MERGE_THRESHOLD 值：

CREATE TABLE t1 (id INT);
CREATE INDEX id_index ON t1 (id) COMMENT 'MERGE_THRESHOLD=40';

Note

您不能修改 GEN_CLUST_INDEX 的 MERGE_THRESHOLD 值，该索引是 InnoDB 在创建表时没有主键或唯一键索引时创建的聚簇索引。您只能通过设置表的 MERGE_THRESHOLD 值来修改 GEN_CLUST_INDEX 的 MERGE_THRESHOLD 值。

查询索引的 MERGE_THRESHOLD 值

可以通过查询 INNODB_INDEXES 表来获取索引的当前 MERGE_THRESHOLD 值。例如：

mysql> SELECT * FROM INFORMATION_SCHEMA.INNODB_INDEXES WHERE NAME='id_index' \G
*************************** 1. row ***************************
       INDEX_ID: 91
           NAME: id_index
       TABLE_ID: 68
           TYPE: 0
       N_FIELDS: 1
        PAGE_NO: 4
          SPACE: 57
MERGE_THRESHOLD: 40

您可以使用 SHOW CREATE TABLE 查看表的 MERGE_THRESHOLD 值，如果使用 table_option COMMENT 子句显式定义：

mysql> SHOW CREATE TABLE t2 \G
*************************** 1. row ***************************
       Table: t2
Create Table: CREATE TABLE `t2` (
  `id` int(11) DEFAULT NULL,
  KEY `id_index` (`id`) COMMENT 'MERGE_THRESHOLD=40'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci

Note

在索引级别定义的 MERGE_THRESHOLD 值优先于表级别定义的 MERGE_THRESHOLD 值。如果未定义，默认 MERGE_THRESHOLD 为 50% (MERGE_THRESHOLD=50，这是之前硬编码的值。

同样，您可以使用 SHOW INDEX 查看索引的 MERGE_THRESHOLD 值，如果使用 index_option COMMENT 子句显式定义：

mysql> SHOW INDEX FROM t2 \G
*************************** 1. row ***************************
        Table: t2
   Non_unique: 1
     Key_name: id_index
 Seq_in_index: 1
  Column_name: id
    Collation: A
  Cardinality: 0
     Sub_part: NULL
       Packed: NULL
         Null: YES
   Index_type: BTREE
      Comment:
Index_comment: MERGE_THRESHOLD=40

MERGE_THRESHOLD 设置的效果测量

INNODB_METRICS 表提供了两个计数器，可以用来测量 MERGE_THRESHOLD 设置对索引页合并的影响。

mysql> SELECT NAME, COMMENT FROM INFORMATION_SCHEMA.INNODB_METRICS
       WHERE NAME like '%index_page_merge%';
+-----------------------------+----------------------------------------+
| NAME                        | COMMENT                                |
+-----------------------------+----------------------------------------+
| index_page_merge_attempts   | Number of index page merge attempts    |
| index_page_merge_successful | Number of successful index page merges |
+-----------------------------+----------------------------------------+

降低 MERGE_THRESHOLD 值的目标是：

较少的页合并尝试次数和成功的页合并次数
相似的页合并尝试次数和成功的页合并次数

如果 MERGE_THRESHOLD 设置太小，可能会导致大型数据文件，因为页空闲空间太多。

有关使用 INNODB_METRICS 计数器的信息，请参阅第 17.15.6 节，“InnoDB INFORMATION_SCHEMA Metrics 表”。

PREV HOME UP NEXT