MySQL :: MySQL 9.0 参考手册 :: 15.1.6 ALTER LOGFILE GROUP 语句

版本 9.0

8.4 当前
8.0
5.7

8.0 日语

MySQL 9.0 参考手册 / ... / ALTER LOGFILE GROUP 语句

15.1.6 ALTER LOGFILE GROUP 语句

ALTER LOGFILE GROUP logfile_group
    ADD UNDOFILE 'file_name'
    [INITIAL_SIZE [=] size]
    [WAIT]
    ENGINE [=] engine_name

此语句将名为 'file_name' 的 UNDO 文件添加到现有的日志文件组 logfile_group 中。一个 ALTER LOGFILE GROUP 语句只有一个 ADD UNDOFILE 子句。目前不支持任何 DROP UNDOFILE 子句。

注意

所有 NDB 集群磁盘数据对象共享相同的命名空间。这意味着 每个磁盘数据对象 必须具有唯一的名称（而不仅仅是给定类型的每个磁盘数据对象）。例如，您不能拥有具有相同名称的表空间和撤消日志文件，也不能拥有具有相同名称的撤消日志文件和数据文件。

可选的 INITIAL_SIZE 参数设置 UNDO 文件的初始大小（以字节为单位）；如果未指定，初始大小默认为 134217728（128 MB）。您可以选择在 size 后面加上一个表示数量级的字母缩写，类似于在 my.cnf 中使用的那些缩写。通常，这个字母是 M（兆字节）或 G（千兆字节）。（错误 #13116514、错误 #16104705、错误 #62858）

在 32 位系统上，INITIAL_SIZE 支持的最大值为 4294967296（4 GB）。（错误 #29186）

INITIAL_SIZE 的最小允许值为 1048576（1 MB）。（错误 #29574）

注意

WAIT 被解析但会被忽略。此关键字目前无效，用于未来扩展。

ENGINE 子句（必需）确定此日志文件组使用的存储引擎，其中 engine_name 是存储引擎的名称。当前，engine_name 唯一接受的值是 “NDBCLUSTER” 和 “NDB”。这两个值等效。

以下是一个示例，假设日志文件组 lg_3 已经使用 CREATE LOGFILE GROUP 创建（参见第 15.1.16 节，“CREATE LOGFILE GROUP 语句”）

ALTER LOGFILE GROUP lg_3
    ADD UNDOFILE 'undo_10.dat'
    INITIAL_SIZE=32M
    ENGINE=NDBCLUSTER;

当 ALTER LOGFILE GROUP 与 ENGINE = NDBCLUSTER（或者，ENGINE = NDB）一起使用时，将在每个 NDB Cluster 数据节点上创建一个撤消日志文件。可以通过查询 Information Schema FILES 表来验证撤消文件是否已创建并获取有关它们的信息。例如

mysql> SELECT FILE_NAME, LOGFILE_GROUP_NUMBER, EXTRA
    -> FROM INFORMATION_SCHEMA.FILES
    -> WHERE LOGFILE_GROUP_NAME = 'lg_3';
+-------------+----------------------+----------------+
| FILE_NAME   | LOGFILE_GROUP_NUMBER | EXTRA          |
+-------------+----------------------+----------------+
| newdata.dat |                    0 | CLUSTER_NODE=3 |
| newdata.dat |                    0 | CLUSTER_NODE=4 |
| undo_10.dat |                   11 | CLUSTER_NODE=3 |
| undo_10.dat |                   11 | CLUSTER_NODE=4 |
+-------------+----------------------+----------------+
4 rows in set (0.01 sec)

（参见第 28.3.15 节，“INFORMATION_SCHEMA FILES 表”。）

用于 UNDO_BUFFER_SIZE 的内存来自全局池，其大小由 SharedGlobalMemory 数据节点配置参数的值决定。这包括由 InitialLogFileGroup 数据节点配置参数设置隐含的任何默认值。

ALTER LOGFILE GROUP 仅对 NDB Cluster 的磁盘数据存储有用。有关更多信息，请参见第 25.6.11 节，“NDB Cluster 磁盘数据表”。

上一个开始向上下一个