文档首页
MySQL 9.0 参考手册
相关文档 下载本手册
PDF (US Ltr) - 40.0Mb
PDF (A4) - 40.1Mb
手册页 (TGZ) - 258.2Kb
手册页 (Zip) - 365.3Kb
信息 (Gzip) - 4.0Mb
信息 (Zip) - 4.0Mb


MySQL 9.0 参考手册  /  ...  /  结构化系统变量

7.1.9.5 结构化系统变量

结构化变量在以下两个方面不同于常规系统变量:

  • 其值是一个结构,其中的组件指定了被认为密切相关的服务器参数。

  • 给定类型的结构化变量可能有多个实例。每个实例都有不同的名称,并引用服务器维护的不同资源。

MySQL 支持一种结构化变量类型,它指定了控制键缓存操作的参数。键缓存结构化变量具有以下组件:

本节介绍了引用结构化变量的语法。键缓存变量用于语法示例,但有关键缓存如何操作的具体细节可在其他地方找到,请参阅 第 10.10.2 节“MyISAM 键缓存”

要引用结构化变量实例的组件,可以使用 实例名称.组件名称 格式的复合名称。例如:

hot_cache.key_buffer_size
hot_cache.key_cache_block_size
cold_cache.key_cache_block_size

对于每个结构化系统变量,始终预定义了一个名为 default 的实例。如果引用结构化变量的组件时没有指定实例名称,则使用 default 实例。因此,default.key_buffer_sizekey_buffer_size 都引用同一个系统变量。

结构化变量实例和组件遵循以下命名规则:

  • 对于给定类型的结构化变量,每个实例的名称在该类型的变量中必须是唯一的。但是,实例名称在不同类型的结构化变量之间不需要是唯一的。例如,每个结构化变量都有一个名为 default 的实例,因此 default 在不同变量类型之间不是唯一的。

  • 每个结构化变量类型的组件名称在所有系统变量名称中必须是唯一的。如果不是这样(即,如果两种不同类型的结构化变量可以共享组件成员名称),则不清楚在引用没有限定实例名称的成员名称时应使用哪个默认结构化变量。

  • 如果结构化变量实例名称作为未加引号的标识符是非法的,请使用反引号将其引用为加引号的标识符。例如,hot-cache 是非法的,但 `hot-cache` 是合法的。

  • globalsessionlocal 不是合法的实例名称。这避免了与诸如 @@GLOBAL.var_name 之类的用于引用非结构化系统变量的符号冲突。

目前,前两个规则不可能被违反,因为唯一的结构化变量类型是键缓存的变量类型。如果将来创建了其他类型的结构化变量,则这些规则可能会变得更加重要。

除了一种情况外,您可以在任何可以使用简单变量名称的上下文中使用复合名称来引用结构化变量组件。例如,可以使用命令行选项为结构化变量赋值:

$> mysqld --hot_cache.key_buffer_size=64K

在选项文件中,使用以下语法:

[mysqld]
hot_cache.key_buffer_size=64K

如果使用此选项启动服务器,除了默认大小为 8MB 的默认键缓存之外,它还会创建一个名为 hot_cache 的键缓存,其大小为 64KB。

假设您按如下方式启动服务器:

$> mysqld --key_buffer_size=256K \
         --extra_cache.key_buffer_size=128K \
         --extra_cache.key_cache_block_size=2048

在这种情况下,服务器会将默认键缓存的大小设置为 256KB。(您也可以编写 --default.key_buffer_size=256K。)此外,服务器还会创建第二个名为 extra_cache 的键缓存,其大小为 128KB,用于缓存表索引块的块缓冲区大小设置为 2048 字节。

以下示例使用三种不同大小的键缓存启动服务器,其大小比例为 3:1:1:

$> mysqld --key_buffer_size=6M \
         --hot_cache.key_buffer_size=2M \
         --cold_cache.key_buffer_size=2M

结构化变量值也可以在运行时设置和检索。例如,要将名为 hot_cache 的键缓存设置为 10MB,请使用以下任一语句:

mysql> SET GLOBAL hot_cache.key_buffer_size = 10*1024*1024;
mysql> SET @@GLOBAL.hot_cache.key_buffer_size = 10*1024*1024;

要检索缓存大小,请执行以下操作:

mysql> SELECT @@GLOBAL.hot_cache.key_buffer_size;

但是,以下语句不起作用。该变量不会被解释为复合名称,而是被解释为 LIKE 模式匹配操作的简单字符串:

mysql> SHOW GLOBAL VARIABLES LIKE 'hot_cache.key_buffer_size';

这是在任何可以使用简单变量名称的地方使用结构化变量名称的例外情况。