文档首页
MySQL 8.4 参考手册
相关文档 下载本手册
PDF (US Ltr) - 39.9Mb
PDF (A4) - 40.0Mb
手册页 (TGZ) - 258.5Kb
手册页 (Zip) - 365.5Kb
信息 (Gzip) - 4.0Mb
信息 (Zip) - 4.0Mb


MySQL 8.4 参考手册  /  ...  /  CACHE INDEX 语句

15.7.8.2 CACHE INDEX 语句

CACHE INDEX {
      tbl_index_list [, tbl_index_list] ...
    | tbl_name PARTITION (partition_list)
  }
  IN key_cache_name

tbl_index_list:
  tbl_name [{INDEX|KEY} (index_name[, index_name] ...)]

partition_list: {
    partition_name[, partition_name] ...
  | ALL
}

CACHE INDEX 语句将表索引分配给特定的键缓存。它仅适用于 MyISAM 表,包括分区的 MyISAM 表。分配索引后,如果需要,可以使用 LOAD INDEX INTO CACHE 将其预加载到缓存中。

以下语句将表 t1t2t3 中的索引分配给名为 hot_cache 的键缓存

mysql> CACHE INDEX t1, t2, t3 IN hot_cache;
+---------+--------------------+----------+----------+
| Table   | Op                 | Msg_type | Msg_text |
+---------+--------------------+----------+----------+
| test.t1 | assign_to_keycache | status   | OK       |
| test.t2 | assign_to_keycache | status   | OK       |
| test.t3 | assign_to_keycache | status   | OK       |
+---------+--------------------+----------+----------+

CACHE INDEX 的语法允许您指定只应将表中的特定索引分配给缓存。但是,该实现会将表的所有索引都分配给缓存,因此除了表名之外,没有理由指定其他任何内容。

CACHE INDEX 语句中引用的键缓存可以通过使用参数设置语句或在服务器参数设置中设置其大小来创建。例如

SET GLOBAL keycache1.key_buffer_size=128*1024;

键缓存参数作为结构化系统变量的成员进行访问。请参阅第 7.1.9.5 节,“结构化系统变量”

在将索引分配给键缓存之前,该键缓存必须存在,否则会发生错误

mysql> CACHE INDEX t1 IN non_existent_cache;
ERROR 1284 (HY000): Unknown key cache 'non_existent_cache'

默认情况下,表索引被分配给服务器启动时创建的主(默认)键缓存。当键缓存被销毁时,分配给它的所有索引都将重新分配给默认键缓存。

索引分配会影响整个服务器:如果一个客户端将索引分配给一个给定的缓存,则该缓存将用于所有涉及该索引的查询,而无论哪个客户端发出查询。

分区 MyISAM 表支持 CACHE INDEX。您可以将一个或多个索引分配给一个、多个或所有分区到给定的键缓存。例如,您可以执行以下操作:

CREATE TABLE pt (c1 INT, c2 VARCHAR(50), INDEX i(c1))
    ENGINE=MyISAM
    PARTITION BY HASH(c1)
    PARTITIONS 4;

SET GLOBAL kc_fast.key_buffer_size = 128 * 1024;
SET GLOBAL kc_slow.key_buffer_size = 128 * 1024;

CACHE INDEX pt PARTITION (p0) IN kc_fast;
CACHE INDEX pt PARTITION (p1, p3) IN kc_slow;

前面的一组语句执行以下操作:

  • 创建一个包含 4 个分区的分区表;这些分区自动命名为 p0,...,p3;此表在列 c1 上有一个名为 i 的索引。

  • 创建 2 个名为 kc_fastkc_slow 的键缓存

  • 将分区 p0 的索引分配给 kc_fast 键缓存,并将分区 p1p3 的索引分配给 kc_slow 键缓存;剩余分区 (p2) 的索引使用服务器的默认键缓存。

如果您希望将表 pt 中所有分区的索引分配给名为 kc_all 的单个键缓存,则可以使用以下两个语句中的任何一个:

CACHE INDEX pt PARTITION (ALL) IN kc_all;

CACHE INDEX pt IN kc_all;

刚刚显示的两个语句是等效的,并且发出任何一个语句都具有完全相同的效果。换句话说,如果您希望将分区表的 所有分区 的索引分配给同一个键缓存,则 PARTITION (ALL) 子句是可选的。

将多个分区的索引分配给一个键缓存时,这些分区不必是连续的,并且您无需按任何特定顺序列出它们的名称。未显式分配给键缓存的任何分区的索引将自动使用服务器默认键缓存。

分区 MyISAM 表也支持索引预加载。有关更多信息,请参阅 第 15.7.8.5 节“LOAD INDEX INTO CACHE 语句”