文档主页
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 参考手册  /  ...  /  结构化系统变量

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

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

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

$> 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';

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