15.1.6 ALTER LOGFILE GROUP Statement — MySQL 8.4

15.1.6 Заявление ALTER LOGFILE GROUP

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

Это утверждение добавляет файл UNDO с именем 'file_name' в существующую группу файлов журнала logfile_group. Утверждение ALTER LOGFILE GROUP имеет один и только один ADD UNDOFILE-оператор. Сейчас не поддерживаются DROP UNDOFILE-операторы.

Примечание

Все объекты данных дисков NDB Cluster используют одно и то же пространство имён. Это означает, что каждый объект данных диска должен иметь уникальное имя (а не только каждый объект данных данного типа). Например, вы не можете иметь табличное пространство и файл журнала отката с одинаковым именем, или файл журнала отката и файл данных с одинаковым именем.

Необязательный параметр INITIAL_SIZE устанавливает начальный размер файла UNDO в байтах; если он не указан, начальный размер по умолчанию составляет 134217728 (128 МБ). Вы можете дополнительно указать после size буквенный код порядка величины, аналогичный тем, что используются в my.cnf. Обычно это одна из букв M (мегабайты) или G (гигабайты). (Ошибка #13116514, Ошибка #16104705, Ошибка #62858)

В 32-битных системах максимальное поддерживаемое значение для INITIAL_SIZE составляет 4294967296 (4 ГБ). (Ошибка #29186)

Минимальное допустимое значение для INITIAL_SIZE составляет 1048576 (1 МБ). (Ошибка #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 создаётся файл журнала отката. Вы можете проверить, что файлы отката были созданы, и получить информацию о них, запросив таблицу схемы информации 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».