Параметры Mariabackup

В Mariabackup доступно множество параметров.

Список параметров

--apply-log

Подготавливает существующий бэкап для восстановления на сервере MariaDB. Действителен только в режиме innobackupex, который можно включить с помощью параметра --innobackupex.

Файлы, которые Mariabackup генерирует во время операций --backup в целевом каталоге, не готовы к использованию на сервере. Перед восстановлением данных в MariaDB необходимо сначала подготовить бэкап.

В случае полных бэкапов файлы не соответствуют моменту времени, так как они были созданы в разные моменты. Если вы попытаетесь восстановить базу данных без предварительной подготовки, InnoDB отклонит новые данные как повреждённые. Запуск Mariabackup с командой --prepare подготавливает данные для восстановления на сервере MariaDB. При работе с инкрементными бэкапами необходимо использовать команду --prepare и параметр --incremental-dir для обновления базового бэкапа с помощью изменений из инкрементного бэкапа.

$ mariabackup --innobackupex --apply-log

После подготовки бэкапа, вы можете использовать команды --copy-back или --move-back для восстановления бэкапа на сервере.

--apply-log-only

Если этот параметр используется при подготовке бэкапа, выполняется только стадия применения журнала redo, а другие стадии восстановления после сбоя игнорируются. Этот параметр используется с инкрементными бэкапами.

Этот параметр поддерживается только в MariaDB 10.1. В MariaDB 10.2 и более поздних версиях этот параметр не нужен и не поддерживается.

--backup

Создаёт резервные копии ваших баз данных.

Используя этот параметр, Mariabackup выполняет резервное копирование вашей базы данных или баз данных. Резервные копии записываются в целевой каталог, заданный параметром --target-dir.

$ mariabackup --backup 
      --target-dir /path/to/backup \
      --user user_name --password user_passwd

Mariabackup может выполнять полные и инкрементные бэкапы. Полный бэкап создаёт моментальный снимок базы данных в целевом каталоге. Инкрементный бэкап сравнивает базу данных с ранее созданным полным бэкапом (определяется параметром --incremental-basedir) и создаёт файлы с изменениями.

Для восстановления из бэкапа необходимо сначала запустить Mariabackup с параметром --prepare, чтобы сделать полную резервную копию с согласованностью по времени или применить изменения из инкрементного бэкапа к основе. Затем вы можете запустить Mariabackup ещё раз с командами --copy-back или --move-back для восстановления базы данных.

Для получения дополнительной информации см. Полное резервное копирование и восстановление и Инкрементное резервное копирование и восстановление.

--binlog-info

Определяет, как Mariabackup получает координаты бинарного журнала с сервера.

--binlog-info[=OFF | ON | LOCKLESS | AUTO]

Параметр --binlog-info поддерживает следующие методы извлечения. Если метод извлечения не указан, используется метод AUTO.

Используя этот параметр, вы можете контролировать, как Mariabackup получает координаты бинарного журнала сервера, соответствующие резервной копии.

При включении, независимо от использования ON или AUTO, Mariabackup извлекает информацию из binlog во время процесса резервного копирования. При отключении с помощью OFF, Mariabackup работает без попытки извлечения информации о бинарном журнале. Это может быть полезно, когда необходимо скопировать данные без метаданных, таких как binlog или координаты репликации.

$ mariabackup --binlog-info --backup

В настоящее время параметр LOCKLESS зависит от функций, не поддерживаемых сервером MariaDB. Дополнительная информация содержится в описании файла xtrabackup_binlog_pos_innodb. Если вы попытаетесь запустить Mariabackup с этим параметром, утилита завершится с ошибкой.

--close-files

Определяет, нужно ли закрывать дескрипторы файлов.

Используя этот параметр, вы можете указать Mariabackup, что нужно закрыть дескрипторы файлов. Без этого параметра Mariabackup держит файлы открытыми для управления операциями DDL. При работе с очень большими табличными пространствами закрытие файлов может сделать резервное копирование более управляемым. Однако это также может привести к несогласованным резервным копиям. Используйте на свой страх и риск.

$ mariabackup --close-files --prepare

--compress

Определяет алгоритм сжатия для файлов резервной копии.

--compress[=compression_algorithm]

Параметр --compress поддерживает только устаревший алгоритм quicklz.

$ mariabackup --compress --backup

Если резервная копия сжимается с помощью этого параметра, Mariabackup запишет эту информацию в файл xtrabackup_info.

--compress-chunk-size

Определяет размер рабочей буферизации для потоков сжатия.

--compress-chunk-size=#

Mariabackup может выполнять операции сжатия над файлами резервной копии перед записью на диск. Он также может использовать несколько потоков для параллельного сжатия данных в этом процессе. С помощью этого параметра вы можете задать размер блока, который каждый поток использует во время сжатия. По умолчанию он равен 64КБ.

$ mariabackup --backup --compress \
     --compress-threads=12 --compress-chunk-size=5M

Для дальнейшей настройки сжатия резервных копий см. параметры --compress и --compress-threads.

--compress-threads

Определяет количество потоков для использования при сжатии.

--compress-threads=#

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

$ mariabackup --compress --compress-threads=12 --backup

Для дальнейшей настройки сжатия резервных копий см. параметры --compress и --compress-chunk-size.

--copy-back

Восстанавливает бэкап в каталог данных.

С помощью этой команды Mariabackup копирует бэкап из целевого каталога в каталог данных, заданный параметром --datadir. Перед выполнением этой команды необходимо остановить сервер MariaDB. Каталог данных должен быть пустым. Если вы хотите перезаписать каталог данных бэкапом, используйте параметр --force-non-empty-directories.

Обратите внимание, что перед восстановлением бэкапа необходимо сначала запустить Mariabackup с параметром --prepare. В случае полных бэкапов это делает файлы согласованными по времени. При инкрементных бэкапах это применяет изменения к базовой резервной копии. После подготовки бэкапа вы можете запустить --copy-back для его применения к серверу MariaDB.

$ mariabackup --copy-back --force-non-empty-directories

Команда --copy-back копирует файлы бэкапа в каталог данных. Используйте эту команду, если хотите сохранить бэкап на будущее. Если вы не хотите сохранять бэкап, используйте команду --move-back.

--core-file

Определяет, нужно ли записывать файл core.

Используя этот параметр, вы можете настроить Mariabackup на запись файла core в случае возникновения фатальных сигналов. Это может быть полезно для проверки и отладки.

$ mariabackup --core-file --backup

--databases

Определяет базы данных и таблицы, которые нужно резервировать.

--databases="database[.table][ database[.table] ...]"

Используя этот параметр, вы можете определить конкретную базу данных или базы данных, которые нужно резервировать. В случаях с очень большой базой данных или если нужно резервировать только часть, можно также указать таблицы в базе данных.

$ mariabackup --backup \
      --databases="example.table1 example.table2"

Если нужно резервировать большинство баз данных на сервере или таблицы в базе, но не все, вы можете указать конкретные базы данных или таблицы, которые не нужно резервировать, используя параметр --databases-exclude.

Если бэкап является частичным бэкапом, Mariabackup запишет эту информацию в файл xtrabackup_info.

В режиме innobackupex, который можно включить с помощью параметра --innobackupex, параметр --databases может использоваться как описано выше, или он может использоваться для ссылки на файл, как и параметр --databases-file в обычном режиме.

--databases-exclude

Определяет базы данных, которые не нужно резервировать.

--databases-exclude="database[.table][ database[.table] ...]"

Используя этот параметр, вы можете указать конкретную базу данных или базы данных, которые нужно исключить из процесса резервного копирования. Это может быть полезно, когда вы хотите резервировать большинство баз данных на сервере или таблиц в базе данных, но хотите исключить несколько из процесса.

$ mariabackup --backup \
      --databases="example" \
      --databases-exclude="example.table1 example.table2"

Для включения баз данных в резервную копию см. параметр --databases.

Если бэкап является частичным бэкапом, Mariabackup запишет эту информацию в файл xtrabackup_info.

--databases-file

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

--databases-file="/path/to/database-file"

Форматируйте файл с базами данных, перечисляя по одному элементу в строке, с использованием следующего синтаксиса:

database[.table]

В тех случаях, когда вам нужно резервировать несколько баз данных или конкретные таблицы в базе данных, синтаксис для опций --databases и --databases-exclude может показаться немного громоздким. Используя эту опцию, вы можете указать путь к файлу, содержащему список баз данных или баз данных и таблиц, которые нужно резервировать.

Например, представьте, что список баз данных и таблиц для резервной копии находится в файле main-backup.

$ cat main-backup
example1
example2.table1
example2.table2

$ mariabackup --backup --databases-file=main-backup

Если резервная копия является частичной резервной копией, Mariabackup запишет эту информацию в файл xtrabackup_info.

-h, --datadir

Определяет путь к корню базы данных.

--datadir=PATH

Используя эту опцию, вы можете определить путь к исходному каталогу. Это каталог, который Mariabackup читает для получения данных, которые он резервирует. Он должен быть таким же, как и системная переменная MariaDB Server datadir.

$ mariabackup --backup -h /var/lib64/mysql

--debug-sleep-before-unlock

Эта опция предназначена только для отладки и используется набором тестов Xtrabackup.

--decompress

Определяет, хотите ли вы распаковать ранее сжатые файлы резервной копии.

При запуске Mariabackup с опцией --compress он сжимает последующие файлы резервной копии, используя алгоритм QuickLZ. Используя эту опцию, Mariabackup распаковывает сжатые файлы из предыдущей резервной копии.

Например, выполните резервную копию со сжатием,

$ mariabackup --compress --backup

Затем распакуйте резервную копию,

$ mariabackup --decompress

Вы можете включить дешифрование нескольких файлов одновременно, используя опцию --parallel. По умолчанию Mariabackup не удаляет сжатые файлы из целевого каталога. Если вы хотите удалить эти файлы, используйте опцию --remove-original.

--debug-sync

Определяет точку синхронизации отладки. Эта опция используется только набором тестов Mariabackup.

--defaults-extra-file

Определяет путь к дополнительному файлу параметров по умолчанию файла параметров.

--defaults-extra-file=/path/to/config

Используя эту опцию, вы можете определить дополнительный файл параметров по умолчанию файла параметров для Mariabackup. В отличие от --defaults-file, этот файл читается после чтения файлов параметров по умолчанию, позволяя вам перезаписывать только существующие значения по умолчанию.

$ mariabackup --backup \
      --defaults-file-extra=addition-config.cnf \
      --defaults-file=config.cnf

--defaults-file

Определяет путь к файлу параметров по умолчанию файла параметров.

--defaults-file=/path/to/config

Используя эту опцию, вы можете определить файл параметров по умолчанию файла параметров для Mariabackup. В отличие от опции --defaults-extra-file, при использовании этой опции все файлы параметров по умолчанию полностью заменяются.

$ mariabackup --backup \
     --defaults-file="config.cnf

--defaults-group

Определяет группу параметров для чтения в файле файла параметров.

--defaults-group="name"

В ситуациях, когда вы постоянно используете определённые опции Mariabackup, вы можете задать эти опции в файле файле параметров. Опция --defaults-group определяет группу параметров, которые Mariabackup читает для своих опций.

Опции, которые вы задаёте из командной строки, могут быть заданы в файле конфигурации с небольшими изменениями форматирования. Например, если вы часто выполняете операции сжатия, вы можете установить опции --compress-threads и --compress-chunk-size таким образом:

[mariabackup]
compress_threads = 12
compress_chunk_size = 64K

Теперь, всякий раз, когда вы запускаете резервную копию с опцией --compress, она всегда выполняет сжатие с использованием 12 потоков и 64К блоков.

$ mariabackup --compress --backup

См. Обзор Mariabackup: Группы параметров сервера и Обзор Mariabackup: Группы параметров клиента для списка групп параметров, считываемых Mariabackup по умолчанию.

--encrypted-backup

При использовании этой опции с --backup, если Mariabackup сталкивается со страницей, у которой значение key_version не равно нулю, то Mariabackup предполагает, что страница зашифрована.

Используйте --skip-encrypted-backup вместо этого, чтобы разрешить Mariabackup копировать незашифрованные таблицы, которые изначально были созданы до MySQL 5.1.48.

Эта опция была добавлена в MariaDB 10.2.22, MariaDB 10.3.13 и MariaDB 10.4.2.

--export

Если эта опция указана во время стадии --prepare, она сообщает Mariabackup о создании файлов .cfg для каждой InnoDB таблицы с файлом на таблицу. Эти файлы .cfg используются для импорта переносимых табличных пространств в процессе восстановления частичных резервных копий и восстановления отдельных таблиц и разделов.

$ mariabackup --prepare --export

--extra-lsndir

Сохраняет дополнительную копию файлов xtrabackup_checkpoints и xtrabackup_info в указанный каталог.

--extra-lsndir=PATH

При использовании опции командной строки --backup, Mariabackup создаёт ряд файлов резервной копии в целевом каталоге. Используя эту опцию, вы можете заставить Mariabackup создавать дополнительные копии файлов xtrabackup_checkpoints и xtrabackup_info в указанном каталоге.

$ mariabackup --extra-lsndir=extras/ --backup

Это особенно полезно при использовании --stream для потоковой передачи вывода, например, для сжатия и/или шифрования с помощью внешних инструментов в сочетании с инкрементными резервными копиями, так как файл xtrabackup_checkpoints необходимый для определения LSN для продолжения инкрементной резервной копии, по-прежнему доступен без предварительной распаковки/дешифровки файла резервной копии. Просто передайте --extra-lsndir предыдущей резервной копии как --incremental-basedir

--force-non-empty-directories

Разрешает использовать непустые целевые каталоги с опциями командной строки --copy-back или --move-back.

При использовании Mariabackup с опциями командной строки --copy-back или --move-back они обычно требуют непустого целевого каталога, чтобы избежать конфликтов. Используя эту опцию с любой из команд, Mariabackup может использовать непустой каталог.

$ mariabackup --force-on-empty-directories --copy-back

Помните, что эта опция не позволяет перезаписывать файлы. При копировании или перемещении файлов в целевой каталог, если Mariabackup обнаруживает, что целевой файл уже существует, он завершается с ошибкой.

--ftwrl-wait-query-type

Определяет тип запроса, который может быть завершён, прежде чем Mariabackup выдаст глобальную блокировку.

--ftwrl-wait-query-type=[ALL | UPDATE | SELECT]

Опция --ftwrl-wait-query-type поддерживает следующие типы запросов. Значение по умолчанию — ALL.

При выполнении Mariabackup он выдаёт глобальную блокировку, чтобы предотвратить изменения данных во время процесса резервного копирования. При обнаружении инструкции в процессе выполнения, он ждёт завершения инструкции перед выдачей глобальной блокировки. Используя эту опцию, вы можете изменить это поведение по умолчанию, чтобы гарантировать, что он будет ожидать только определённых типов запросов, например, инструкций SELECT и UPDATE.

$ mariabackup --backup  \
      --ftwrl-wait-query-type=UPDATE

--ftwrl-wait-threshold

Определяет минимальный порог для идентификации длительных запросов для FTWRL.

--ftwrl-wait-threshold=#

При выполнении Mariabackup, она устанавливает глобальную блокировку, чтобы предотвратить изменение данных во время процесса резервного копирования и обеспечить согласованность записей. Если она сталкивается с операторами, которые все ещё выполняются, она ждёт их завершения перед установкой блокировки. Используя этот параметр, вы можете установить порог, при котором Mariabackup включает FTWRL. Когда он --ftwrl-wait-timeout не равен 0 и оператор выполнялся в течение заданного времени, Mariabackup ожидает завершения оператора или истечения --ftwrl-wait-timeout перед установкой глобальной блокировки и началом резервного копирования.

$ mariabackup --backup \
     --ftwrl-wait-timeout=90 \
     --ftwrl-wait-threshold=30

--ftwrl-wait-timeout

Определяет время ожидания запросов перед попыткой получения глобальной блокировки. В MariaDB 10.4 и более поздних версиях, глобальная блокировка относится к BACKUP STAGE BLOCK_COMMIT. В MariaDB 10.3 и более ранних версиях, глобальная блокировка относится к FLUSH TABLES WITH READ LOCK (FTWRL).

--ftwrl-wait-timeout=#

При выполнении Mariabackup она получает глобальную блокировку, чтобы предотвратить изменения данных во время процесса резервного копирования и обеспечить согласованность записей. Если она сталкивается с операторами, которые все ещё выполняются, она может быть настроена на ожидание их завершения перед попыткой получения глобальной блокировки.

Если --ftwrl-wait-timeout установлено в 0, то Mariabackup пытается получить глобальную блокировку немедленно без ожидания. Это значение по умолчанию.

Если --ftwrl-wait-timeout установлено в ненулевое значение, то Mariabackup ожидает заданное количество секунд до попытки получения глобальной блокировки.

Начиная с MariaDB 10.5.3, MariaDB 10.4.13, MariaDB 10.3.23 и MariaDB 10.2.32, Mariabackup завершится, если не сможет получить глобальную блокировку после ожидания заданного количества секунд. В более ранних версиях она могла ожидать глобальной блокировки неопределённо долго, даже если --ftwrl-wait-timeout было установлено в ненулевое значение.

$ mariabackup --backup \
      --ftwrl-wait-query-type=UPDATE \
      --ftwrl-wait-timeout=5

--galera-info

Определяет, хотите ли вы выполнить резервное копирование информации о состоянии узла кластера Galera.

При использовании этого параметра Mariabackup создаёт дополнительный файл под названием xtrabackup_galera_info, который записывает информацию о состоянии узла кластера Galera. Он записывает значения переменных состояния wsrep_local_state_uuid и wsrep_last_committed.

Вы должны использовать этот параметр только при резервном копировании узла кластера Galera. Если сервер не является узлом кластера Galera, то этот параметр не повлияет.

$ mariabackup --backup --galera-info

--history

Определяет, хотите ли вы отслеживать историю резервного копирования в таблице PERCONA_SCHEMA.xtrabackup_history.

--history[=name]

При использовании этого параметра Mariabackup записывает свои действия в таблицу на MariaDB Server. Передача имени этому параметру позволяет сгруппировать резервные копии под произвольными метками для последующей обработки и анализа.

$ mariabackup --backup --history=backup_all

В настоящее время таблица по умолчанию называется mysql.mariadb_backup_history. До MariaDB 10.11 таблица по умолчанию была PERCONA_SCHEMA.xtrabackup_history.

Mariabackup также запишет это в файл xtrabackup_info.

-H, --host

Определяет хост для MariaDB Server, который вы хотите резервировать.

--host=name

Используя этот параметр, вы можете определить хост для подключения к MariaDB Server по протоколу TCP/IP. По умолчанию Mariabackup пытается подключиться к локальному хосту.

$ mariabackup --backup \
      --host="example.com"

--include

Этот параметр — регулярное выражение, которое должно совпадать с именами таблиц в формате "имя_базы_данных.имя_таблицы". Он эквивалентен параметру --tables. Действителен только в режиме innobackupex, который можно включить с помощью параметра --innobackupex.

--incremental

Определяет, хотите ли вы выполнить прирастительное резервное копирование, основываясь на другой резервной копии. Действителен только в режиме innobackupex, который можно включить с помощью параметра --innobackupex.

mariabackup --innobackupex --incremental

Использование этого параметра с опцией команды --backup делает операцию прирастительной, а не полным перезаписыванием. Когда этот параметр указан, используется параметр --incremental-lsn or --incremental-basedir options can also be given. If neither option is given, option --incremental-basedir is used by default, set to the first timestamped backup directory in the backup base directory..

$ mariabackup --innobackupex --backup --incremental \
     --incremental-basedir=/data/backups \
     --target-dir=/data/backups

Если резервное копирование является прирастительным, то Mariabackup запишет эту информацию в файл xtrabackup_info.

--incremental-basedir

Определяет, хотите ли вы выполнить прирастительное резервное копирование, основываясь на другой резервной копии.

--incremental-basedir=PATH

Использование этого параметра с опцией команды --backup делает операцию прирастительной, а не полным перезаписыванием. Mariabackup будет копировать только страницы из файлов .ibd , если они новее, чем резервная копия в указанном каталоге.

$ mariabackup --backup \
     --incremental-basedir=/data/backups \
     --target-dir=/data/backups

Если резервное копирование является прирастительным, то Mariabackup запишет эту информацию в файл xtrabackup_info.

--incremental-dir

Определяет, хотите ли вы выполнить прирастительное резервное копирование, основываясь на другой резервной копии.

--increment-dir=PATH

Использование этого параметра с командой --prepare делает операцию прирастительной, а не полным перезаписыванием. Mariabackup будет применять файлы .delta и файлы журналов в целевой каталог.

$ mariabackup --prepare \
      --increment-dir=backups/

Если резервное копирование является прирастительным, то Mariabackup запишет эту информацию в файл xtrabackup_info.

--incremental-force-scan

Определяет, хотите ли вы принудительно выполнить полное сканирование для прирастительных резервных копий.

При использовании Mariabackup для выполнения прирастительного резервного копирования, этот параметр заставляет его также выполнить полное сканирование страниц данных, которые резервируются, даже при наличии битовой карты изменений. MariaDB 10.2 и более поздние версии не поддерживают битовые карты изменённых страниц, поэтому этот параметр бесполезен в этих версиях. См. MDEV-18985 для получения дополнительной информации.

$ mariabackup --backup \
     --incremental-basedir=/path/to/target \
     --incremental-force-scan

--incremental-history-name

Определяет логическое имя резервной копии.

--incremental-history-name=name

Mariabackup может хранить данные о своих операциях на MariaDB Server. Используя этот параметр, вы можете определить логическое имя, которое используется для идентификации резервной копии.

$ mariabackup --backup \
     --incremental-history-name=morning_backup

В настоящее время таблица по умолчанию называется mysql.mariadb_backup_history. До MariaDB 10.11 таблица по умолчанию была PERCONA_SCHEMA.xtrabackup_history.

Mariabackup также запишет это в файл xtrabackup_info.

--incremental-history-uuid

Определяет UUID для резервной копии.

--incremental-history-uuid=name

Mariabackup может хранить данные о своих операциях на MariaDB Server. Используя этот параметр, вы можете определить UUID, который используется для идентификации предыдущей резервной копии для инкрементального резервного копирования. Она проверяет --incremental-history-name, --incremental-basedir, и --incremental-lsn. Если Mariabackup не найдёт допустимого lsn, то сгенерирует ошибку.

$ mariabackup --backup \
      --incremental-history-uuid=main-backup012345678

В настоящее время используемая таблица называется PERCONA_SCHEMA.xtrabackup_history, но ожидается, что это имя изменится в будущих версиях. См. MDEV-19246 для получения дополнительной информации.

Mariabackup также запишет это в файл xtrabackup_info.

--incremental-lsn

Определяет последовательный номер для прирастительных резервных копий.

--incremental-lsn=name

Используя этот параметр, вы можете определить значение последовательного номера (LSN) для --backup операций. Во время резервного копирования Mariabackup копирует только .ibd страницы, которые новее указанных значений.

ПРЕДУПРЕЖДЕНИЕ: Неверные значения LSN могут сделать резервную копию непригодной. Диагностировать эту проблему невозможно.

--innobackupex

Включает режим innobackupex — режим совместимости.

$ mariabackup --innobackupex

В режиме innobackupex Mariabackup имеет следующие отличия:

• Для подготовки резервной копии используется параметр --apply-log вместо параметра --prepare.
• Для создания прирастительной резервной копии поддерживается параметр --incremental.
• Поддерживается параметр --no-timestamp.
• Для создания частичной резервной копии используется параметр --include вместо параметра --tables.
• Для создания частичной резервной копии параметр --databases всё ещё может использоваться, но его поведение немного меняется.
• Параметр --target-dir не используется для указания каталога резервной копии. Вместо этого каталог резервной копии должен быть указан в качестве отдельного аргумента.

Основная цель режима innobackupex — позволить скриптам и инструментам легче перейти на Mariabackup, если они были изначально разработаны для использования утилиты innobackupex, которая входит в Percona XtraBackup. Не рекомендуется использовать этот режим в новых скриптах, так как нет гарантии, что он будет поддерживаться всегда. См. MDEV-20552 для получения дополнительной информации.

--innodb

Этот параметр не влияет. Установлен только для совместимости с параметром MySQL.

--innodb-adaptive-hash-index

Включает InnoDB Adaptive Hash Index.

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно явно включить InnoDB Adaptive Hash Index. Эта функция включена по умолчанию для Mariabackup. Если вы хотите её отключить, используйте --skip-innodb-adaptive-hash-index.

$ mariabackup --backup \
      --innodb-adaptive-hash-index

--innodb-autoextend-increment

Определяет приращение в мегабайтах для автоматического увеличения размера файла табличного пространства.

--innodb-autoextend-increment=36

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

$ mariabackup --backup \
     --innodb-autoextend-increment=35

--innodb-buffer-pool-filename

Использование этого параметра не имеет эффекта. Он доступен для обеспечения совместимости с MariaDB Server.

--innodb-buffer-pool-size

Определяет размер буфера памяти, который InnoDB использует для кеширования данных и индексов таблицы.

--innodb-buffer-pool-size=124M

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно настроить буферный пул для операций InnoDB.

$ mariabackup --backup \
      --innodb-buffer-pool-size=124M

--innodb-checksum-algorithm

innodb_checksum_algorithm был устаревшим в MariaDB 10.3.29, MariaDB 10.4.19, MariaDB 10.5.10 и удален в MariaDB 10.6.

В более ранних версиях он использовался для определения алгоритма проверки целостности.

--innodb-checksum-algorithm=crc32
                           | strict_crc32
                           | innodb
                           | strict_innodb
                           | none
                           | strict_none 

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно указать алгоритм, который Mariabackup использует при проверке целостности таблиц InnoDB. В настоящее время MariaDB поддерживает следующие алгоритмы CRC32, STRICT_CRC32, INNODB, STRICT_INNODB, NONE, STRICT_NONE.

$ mariabackup --backup \
      ---innodb-checksum-algorithm=strict_innodb

--innodb-data-file-path

Определяет путь к отдельным файлам данных.

--innodb-data-file-path=/path/to/file

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно определить путь к файлам данных InnoDB. Каждый путь добавляется к параметру --innodb-data-home-dir.

$ mariabackup --backup \
     --innodb-data-file-path=ibdata1:13M:autoextend \
     --innodb-data-home-dir=/var/dbs/mysql/data

--innodb-data-home-dir

Определяет домашнюю директорию для файлов данных InnoDB.

--innodb-data-home-dir=PATH

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно определить путь к директории, содержащей файлы данных InnoDB. Файлы можно указать с помощью параметра --innodb-data-file-path.

$ mariabackup --backup \
     --innodb-data-file-path=ibdata1:13M:autoextend \
     --innodb-data-home-dir=/var/dbs/mysql/data

--innodb-doublewrite

Включает двойные записи для таблиц InnoDB.

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. При использовании этого параметра Mariabackup повышает устойчивость к ошибкам в таблицах InnoDB с буфером двойной записи. По умолчанию эта функция включена. Используйте этот параметр для явного включения. Для отключения двойных записей используйте параметр --skip-innodb-doublewrite.

$ mariabackup --backup \
     --innodb-doublewrite

--innodb-encrypt-log

Определяет, хотите ли вы зашифровать логи InnoDB.

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра вы можете указать Mariabackup, что вы хотите зашифровать логи его активности в InnoDB.

--innodb-file-io-threads

Определяет количество потоков файловых ввода-вывода в InnoDB.

--innodb-file-io-threads=#

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно определить количество потоков файлового ввода-вывода, которые Mariabackup использует для таблиц InnoDB.

$ mariabackup --backup \
     --innodb-file-io-threads=5

--innodb-file-per-table

Определяет, хотите ли вы хранить каждую таблицу InnoDB в отдельном .ibd файле.

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра Mariabackup хранит каждую таблицу InnoDB в виде отдельного .ibd файла в целевой директории.

--innodb-flush-method

Определяет метод сброса данных. Игнорируется начиная с MariaDB 11.0.

--innodb-flush-method=fdatasync 
                     | O_DSYNC 
                     | O_DIRECT 
                     | O_DIRECT_NO_FSYNC 
                     | ALL_O_DIRECT

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

$ mariabackup --backup \
      --innodb-flush-method==_DIRECT_NO_FSYNC

Обратите внимание, метод 0_DIRECT_NO_FSYNC доступен только с MariaDB 10.0 и более поздних версиях. Метод ALL_O_DIRECT доступен с версии 5.5 и более поздних, но только для таблиц с использованием движка хранения XtraDB.

--innodb-io-capacity

Определяет количество операций ввода-вывода, которые может выполнять утилита.

--innodb-io-capacity=#

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

$ mariabackup --backup \
     --innodb-io-capacity=200

--innodb-log-checksums

Определяет, следует ли включать контрольные суммы в журналы InnoDB.

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно явно задать Mariabackup включить контрольные суммы в журналы InnoDB. Функция включена по умолчанию. Чтобы отключить её, используйте параметр --skip-innodb-log-checksums.

$ mariabackup --backup \
      --innodb-log-checksums

--innodb-log-buffer-size

Этот параметр не имеет функциональности в Mariabackup. Он существует для совместимости с MariaDB Server.

--innodb-log-files-in-group

Этот параметр не имеет функциональности в Mariabackup. Он существует для совместимости с MariaDB Server.

--innodb-log-group-home-dir

Определяет путь к файлам журналов InnoDB.

--innodb-log-group-home-dir=PATH

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно определить путь к файлам журналов InnoDB.

$ mariabackup --backup \
     --innodb-log-group-home-dir=/path/to/logs

--innodb-max-dirty-pages-pct

Определяет процент грязных страниц, разрешённых в буферном пуле InnoDB.

--innodb-max-dirty-pages-pct=#

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно определить максимальный процент грязных (то есть не записанных) страниц, которые Mariabackup разрешает в буферном пуле InnoDB.

$ mariabackup --backup \
     --innodb-max-dirty-pages-pct=80

--innodb-open-files

Определяет количество файлов, которые могут быть открыты одновременно.

--innodb-open-files=#

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно установить максимальное количество файлов, которые InnoDB держит открытыми в заданное время во время резервного копирования.

$ mariabackup --backup \
      --innodb-open-files=10

--innodb-page-size

Определяет универсальный размер страницы.

--innodb-page-size=#

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

$ mariabackup --backup \
     --innodb-page-size=16k

--innodb-read-io-threads

Определяет количество фоновых потоков чтения ввода-вывода в InnoDB.

--innodb-read-io-threads=#

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно установить количество потоков ввода-вывода, которые MariaDB использует при чтении из InnoDB.

$ mariabackup --backup \
      --innodb-read-io-threads=4

--innodb-undo-directory

Определяет директорию для файлов табличного пространства отмены.

--innodb-undo-directory=PATH

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно определить путь к директории, где MariaDB будет хранить табличное пространство отмены для таблиц InnoDB. Путь может быть абсолютным.

$ mariabackup --backup \
     --innodb-undo-directory=/path/to/innodb_undo

--innodb-undo-tablespaces

Определяет количество используемых табличных пространств отмены.

--innodb-undo-tablespaces=#

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

$ mariabackup --backup \
      --innodb-undo-tablespaces=10

--innodb-use-native-aio

Определяет, хотите ли вы использовать native AI/O.

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно включить использование встроенной подсистемы асинхронного ввода-вывода. Она доступна только в операционных системах Linux.

$ mariabackup --backup \
      --innodb-use-native-aio

--innodb-write-io-threads

Определяет количество фоновых потоков записи ввода-вывода в InnoDB.

--innodb-write-io-threads=#

Mariabackup инициализирует собственную встроенную инстанцию InnoDB, используя ту же конфигурацию, что и в файле конфигурации. С помощью этого параметра можно задать количество фоновых потоков записи ввода-вывода, которые Mariabackup использует.

$ mariabackup --backup \
     --innodb-write-io-threads=4

--kill-long-queries-timeout

Определяет таймаут для блокирующих запросов.

--kill-long-queries-timeout=#

При запуске Mariabackup выполняется операция FLUSH TABLES WITH READ LOCK. Затем определяется блокировка запросов. С помощью этого параметра можно установить тайм-аут в секундах для этих блокирующих запросов. По истечении времени Mariabackup прерывает эти запросы.

Значение по умолчанию равно 0, что приводит к тому, что Mariabackup не пытается прервать какие-либо запросы.

$ mariabackup --backup \
      --kill-long-queries-timeout=10

--kill-long-query-type

Определяет тип запроса, который утилита может прервать, чтобы разблокировать глобальную блокировку.

--kill-long-query-type=ALL | UPDATE | SELECT

Когда Mariabackup сталкивается с запросом, устанавливающим глобальную блокировку, он может прервать запрос, чтобы освободить MariaDB Server для резервного копирования. С помощью этого параметра можно выбрать типы запросов, которые он прерывает: SELECT, UPDATE, или оба, указав ALL. Значение по умолчанию — ALL.

$ mariabackup --backup \
      --kill-long-query-type=UPDATE

--lock-ddl-per-table

Препятствует резервному копированию DDL для каждой таблицы, приобретая блокировку MDL на ней. ПРИМЕЧАНИЕ: Если не указан параметр --no-lock, конфликтующие запросы DDL будут прерваны в конце резервного копирования. Это делается для предотвращения тупиков между «FLUSH TABLE WITH READ LOCK», запросом DDL пользователя (ALTER, RENAME) и блокировкой MDL на таблице. Доступно только в MariaDB 10.2.9 и более поздних версиях.

--log

Этот параметр не имеет функциональности. Он установлен для обеспечения совместимости с MySQL.

--log-bin

Определяет базовое имя для последовательности логов.

--log-bin[=name]

С помощью этого параметра можно задать базовое имя, используемое Mariabackup в последовательностях логов.

--log-copy-interval

Определяет интервал копирования между проверками, выполняемыми потоком копирования логов.

--log-copy-interval=#

С помощью этого параметра можно задать интервал копирования, используемый Mariabackup между проверками, выполняемыми потоком копирования логов. Указанное значение в миллисекундах.

$ mariabackup --backup \
      --log-copy-interval=50

--log-innodb-page-corruption

Продолжить резервное копирование, если обнаружены поврежденные страницы InnoDB. Страницы записываются в innodb_corrupted_pages, и резервное копирование завершается с ошибкой. --prepare попытается исправить поврежденные страницы. Если innodb_corrupted_pages существует после --prepare в каталоге резервного копирования, резервная копия все еще содержит поврежденные страницы и не может считаться согласованной.

Добавлен в MariaDB 10.2.37, MariaDB 10.3.28, MariaDB 10.4.18, MariaDB 10.5.9

--move-back

Восстанавливает резервную копию в каталог данных.

С помощью этой команды Mariabackup перемещает резервную копию из целевого каталога в каталог данных, как определено параметром --datadir. Необходимо остановить MariaDB Server перед выполнением этой команды. Каталог данных должен быть пустым. Если вы хотите перезаписать каталог данных резервной копией, используйте параметр --force-non-empty-directories.

Помните, что перед восстановлением резервной копии необходимо сначала запустить Mariabackup с параметром --prepare. В случае полных резервных копий это делает файлы согласованными с указанным моментом времени. В случае инкрементных резервных копий это применяет изменения к основной резервной копии. После подготовки резервной копии можно запустить --move-back для ее применения к MariaDB Server.

$ mariabackup --move-back \
      --datadir=/var/mysql

Выполнение команды --move-back перемещает файлы резервной копии в каталог данных. Используйте эту команду, если вы не хотите сохранять резервную копию на будущее. Если вы хотите сохранить резервную копию на будущее, используйте команду --copy-back.

--mysqld

Используется внутренне для подготовки резервной копии.

--no-backup-locks

Mariabackup по умолчанию блокирует базу данных при запуске. Этот параметр отключает поддержку блокировок резервного копирования Percona Server.

При резервном копировании Percona Server Mariabackup по умолчанию использует блокировки резервного копирования. Точнее, блокировки резервного копирования относятся к операторам LOCK TABLES FOR BACKUP и LOCK BINLOG FOR BACKUP. Этот параметр можно использовать для отключения поддержки блокировок резервного копирования Percona Server. Этот параметр не оказывает влияния, если сервер не поддерживает блокировки резервного копирования Percona.

Этот параметр может быть в конечном итоге удален. Дополнительную информацию см. в MDEV-19753.

$ mariabackup --backup --no-backup-locks

--no-lock

Отключает блокировки таблиц с помощью оператора FLUSH TABLE WITH READ LOCK.

Использование этого параметра приводит к отключению Mariabackup блокировок таблиц с помощью оператора FLUSH TABLE WITH READ LOCK. Используйте этот параметр только в следующих случаях:

• Вы не выполняете операторы DML для таблиц, не являющихся InnoDB, во время резервного копирования. Сюда входят системные таблицы базы данных mysql (MyISAM).
• Вы не выполняете никакие операторы DDL во время резервного копирования.
• Вам не важно, согласована ли позиция двоичного журнала, включенная в резервную копию xtrabackup_binlog_info, с данными.
• Все таблицы, которые вы резервируете, используют движок хранения InnoDB.

$ mariabackup --backup --no-lock

Если вы рассматриваете использование --no-lock из-за сбоев резервного копирования при получении блокировок, это может быть связано с поступающими событиями репликации, препятствующими получению блокировки. Попробуйте использовать параметр --safe-slave-backup для временной остановки потока репликации. Это может помочь резервному копированию успешно завершиться без использования --no-lock.

--no-timestamp

Этот параметр предотвращает создание подкаталога со временем резервной копии из заданного в командной строке каталога BACKUP-ROOT-DIR. При его указании резервное копирование выполняется в каталоге BACKUP-ROOT-DIR. Это допустимо только в режиме innobackupex, который можно включить с помощью параметра --innobackupex.

--no-version-check

Отключает проверку версии.

Используя этот параметр, вы можете отключить проверку версии Mariabackup.

$ mariabackup --backup --no-version-check

--open-files-limit

Определяет максимальное число дескрипторов файлов.

--open-files-limit=#

С помощью этого параметра вы можете определить максимальное число дескрипторов файлов, которые Mariabackup зарезервирует с помощью setrlimit().

$ mariabackup --backup \
      --open-files-limit=

--parallel

Определяет количество потоков, используемых для параллельной передачи файлов данных.

--parallel=#

С помощью этого параметра можно задать количество потоков, используемых Mariabackup для параллельной передачи файлов данных. По умолчанию он равен 1.

-p, --password

Определяет пароль для подключения к MariaDB Server.

--password=passwd

При запуске Mariabackup он подключается к MariaDB Server для доступа и резервного копирования баз данных и таблиц. С помощью этого параметра можно задать пароль, используемый Mariabackup для доступа к серверу. Для задания пользователя используйте параметр --user.

$ mariabackup --backup \
      --user=root \
      --password=root_password

--plugin-dir

Определяет каталог для серверных плагинов.

--plugin-dir=PATH

С помощью этого параметра можно определить путь, который Mariabackup использует для чтения плагинов MariaDB Server. Он используется только на стадии --prepare для загрузки плагина шифрования. По умолчанию используется переменная сервера plugin_dir.

$ mariabackup --backup \
      --plugin-dir=/var/mysql/lib/plugin

--plugin-load

Определяет плагины шифрования для загрузки.

--plugin-load=name

С помощью этого параметра можно задать плагин шифрования, который необходимо загрузить. Используется только на стадии --prepare для загрузки плагина шифрования. По умолчанию используется параметр сервера --plugin-load.

Параметр был удален, начиная с MariaDB 10.2.18

-P, --port

Определяет порт сервера для подключения.

--port=#

При запуске Mariabackup он подключается к MariaDB Server, чтобы получить доступ и создать резервную копию ваших баз данных и таблиц. С помощью этого параметра можно установить порт, используемый утилитой для доступа к серверу через TCP/IP. Для задания хоста используйте параметр --host. Дополнительную информацию см. в mysql --help.

$ mariabackup --backup \
      --host=192.168.11.1 \
      --port=3306

--prepare

Подготавливает существующую резервную копию для восстановления на MariaDB Server.

Файлы, которые Mariabackup создает во время операций --backup в целевом каталоге, не готовы к использованию на сервере. Перед тем, как восстановить данные на MariaDB, необходимо сначала подготовить резервную копию.

В случае полных резервных копий файлы не согласованы с указанным моментом времени, так как они были созданы в разное время. Если попытаться восстановить базу данных без предварительной подготовки данных, InnoDB отклонит новые данные как поврежденные. Запуск Mariabackup с командой --prepare подготавливает данные для восстановления на MariaDB Server. При работе с инкрементными резервными копиями необходимо использовать команду --prepare и параметр --incremental-dir для обновления основной резервной копии изменениями из инкрементной резервной копии.

$ mariabackup --prepare

После подготовки резервной копии можно использовать команды --copy-back или --move-back для восстановления резервной копии на сервере.

--print-defaults

Выводит список аргументов утилиты, затем завершает работу.

С помощью этого аргумента MariaDB выводит список аргументов в стандартный вывод, а затем завершает работу. Это может быть полезно при отладке для просмотра того, как заданы параметры утилиты.

$ mariabackup --print-defaults

--print-param

Выводит параметры MariaDB Server, необходимые для copyback.

С помощью этого параметра Mariabackup выводит в стандартный вывод параметры MariaDB Server, необходимые утилите для выполнения команды --copy-back.

$ mariabackup --print-param

--rollback-xa

По умолчанию Mariabackup не будет подтверждать или отменять незавершенные XA-транзакции, и при восстановлении резервной копии любые незавершенные XA-транзакции должны быть вручную подтверждены с помощью XA COMMIT или вручную отменены с помощью XA ROLLBACK.

В MariaDB 10.2, MariaDB 10.3 и MariaDB 10.4, опция --rollback-xa Mariabackup может использоваться для отката незавершенных XA-транзакций во время выполнения операции --prepare, чтобы при восстановлении бэкапа их не нужно было откатывать или подтверждать вручную.

Эта опция отсутствует начиная с MariaDB 10.5, так как сервер имеет более надёжные способы обработки незавершенных XA-транзакций в более поздних версиях.

--rsync

Определяет, использовать ли rsync.

Во время обычной работы Mariabackup передает локальные файлы, не являющиеся файлами InnoDB, используя отдельный вызов cp для каждого файла. Используя эту опцию, вы можете оптимизировать этот процесс, выполнив передачу с помощью rsync.

$ mariabackup --backup --rsync

Эта опция несовместима с опцией --stream.

--safe-slave-backup

Останавливает потоки SQL репликации для бэкапов.

При запуске Mariabackup на сервере, использующем репликацию, иногда могут возникать блокировки, препятствующие выполнению бэкапа. Используя эту опцию, она останавливает потоки SQL репликации и ждёт, пока значение Slave_open_temp_tables в операторе SHOW STATUS станет нулевым. Если временные таблицы не открыты, бэкап выполняется, в противном случае поток SQL запускается и останавливается, пока не будет закрыто все временные таблицы.

$ mariabackup --backup \
      --safe-slave-backup \
      --safe-slave-backup-timeout=500

Бэкап завершается ошибкой, если Slave_open_temp_tables не достигнет нуля после периода ожидания, заданного опцией --safe-slave-backup-timeout.

--safe-slave-backup-timeout

Определяет время ожидания для бэкапов реплик.

--safe-slave-backup-timeout=#

При запуске Mariabackup на сервере, использующем репликацию, иногда могут возникать блокировки, препятствующие выполнению бэкапа. С помощью опции --safe-slave-backup ожидается, пока значение Slave_open_temp_tables в операторе SHOW STATUS достигнет нуля. Используя эту опцию, вы устанавливаете время ожидания. По умолчанию оно равно 300.

$ mariabackup --backup \
      --safe-slave-backup \
      --safe-slave-backup-timeout=500

--secure-auth

Отклоняет подключения клиентов к серверам, использующим более старый протокол.

Используя эту опцию, вы можете явно отклонить подключения клиентов к серверу при использовании более старого протокола, чем 4.1.1. Эта функция включена по умолчанию. Чтобы отключить её, используйте опцию --skip-secure-auth.

$ mariabackup --backup --secure-auth

--skip-innodb-adaptive-hash-index

Отключает индекс InnoDB Adaptive Hash.

Mariabackup инициализирует собственную встроенную экземпляр InnoDB, используя те же настройки, что и в файле конфигурации. Используя эту опцию, вы можете явно отключить индекс InnoDB Adaptive Hash. Эта функция включена по умолчанию для Mariabackup. Если вы хотите её явно включить, используйте --innodb-adaptive-hash-index.

$ mariabackup --backup \
      --skip-innodb-adaptive-hash-index

--skip-innodb-doublewrite

Отключает двойные записи для таблиц InnoDB.

Mariabackup инициализирует собственную встроенную экземпляр InnoDB, используя те же настройки, что и в файле конфигурации. Когда двойные записи включены, InnoDB повышает отказоустойчивость с помощью буфера двойных записей. По умолчанию эта функция включена. Используя эту опцию, вы можете её отключить для Mariabackup. Чтобы явно включить двойные записи, используйте опцию --innodb-doublewrite.

$ mariabackup --backup \
     --skip-innodb-doublewrite

--skip-innodb-log-checksums

Определяет, исключать ли контрольные суммы в журналах InnoDB.

Mariabackup инициализирует собственную встроенную экземпляр InnoDB, используя те же настройки, что и в файле конфигурации. Используя эту опцию, вы можете настроить Mariabackup на исключение контрольных сумм в журналах InnoDB. Функция включена по умолчанию. Чтобы явно включить её, используйте опцию --innodb-log-checksums.

--skip-secure-auth

Отклоняет подключения клиентов к серверам, использующим более старый протокол.

Используя эту опцию, вы можете настроить её для принятия подключений клиентов к серверу при использовании более старого протокола, чем 4.1.1. По умолчанию эти подключения отклоняются. Используйте опцию --secure-auth для явного включения этой опции.

$ mariabackup --backup --skip-secure-auth

--slave-info

Выводит позицию бинарного журнала и имя первичного сервера.

Если сервер является репликой, то эта опция заставляет Mariabackup выводить имя хоста первичного сервера репликации и файл бинарного журнала и позицию потока SQL репликации в stdout.

Эта опция также заставляет Mariabackup записывать эту информацию в виде команды CHANGE MASTER, которую можно использовать для настройки нового сервера как реплики первичного сервера после восстановления бэкапа. Эта информация будет записана в файл xtrabackup_slave_info.

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

$ mariabackup --slave-info

-S, --socket

Определяет сокет для подключения к локальной базе данных.

--socket=name

Используя эту опцию, вы можете определить сокет UNIX-домена, который нужно использовать при подключении к локальному серверу базы данных. Опция принимает строковый аргумент. Для получения дополнительной информации см. команду mysql --help.

$ mariabackup --backup \
      --socket=/var/mysql/mysql.sock

--ssl

Включает TLS. Используя эту опцию, вы можете явно настроить Mariabackup на шифрование своего соединения с TLS при общении с сервером. Это может быть полезно при выполнении бэкапов в средах, где безопасность имеет особую важность, или при работе по небезопасной сети.

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

• --ssl-ca
• --ssl-capath
• --ssl-cert
• --ssl-cipher
• --ssl-key

--ssl-ca

Определяет путь к файлу PEM, который должен содержать один или несколько сертификатов X509 для доверенных центров сертификации (ЦС), которые будут использоваться для TLS. Для этой опции требуется использование абсолютного пути, а не относительного. Например:

--ssl-ca=/etc/my.cnf.d/certificates/ca.pem

Эта опция обычно используется вместе с другими опциями TLS. Например:

$ mariabackup --backup \
   --ssl-cert=/etc/my.cnf.d/certificates/client-cert.pem \
   --ssl-key=/etc/my.cnf.d/certificates/client-key.pem \
   --ssl-ca=/etc/my.cnf.d/certificates/ca.pem 

См. Обзор безопасных подключений: Удостоверяющие центры (ЦС) для получения дополнительной информации.

Эта опция подразумевает опцию --ssl.

--ssl-capath

Определяет путь к каталогу, содержащему один или несколько файлов PEM, каждый из которых должен содержать один сертификат X509 для доверенного центра сертификации (ЦС) для использования с TLS. Для этой опции требуется использование абсолютного пути, а не относительного. Например:

--ssl-capath=/etc/my.cnf.d/certificates/ca/

Эта опция обычно используется вместе с другими опциями TLS. Например:

$ mariabackup --backup \
   --ssl-cert=/etc/my.cnf.d/certificates/client-cert.pem \
   --ssl-key=/etc/my.cnf.d/certificates/client-key.pem \
   --ssl-ca=/etc/my.cnf.d/certificates/ca.pem \
   --ssl-capath=/etc/my.cnf.d/certificates/ca/

Каталог, указанный этой опцией, должен быть обработан командой openssl rehash.

См. Обзор безопасных подключений: Удостоверяющие центры (ЦС) для получения дополнительной информации.

Эта опция подразумевает опцию --ssl.

--ssl-cert

Определяет путь к файлу сертификата X509 для использования с TLS. Для этой опции требуется использование абсолютного пути, а не относительного. Например:

--ssl-cert=/etc/my.cnf.d/certificates/client-cert.pem

Эта опция обычно используется вместе с другими опциями TLS. Например:

$ mariabackup --backup \
   --ssl-cert=/etc/my.cnf.d/certificates/client-cert.pem \
   --ssl-key=/etc/my.cnf.d/certificates/client-key.pem \
   --ssl-ca=/etc/my.cnf.d/certificates/ca.pem

Эта опция подразумевает опцию --ssl.

--ssl-cipher

Определяет список разрешенных шифров или наборов шифров для использования с TLS. Например:

--ssl-cipher=name

Эта опция обычно используется вместе с другими опциями TLS. Например:

$ mariabackup --backup \
   --ssl-cert=/etc/my.cnf.d/certificates/client-cert.pem \
   --ssl-key=/etc/my.cnf.d/certificates/client-key.pem \
   --ssl-ca=/etc/my.cnf.d/certificates/ca.pem
   --ssl-cipher=TLSv1.2

Чтобы определить, ограничивает ли сервер клиентов определенными шифрами, проверьте переменную системы ssl_cipher.

Эта опция подразумевает опцию --ssl.

--ssl-crl

Определяет путь к файлу PEM, который должен содержать один или несколько отозванных сертификатов X509 для использования с TLS. Для этой опции требуется использование абсолютного пути, а не относительного. Например:

--ssl-crl=/etc/my.cnf.d/certificates/crl.pem

Эта опция обычно используется вместе с другими опциями TLS. Например:

$ mariabackup --backup \
   --ssl-cert=/etc/my.cnf.d/certificates/client-cert.pem \
   --ssl-key=/etc/my.cnf.d/certificates/client-key.pem \
   --ssl-ca=/etc/my.cnf.d/certificates/ca.pem \
   --ssl-crl=/etc/my.cnf.d/certificates/crl.pem

См. Обзор безопасных подключений: списки отозванных сертификатов (CRL) для получения дополнительной информации.

Этот параметр поддерживается только если Mariabackup был скомпилирован с OpenSSL. Если Mariabackup был скомпилирован с yaSSL, то этот параметр не поддерживается. Для получения дополнительной информации о том, какие библиотеки используются на каких платформах, см. TLS и библиотеки шифрования, используемые MariaDB.

--ssl-crlpath

Определяет путь к каталогу, содержащему один или несколько файлов PEM, каждый из которых должен содержать один отозванный сертификат X509, который нужно использовать для TLS. Этот параметр требует указания абсолютного пути, а не относительного. Например:

--ssl-crlpath=/etc/my.cnf.d/certificates/crl/

Этот параметр обычно используется с другими параметрами TLS. Например:

$ mariabackup --backup \
   --ssl-cert=/etc/my.cnf.d/certificates/client-cert.pem \
   --ssl-key=/etc/my.cnf.d/certificates/client-key.pem \
   --ssl-ca=/etc/my.cnf.d/certificates/ca.pem \
   --ssl-crlpath=/etc/my.cnf.d/certificates/crl/ 

Каталог, указанный этим параметром, должен быть обработан командой openssl rehash.

Дополнительную информацию см. в разделе Обзор безопасных подключений: списки отозванных сертификатов (CRL).

Этот параметр поддерживается только если Mariabackup был скомпилирован с OpenSSL. Если Mariabackup был скомпилирован с yaSSL, то этот параметр не поддерживается. Для получения дополнительной информации о том, какие библиотеки используются на каких платформах, см. TLS и библиотеки шифрования, используемые MariaDB.

--ssl-key

Определяет путь к файлу с закрытым ключом, который нужно использовать для TLS. Этот параметр требует указания абсолютного пути, а не относительного. Например:

--ssl-key=/etc/my.cnf.d/certificates/client-key.pem

Этот параметр обычно используется с другими параметрами TLS. Например:

$ mariabackup --backup \
   --ssl-cert=/etc/my.cnf.d/certificates/client-cert.pem \
   --ssl-key=/etc/my.cnf.d/certificates/client-key.pem \
   --ssl-ca=/etc/my.cnf.d/certificates/ca.pem

Этот параметр подразумевает параметр --ssl.

--ssl-verify-server-cert

Включает проверку сертификата сервера. Этот параметр по умолчанию отключен.

Этот параметр обычно используется с другими параметрами TLS. Например:

$ mariabackup --backup \
   --ssl-cert=/etc/my.cnf.d/certificates/client-cert.pem \
   --ssl-key=/etc/my.cnf.d/certificates/client-key.pem \
   --ssl-ca=/etc/my.cnf.d/certificates/ca.pem \
   --ssl-verify-server-cert

--stream

Потоковая передача файлов резервной копии в стандартный вывод.

--stream=xbstream

Используя этот параметр, можно настроить Mariabackup на потоковую передачу файлов резервной копии в стандартный вывод в заданном формате. В настоящее время поддерживается формат xbstream.

$ mariabackup --stream=xbstream > backup.xb

Чтобы извлечь все файлы из архива xbstream в каталог, используйте утилиту mbstream

$ mbstream  -x < backup.xb

Если резервная копия передается по потоку, то Mariabackup запишет формат в файл xtrabackup_info.

--tables

Определяет таблицы, которые нужно включить в резервную копию.

--tables=REGEX

Используя этот параметр, можно определить, какие таблицы необходимо резервировать из базы данных. Значения таблиц определяются с помощью регулярных выражений. Чтобы определить таблицы, которые нужно исключить из резервной копии, см. параметр --tables-exclude.

$ mariabackup --backup \
     --databases=example
     --tables=nodes_* \
     --tables-exclude=nodes_tmp

Если резервная копия является частичной резервной копией, то Mariabackup запишет эту информацию в файл xtrabackup_info.

--tables-exclude

Определяет таблицы, которые нужно исключить из резервной копии.

--tables-exclude=REGEX

Используя этот параметр, можно определить, какие таблицы нужно исключить из резервной копии. Значения таблиц определяются с помощью регулярных выражений. Чтобы определить таблицы, которые нужно включить в резервную копию, см. параметр --tables.

$ mariabackup --backup \
     --databases=example
     --tables=nodes_* \
     --tables-exclude=nodes_tmp

Если резервная копия является частичной резервной копией, то Mariabackup запишет эту информацию в файл xtrabackup_info.

--tables-file

Определяет путь к файлу с таблицами для резервных копий.

--tables-file=/path/to/file

Используя этот параметр, можно указать путь к файлу, содержащему список таблиц, которые нужно резервировать. Mariabackup перебирает каждую строку в файле. Формат database.table.

$ mariabackup --backup \
     --databases=example \
     --tables-file=/etc/mysql/backup-file

Если резервная копия является частичной резервной копией, то Mariabackup запишет эту информацию в файл xtrabackup_info.

--target-dir

Определяет целевой каталог.

--target-dir=/path/to/target

Используя этот параметр, можно указать целевой каталог для резервной копии. Mariabackup записывает все файлы резервной копии в этот каталог. Mariabackup создаст каталог, если он не существует (но не будет создавать весь путь рекурсивно, т.е. по крайней мере родительский каталог, если каталог --target-dir должен существовать).

$ mariabackup --backup \
       --target-dir=/data/backups

--throttle

Определяет ограничение на операции ввода-вывода в секунду в значениях IOS.

--throttle=#

Используя этот параметр, можно установить ограничение на операции ввода-вывода, выполняемые Mariabackup в секунду в значениях IOS. Он используется только при использовании параметра команды --backup.

--tls-version

Этот параметр принимает список версий протокола TLS, разделенный запятыми. Версия протокола TLS будет включена только если она присутствует в этом списке. Все другие версии протокола TLS не будут разрешены. Например:

--tls-version="TLSv1.2,TLSv1.3"

Этот параметр обычно используется с другими параметрами TLS. Например:

$ mariabackup --backup \
   --ssl-cert=/etc/my.cnf.d/certificates/client-cert.pem \
   --ssl-key=/etc/my.cnf.d/certificates/client-key.pem \
   --ssl-ca=/etc/my.cnf.d/certificates/ca.pem \
   --tls-version="TLSv1.2,TLSv1.3"

Этот параметр был добавлен в MariaDB 10.4.6.

Дополнительную информацию см. в разделе Обзор безопасных подключений: версии протокола TLS.

-t, --tmpdir

Определяет путь для временных файлов.

--tmpdir=/path/tmp[;/path/tmp...]

Используя этот параметр, можно определить путь к каталогу, который Mariabackup использует для записи временных файлов. Если нужно использовать более одного каталога, разделяйте значения точкой с запятой (например, ;). При передаче нескольких временных каталогов Mariabackup переключается между ними по кругу.

$ mariabackup --backup \
     --tmpdir=/data/tmp;/tmp

--use-memory

Определяет размер пула буферов, используемого на стадии подготовки.

--use-memory=124M

Используя этот параметр, можно определить размер пула буферов для Mariabackup. Используйте его вместо buffer_pool_size.

$ mariabackup --prepare \
      --use-memory=124M

--user

Определяет имя пользователя для подключения к серверу MariaDB.

--user=name
-u name

При выполнении Mariabackup он подключается к указанному серверу MariaDB, чтобы получить резервные копии. Используя этот параметр, можно определить пользователя базы данных, используемого для аутентификации.

$ mariabackup --backup \
      --user=root \
      --password=root_passwd

--version

Выводит информацию о версии.

Используя этот параметр, можно вывести информацию о версии Mariabackup в стандартный вывод.

$ mariabackup --version