Файлы, созданные Mariabackup

Mariabackup создает следующие файлы:

backup-my.cnf

Во время резервного копирования любые параметры сервера, относящиеся к Mariabackup, записываются в backup-my.cnf файл параметров, чтобы их можно было повторно прочитать позже на стадии --prepare.

ib_logfile0

В MariaDB 10.2.10 и более поздних версиях Mariabackup создаёт пустой журнал переопределения InnoDB с именем ib_logfile0 в рамках стадии --prepare. У этого файла 3 роли:

1. На сервере-источнике ib_logfile0 является первым (и, возможно, единственным) журналом переопределения InnoDB.
2. В резервной копии без подготовки ib_logfile0 содержит все журналы переопределения InnoDB, скопированные во время резервного копирования. Предыдущие версии Mariabackup использовали для этого файл с именем xtrabackup_logfile.
3. На стадии --prepare ib_logfile0 ранее удалялся. Теперь во время стадии --prepare ib_logfile0 инициализируется как пустой журнал переопределения InnoDB. Таким образом, если резервную копию восстанавливают вручную, любые предварительно существовавшие журналы переопределения InnoDB будут перезаписаны пустым. Это помогает предотвратить определённые известные проблемы. Например, см. Обзор Mariabackup: Ручное восстановление с предварительно существующими файлами журнала переопределения InnoDB.

xtrabackup_logfile

В MariaDB 10.2.9 и ранее Mariabackup создаёт xtrabackup_logfile для хранения журнала переопределения InnoDB, В более поздних версиях создаётся ib_logfile0.

xtrabackup_binlog_info

Этот файл хранит имя и позицию файла журнала двоичных событий, соответствующие резервной копии.

Этот файл также хранит значение системной переменной gtid_current_pos, соответствующей резервной копии.

Например:

mariadb-bin.000096 568 0-1-2

Значения в этом файле гарантированно будут соответствовать резервной копии только в том случае, если параметр --no-lock не был указан при создании резервной копии.

xtrabackup_binlog_pos_innodb

Mariabackup унаследовал этот файл от Percona XtraBackup 2.3. Однако этот файл можно использовать только с версиями Percona Server, имеющими специальную функцию журнала двоичных событий без блокировок.

Эта функция описана в документации Percona Server:

А способ его использования Percona XtraBackup 2.3 описан в документации Percona XtraBackup 2.3:

Mariabackup больше не создаёт этот файл начиная с MariaDB 10.1.39, MariaDB 10.2.23, MariaDB 10.3.14 и MariaDB 10.4.4.

См. MDEV-18917 для получения дополнительной информации.

xtrabackup_checkpoints

Файл xtrabackup_checkpoints содержит метаданные о резервной копии.

Например:

backup_type = full-backuped
from_lsn = 0
to_lsn = 1635102
last_lsn = 1635102
recover_binlog_info = 0

Описание полей приведено ниже.

Если используется параметр --extra-lsndir, то дополнительная копия этого файла будет сохранена в указанном каталоге.

backup_type

Если резервная копия — это полная резервная копия без подготовки полного резервного копирования или частичная резервная копия без подготовки частичного резервного копирования, то backup_type устанавливается в значение full-backuped.

Если резервная копия — это инкрементальная резервная копия без подготовки инкрементального резервного копирования, то backup_type устанавливается в значение incremental.

Если резервная копия уже подготовлена, то backup_type устанавливается в значение log-applied.

from_lsn

Если backup_type равно full-backuped, то from_lsn имеет значение 0.

Если backup_type равно incremental, то from_lsn имеет значение номера последовательности записи (LSN) момента начала чтения из журнала переопределения InnoDB. Это используется Mariabackup при подготовке инкрементальных резервных копий.

Это значение можно установить вручную во время инкрементального резервного копирования с помощью параметра --incremental-lsn. Однако, обычно лучше позволить Mariabackup определить from_lsn автоматически, указав родительскую резервную копию с помощью параметра --incremental-basedir.

to_lsn

to_lsn имеет значение номера последовательности записи (LSN) последнего контрольного пункта в журнале переопределения InnoDB. Это используется Mariabackup при подготовке инкрементальных резервных копий.

last_lsn

last_lsn имеет значение последнего номера последовательности записи (LSN), прочитанного из журнала переопределения InnoDB. Это используется Mariabackup при подготовке инкрементальных резервных копий.

xtrabackup_info

Файл xtrabackup_info содержит информацию о резервной копии. Поля этого файла перечислены ниже.

Если используется параметр --extra-lsndir, то дополнительная копия этого файла будет сохранена в указанном каталоге.

uuid

Если UUID был предоставлен параметром --incremental-history-uuid, он будет сохранён здесь. В противном случае это будет пустая строка.

name

Если имя было предоставлено параметрами --history или ---incremental-history-name, оно будет сохранено здесь. В противном случае это будет пустая строка.

tool_name

Имя исполняемого файла Mariabackup, выполнившего резервную копию. Обычно mariabackup.

tool_command

Аргументы, переданные Mariabackup при выполнении резервного копирования.

tool_version

Версия Mariabackup, выполнившая резервную копию.

ibbackup_version

Версия Mariabackup, выполнившая резервную копию.

server_version

Версия MariaDB Server, которая была скопирована.

start_time

Время начала резервного копирования.

end_time

Время завершения резервного копирования.

lock_time

Время, в течение которого Mariabackup удерживала блокировки.

binlog_pos

Это поле хранит имя и позицию файла журнала двоичных событий, соответствующие резервной копии.

Это поле также хранит значение системной переменной gtid_current_pos, соответствующей резервной копии.

Значения в этом поле гарантированно будут соответствовать резервной копии только в том случае, если параметр --no-lock не был указан при создании резервной копии.

innodb_from_lsn

Это идентично from_lsn в xtrabackup_checkpoints.

Если резервная копия — это полная резервная копия, то innodb_from_lsn имеет значение 0.

Если резервная копия — это инкрементальная резервная копия, то innodb_from_lsn имеет значение номера последовательности записи (LSN) момента начала чтения из журнала переопределения InnoDB.

innodb_to_lsn

Это идентично to_lsn в xtrabackup_checkpoints.

innodb_to_lsn имеет значение номера последовательности записи (LSN) последнего контрольного пункта в журнале переопределения InnoDB.

partial

Если резервная копия — это частичная резервная копия, то это значение будет Y.

В противном случае это значение будет N.

incremental

Если резервная копия является инкрементной резервной копией, то это значение будет Y.

В противном случае, это значение будет N.

format

Значение этого поля — формат резервной копии.

Если параметр --stream был установлен в xbstream, то это значение будет xbstream.

Если параметр --stream не был задан, то это значение будет file.

compressed

Если был задан параметр --compress, то это значение будет compressed.

В противном случае, это значение будет N.

xtrabackup_slave_info

Если задан параметр --slave-info, то этот файл содержит команду CHANGE MASTER, которую можно использовать для настройки нового сервера как подчиненного сервера (slave) для исходного сервера-мастера (master) после восстановления резервной копии.

Mariabackup не проверяет, используются ли GTID в репликации. Она использует сокращение и предполагает, что если переменная системы gtid_slave_pos не пуста, то она запишет команду CHANGE MASTER с параметром MASTER_USE_GTID установленным в slave_pos. В противном случае, она запишет команду CHANGE MASTER с параметрами MASTER_LOG_FILE и MASTER_LOG_POS, используя файл бинарного журнала бинарного журнала и позицию мастера. Подробнее см. MDEV-19264.

xtrabackup_galera_info

Если задан параметр --galera-info, то этот файл содержит информацию о состоянии узла кластера Galera.

Файл содержит значения переменных состояния wsrep_local_state_uuid и wsrep_last_committed.

Значения записываются в следующем формате:

wsrep_local_state_uuid:wsrep_last_committed

Например:

d38587ce-246c-11e5-bcce-6bbd0831cc0f:1352215

<table>.delta

Если резервная копия является инкрементной резервной копией, то этот файл содержит изменённые страницы таблицы.

<table>.delta.meta

Если резервная копия является инкрементной резервной копией, то этот файл содержит метаданные о файлах <table>.delta. Поля в этом файле перечислены ниже.

page_size

Это поле содержит либо значение innodb_page_size, либо значение опции таблицы KEY_BLOCK_SIZE, если опция таблицы ROW_FORMAT для таблицы установлена в COMPRESSED.

zip_size

Если опция таблицы ROW_FORMAT для этой таблицы установлена в COMPRESSED, то это поле содержит значение сжатого размера страницы.

space_id

Это поле содержит значение space_id таблицы.