--- title: "Mariabackup による MariaDB Server のバックアップ/リストア" publish_date: 2019-03-26 updated_date: 2023-10-12 author: "MariaDB" tags: - name: "backup" url: "/ja/resources/blog/tag/backup-ja.md" - name: "MariaDB Server" url: "/ja/resources/blog/tag/mariadb-server-ja.md" --- # Mariabackup による MariaDB Server のバックアップ/リストア MariaDB Server 10.1 で以下の機能が実装されたため， - [InnoDB Page Compression](https://staging-mdb.com/kb/en/library/compression/) - [Data-at-Rest Encryption](https://staging-mdb.com/kb/en/library/data-at-rest-encryption/) MariaDB Server 10.1 以降 Percona XtraBackup との互換性が失われています。 この対策として，MariaDB Server 10.1.23 / 10.2.7 以降，[XtraBackup](https://www.percona.com/doc/percona-xtrabackup) を fork した [Mariabackup](https://staging-mdb.com/kb/en/library/mariabackup-overview/) が利用可能となっています。 本記事では Mariabackup に関してご説明いたします。 ### Mariabackup 概要 [Mariabackup](https://staging-mdb.com/kb/en/library/mariabackup-overview/) では以下の機能がサポートされています。 - [Data-at-Rest Encryption](https://staging-mdb.com/kb/en/library/data-at-rest-encryption/) を利用しているシステムにおけるバックアップ/リストア - [InnoDB Page Compression](https://staging-mdb.com/kb/en/library/compression/) を利用しているテーブルのバックアップ/リストア - Galera Cluster における [SST(State Snapshot Transfer)](https://staging-mdb.com/kb/en/library/introduction-to-state-snapshot-transfers-ssts/) - Microsoft Windows上でのバックアップ/リストア ### Mariabackup と XtraBackup の違い Mariabackup は XtraBackup を fork しているため機能的にはほぼ同等ですが，Mariabackup と XtraBackup には以下のような違いがあります。 - Percona XtraBackup は [InnoDB redo log](https://staging-mdb.com/kb/en/xtradbinnodb-redo-log/) ファイルを `xtrabackup_logfile` にコピーするが， Mariabackup は `ib_logfile0` を用いる。 - XtraBackup の [encrypted backup](https://www.percona.com/doc/percona-xtrabackup/2.3/backup_scenarios/encrypted_backup.html) は Mariabackup でサポートされない。 - `mariabackup` から `innobackupex`, への symbolic link はない。 - `--compact` , `--rebuild_indexes` オプションはサポートされない。 - `--stream=tar` オプションはサポートされない。 - `xbstream` は `mbstream` に名称変更されている。 ### 最新の MariaDB Server に対して XtraBackup を利用することの問題点 MariaDB Server 10.3 を利用し，以下のように XtraBackup によってバックアップを行おうとすると，エラーとなります。 ``` $ innobackupex ~/backup_to_dir --user=username --password=password ... InnoDB: Unsupported redo log format. The redo log was created with MariaDB 10.3.13. ``` XtraBackup は MariaDB Server 10.3 の redo log をサポートしません(ここで，XtraBackup は古いバージョンのため，innobackupex コマンドを用いています)。 これに対して Mariabackup は新しい redo log フォーマットに対応しています。 ### Mariabackup を用いたバックアップ/リストア テスト環境として以下の2台の MariaDB Server を用意し，古いバージョンの MariaDB Server 上でバックアップを実施，新しいバージョンの MariaDB server 上でリストアを行ってみます。 - MariaDB Server 10.2.22 (バックアップ元) / CentOS 7 - MariaDB Server 10.3.13 (リストア先) / CentOS 7 なお，mariababckup を利用するには，以下のRPMパッケージをインストールする必要があります。 ``` MariaDB-backup ``` ### MariaDB Server 10.2 におけるバックアップ データのバックアップ先(target dir)として，/tmp/backup を指定し，mariabackup によるバックアップを実行します。 なお，バックアップ元のサーバには，事前に [A sample MySQL database](https://github.com/datacharmer/test_db) から clone したデータがインポート済です。 ``` mdb102# time mariabackup --backup --target-dir /tmp/backup --user=root [00] 2019-03-03 17:28:26 Connecting to MySQL server host: localhost, user: root, password: not set, port: not set, socket: not set [00] 2019-03-03 17:28:26 Using server version 10.2.22-MariaDB [00] 2019-03-03 17:28:26 mariabackup based on MariaDB server 10.2.22-MariaDB Linux (x86_64) [00] 2019-03-03 17:28:26 uses posix_fadvise(). [00] 2019-03-03 17:28:26 cd to /var/lib/mysql/ [00] 2019-03-03 17:28:26 open files limit requested 0, set to 1024 [00] 2019-03-03 17:28:26 mariabackup: using the following InnoDB configuration: [00] 2019-03-03 17:28:26 innodb_data_home_dir = [00] 2019-03-03 17:28:26 innodb_data_file_path = ibdata1:12M:autoextend [00] 2019-03-03 17:28:26 innodb_log_group_home_dir = ./ [00] 2019-03-03 17:28:26 InnoDB: Using Linux native AIO 2019-03-03 17:28:26 140678729349312 [Note] InnoDB: Number of pools: 1 [00] 2019-03-03 17:28:26 mariabackup: Generating a list of tablespaces 2019-03-03 17:28:26 140678729349312 [Warning] InnoDB: Allocated tablespace ID 1 for mysql/innodb_table_stats, old maximum was 0 [00] 2019-03-03 17:28:26 >> log scanned up to (292475043) [01] 2019-03-03 17:28:26 Copying ibdata1 to /tmp/backup/ibdata1 [01] 2019-03-03 17:28:26 ...done [01] 2019-03-03 17:28:27 Copying ./mysql/innodb_table_stats.ibd to /tmp/backup/mysql/innodb_table_stats.ibd [01] 2019-03-03 17:28:27 ...done [01] 2019-03-03 17:28:27 Copying ./mysql/innodb_index_stats.ibd to /tmp/backup/mysql/innodb_index_stats.ibd [01] 2019-03-03 17:28:27 ...done [01] 2019-03-03 17:28:27 Copying ./mysql/gtid_slave_pos.ibd to /tmp/backup/mysql/gtid_slave_pos.ibd [01] 2019-03-03 17:28:27 ...done [01] 2019-03-03 17:28:27 Copying ./employees/employees.ibd to /tmp/backup/employees/employees.ibd [01] 2019-03-03 17:28:27 ...done [01] 2019-03-03 17:28:27 Copying ./employees/departments.ibd to /tmp/backup/employees/departments.ibd [01] 2019-03-03 17:28:27 ...done [01] 2019-03-03 17:28:27 Copying ./employees/dept_manager.ibd to /tmp/backup/employees/dept_manager.ibd [01] 2019-03-03 17:28:27 ...done [01] 2019-03-03 17:28:27 Copying ./employees/dept_emp.ibd to /tmp/backup/employees/dept_emp.ibd [01] 2019-03-03 17:28:27 ...done [01] 2019-03-03 17:28:27 Copying ./employees/titles.ibd to /tmp/backup/employees/titles.ibd [01] 2019-03-03 17:28:27 ...done [01] 2019-03-03 17:28:27 Copying ./employees/salaries.ibd to /tmp/backup/employees/salaries.ibd [01] 2019-03-03 17:28:27 ...done [00] 2019-03-03 17:28:27 >> log scanned up to (292475043) [00] 2019-03-03 17:28:27 Executing FLUSH NO_WRITE_TO_BINLOG TABLES... [00] 2019-03-03 17:28:27 Executing FLUSH TABLES WITH READ LOCK... [00] 2019-03-03 17:28:27 Starting to backup non-InnoDB tables and files [01] 2019-03-03 17:28:27 Copying ./mysql/db.frm to /tmp/backup/mysql/db.frm [01] 2019-03-03 17:28:27 ...done [01] 2019-03-03 17:28:27 Copying ./mysql/db.MYI to /tmp/backup/mysql/db.MYI [01] 2019-03-03 17:28:27 ...done ...中略... [01] 2019-03-03 17:28:28 Copying ./mysql/index_stats.frm to /tmp/backup/mysql/index_stats.frm [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./mysql/index_stats.MYI to /tmp/backup/mysql/index_stats.MYI [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./mysql/index_stats.MYD to /tmp/backup/mysql/index_stats.MYD [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./mysql/gtid_slave_pos.frm to /tmp/backup/mysql/gtid_slave_pos.frm [01] 2019-03-03 17:28:28 ...done [00] 2019-03-03 17:28:28 Writing test/db.opt [00] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./performance_schema/db.opt to /tmp/backup/performance_schema/db.opt [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./employees/db.opt to /tmp/backup/employees/db.opt [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./employees/employees.frm to /tmp/backup/employees/employees.frm [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./employees/departments.frm to /tmp/backup/employees/departments.frm [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./employees/dept_manager.frm to /tmp/backup/employees/dept_manager.frm [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./employees/dept_emp.frm to /tmp/backup/employees/dept_emp.frm [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./employees/titles.frm to /tmp/backup/employees/titles.frm [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./employees/salaries.frm to /tmp/backup/employees/salaries.frm [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./employees/dept_emp_latest_date.frm to /tmp/backup/employees/dept_emp_latest_date.frm [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying ./employees/current_dept_emp.frm to /tmp/backup/employees/current_dept_emp.frm [01] 2019-03-03 17:28:28 ...done [00] 2019-03-03 17:28:28 Finished backing up non-InnoDB tables and files [01] 2019-03-03 17:28:28 Copying aria_log_control to /tmp/backup/aria_log_control [01] 2019-03-03 17:28:28 ...done [01] 2019-03-03 17:28:28 Copying aria_log.00000001 to /tmp/backup/aria_log.00000001 [01] 2019-03-03 17:28:28 ...done [00] 2019-03-03 17:28:28 Waiting for log copy thread to read lsn 292475043 [00] 2019-03-03 17:28:28 >> log scanned up to (292475043) [00] 2019-03-03 17:28:28 Executing FLUSH NO_WRITE_TO_BINLOG ENGINE LOGS... [00] 2019-03-03 17:28:28 The latest check point (for incremental): '292475034' mariabackup: Stopping log copying thread.[00] 2019-03-03 17:28:28 >> log scanned up to (292475043) [00] 2019-03-03 17:28:29 >> log scanned up to (292475043) [00] 2019-03-03 17:28:29 Executing UNLOCK TABLES [00] 2019-03-03 17:28:29 All tables unlocked [00] 2019-03-03 17:28:29 Copying ib_buffer_pool to /tmp/backup/ib_buffer_pool [00] 2019-03-03 17:28:29 ...done [00] 2019-03-03 17:28:29 Backup created in directory '/tmp/backup/' [00] 2019-03-03 17:28:29 Writing backup-my.cnf [00] 2019-03-03 17:28:29 ...done [00] 2019-03-03 17:28:29 Writing xtrabackup_info [00] 2019-03-03 17:28:29 ...done [00] 2019-03-03 17:28:29 Redo log (from LSN 292475034 to 292475043) was copied. [00] 2019-03-03 17:28:29 completed OK! real 0m2.293s user 0m0.034s sys 0m0.578s ``` /tmp/backup にデータがバックアップされますので， ``` /tmp/backup: [root@mdb102 backup]# ls -lah -rw-r-----. 1 root root 16K Mar 3 17:28 aria_log.00000001 -rw-r-----. 1 root root 52 Mar 3 17:28 aria_log_control -rw-r-----. 1 root root 297 Mar 3 17:28 backup-my.cnf drwx------. 2 root root 4.0K Mar 3 17:28 employees -rw-r-----. 1 root root 938 Mar 3 17:28 ib_buffer_pool -rw-r-----. 1 root root 12M Mar 3 17:28 ibdata1 -rw-r-----. 1 root root 2.5K Mar 3 17:28 ib_logfile0 drwx------. 2 root root 4.0K Mar 3 17:28 mysql drwx------. 2 root root 20 Mar 3 17:28 performance_schema drwx------. 2 root root 20 Mar 3 17:28 test -rw-r-----. 1 root root 105 Mar 3 17:28 xtrabackup_checkpoints -rw-r-----. 1 root root 431 Mar 3 17:28 xtrabackup_info ``` tar + gzip 等でアーカイブし，リストア先サーバへコピーします。 ### MariaDB Server 10.3 へのリストア リストア先のサーバでは，datadir システム変数(デフォルト値: /var/lib/mysql)で示されるデータディレクトリにあるデータを事前に削除しておく必要があります。datadir にデータが存在する場合，以下のようなエラーが発生します。 ``` mariabackup --copy-back --target-dir /tmp/backup [00] 2019-03-03 18:43:20 mariabackup based on MariaDB server 10.3.13-MariaDB Linux (x86_64) [00] 2019-03-03 18:43:20 Original data directory /var/lib/mysql is not empty! ``` バックアップ元からコピーしたデータを target dir に展開し，datadir にあるデータを削除します。 ``` # cd /tmp/ # tar xvf /root/backup190303.tgz # systemctl stop mariadb # cd /var/lib/mysql # rm -fr * ``` 実際のリストアの前に `--prepare` オプションによりデータの一貫性のチェックを行います。 ``` mdb103# mariabackup --prepare --target-dir /tmp/backup [00] 2019-03-03 16:34:54 mariabackup based on MariaDB server 10.3.13-MariaDB Linux (x86_64) [00] 2019-03-03 16:34:54 cd to /tmp/backup/ [00] 2019-03-03 16:34:54 This target seems to be not prepared yet. [00] 2019-03-03 16:34:54 mariabackup: using the following InnoDB configuration for recovery: [00] 2019-03-03 16:34:54 innodb_data_home_dir = . [00] 2019-03-03 16:34:54 innodb_data_file_path = ibdata1:12M:autoextend [00] 2019-03-03 16:34:54 innodb_log_group_home_dir = . [00] 2019-03-03 16:34:54 InnoDB: Using Linux native AIO [00] 2019-03-03 16:34:54 Starting InnoDB instance for recovery. [00] 2019-03-03 16:34:54 mariabackup: Using 104857600 bytes for buffer pool (set by --use-memory parameter) 2019-03-03 16:34:54 0 [Note] InnoDB: Mutexes and rw_locks use GCC atomic builtins 2019-03-03 16:34:54 0 [Note] InnoDB: Uses event mutexes 2019-03-03 16:34:54 0 [Note] InnoDB: Compressed tables use zlib 1.2.7 2019-03-03 16:34:54 0 [Note] InnoDB: Number of pools: 1 2019-03-03 16:34:54 0 [Note] InnoDB: Using SSE2 crc32 instructions 2019-03-03 16:34:54 0 [Note] InnoDB: Initializing buffer pool, total size = 100M, instances = 1, chunk size = 100M 2019-03-03 16:34:54 0 [Note] InnoDB: Completed initialization of buffer pool 2019-03-03 16:34:54 0 [Note] InnoDB: page_cleaner coordinator priority: -20 2019-03-03 16:34:54 0 [Note] InnoDB: Starting crash recovery from checkpoint LSN=292475034 [00] 2019-03-03 16:34:54 Last binlog file , position 0 [00] 2019-03-03 16:34:54 completed OK! ``` 最後に completed OK! と表示されていれば問題ありません。 ここで，`--copy-back` オプションを付与して mariabackup を実行し，データをリストアします。 ``` mdb103# time mariabackup --copy-back --target-dir /tmp/backup [00] 2019-03-03 18:30:00 mariabackup based on MariaDB server 10.3.13-MariaDB Linux (x86_64) [01] 2019-03-03 18:30:00 Copying ibdata1 to /var/lib/mysql/ibdata1 [01] 2019-03-03 18:30:00 ...done [01] 2019-03-03 18:30:00 Copying ./mysql/innodb_table_stats.ibd to /var/lib/mysql/mysql/innodb_table_stats.ibd [01] 2019-03-03 18:30:00 ...done [01] 2019-03-03 18:30:00 Copying ./mysql/innodb_index_stats.ibd to /var/lib/mysql/mysql/innodb_index_stats.ibd [01] 2019-03-03 18:30:00 ...done [01] 2019-03-03 18:30:00 Copying ./mysql/gtid_slave_pos.ibd to /var/lib/mysql/mysql/gtid_slave_pos.ibd [01] 2019-03-03 18:30:00 ...done [01] 2019-03-03 18:30:00 Copying ./mysql/db.frm to /var/lib/mysql/mysql/db.frm [01] 2019-03-03 18:30:00 ...done [01] 2019-03-03 18:30:00 Copying ./mysql/db.MYI to /var/lib/mysql/mysql/db.MYI [01] 2019-03-03 18:30:00 ...done [01] 2019-03-03 18:30:00 Copying ./mysql/db.MYD to /var/lib/mysql/mysql/db.MYD [01] 2019-03-03 18:30:00 ...done ...中略... [01] 2019-03-03 18:30:00 Copying ./xtrabackup_info to /var/lib/mysql/xtrabackup_info [01] 2019-03-03 18:30:00 ...done [01] 2019-03-03 18:30:00 Copying ./xtrabackup_binlog_pos_innodb to /var/lib/mysql/xtrabackup_binlog_pos_innodb [01] 2019-03-03 18:30:00 ...done [00] 2019-03-03 18:30:00 completed OK! real 0m0.656s user 0m0.003s sys 0m0.625s ``` バックアップ時は 2.3秒 ほど時間がかかっていましたが，リストアは 0.7 秒 ほどで完了しています。 リストアした直後はデータファイル/ディレクトリの owner が mariabackup を実行したユーザになっていますので，mysql:mysql に変更し，mariadb service を起動します。 ``` # cd /var/lib/mysql # chown -R mysql:mysql . # systemctl start mariadb ``` ### リストアしたデータの確認 [A sample MySQL database](https://github.com/datacharmer/test_db) の test\_employees\_sha.sql を用いてバックアップしたデータが正常にリストアされているか確認します。 なお，test\_employees\_sha.sql は [BLACKHOLE](https://staging-mdb.com/kb/en/library/blackhole/) ストレージエンジンを用いていますので，双方の MariaDB Server 上で ``` INSTALL SONAME 'ha_blackhole'; ``` を実行し，BLACKHOLE を利用可能にしておく必要があります。 ### バックアップ元での確認 まず，test\_db ディレクトリにて，employees データベースに対して test\_employees\_sha.sql を実行します。 ``` mdb102# cd test_db mdb102# mysql employees Reading table information for completion of table and column names You can turn off this feature to get a quicker startup with -A Welcome to the MariaDB monitor. Commands end with ; or \g. Your MariaDB connection id is 10 Server version: 10.2.22-MariaDB MariaDB Server Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. MariaDB [employees]> source test_employees_sha.sql Database changed +----------------------+ | INFO | +----------------------+ | TESTING INSTALLATION | +----------------------+ ...中略 +--------------+------------------+------------------------------------------+ | table_name | found_records | found_crc | +--------------+------------------+------------------------------------------+ | employees | 300024 | 4d4aa689914d8fd41db7e45c2168e7dcb9697359 | | departments | 9 | 4b315afa0e35ca6649df897b958345bcb3d2b764 | | dept_manager | 24 | 9687a7d6f93ca8847388a42a6d8d93982a841c6c | | dept_emp | 331603 | d95ab9fe07df0865f592574b3b33b9c741d9fd1b | | titles | 443308 | d12d5f746b88f07e69b9e36675b6067abb01b60e | | salaries | 2844047 | b5a1785c27d75e33a4173aaa22ccf41ebd7d4a9f | +--------------+------------------+------------------------------------------+ +--------------+---------------+-----------+ | table_name | records_match | crc_match | +--------------+---------------+-----------+ | employees | OK | ok | | departments | OK | ok | | dept_manager | OK | ok | | dept_emp | OK | ok | | titles | OK | ok | | salaries | OK | ok | +--------------+---------------+-----------+ +------------------+ | computation_time | +------------------+ | 00:00:10 | +------------------+ +---------+--------+ | summary | result | +---------+--------+ | CRC | OK | | count | OK | +---------+--------+ ``` すべてのテーブルのレコード数，チェックサムが一致しています。 ### リストア先での確認 同様にリストア先でもレコード数，チェックサムの確認を実施します。 ``` mdb103# cd /root/test_db mdb103# mysql employees Reading table information for completion of table and column names You can turn off this feature to get a quicker startup with -A Welcome to the MariaDB monitor. Commands end with ; or \g. Your MariaDB connection id is 8 Server version: 10.3.13-MariaDB MariaDB Server Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. MariaDB [employees]> INSTALL SONAME 'ha_blackhole'; Query OK, 0 rows affected (0.001 sec) MariaDB [employees]> source test_employees_sha.sql Database changed +----------------------+ | INFO | +----------------------+ | TESTING INSTALLATION | +----------------------+ 1 row in set (0.000 sec) ...中略 +--------------+------------------+------------------------------------------+ | table_name | found_records | found_crc | +--------------+------------------+------------------------------------------+ | employees | 300024 | 4d4aa689914d8fd41db7e45c2168e7dcb9697359 | | departments | 9 | 4b315afa0e35ca6649df897b958345bcb3d2b764 | | dept_manager | 24 | 9687a7d6f93ca8847388a42a6d8d93982a841c6c | | dept_emp | 331603 | d95ab9fe07df0865f592574b3b33b9c741d9fd1b | | titles | 443308 | d12d5f746b88f07e69b9e36675b6067abb01b60e | | salaries | 2844047 | b5a1785c27d75e33a4173aaa22ccf41ebd7d4a9f | +--------------+------------------+------------------------------------------+ +--------------+---------------+-----------+ | table_name | records_match | crc_match | +--------------+---------------+-----------+ | employees | OK | ok | | departments | OK | ok | | dept_manager | OK | ok | | dept_emp | OK | ok | | titles | OK | ok | | salaries | OK | ok | +--------------+---------------+-----------+ +------------------+ | computation_time | +------------------+ | 00:00:08 | +------------------+ +---------+--------+ | summary | result | +---------+--------+ | CRC | OK | | count | OK | +---------+--------+ ``` 正常にリストアされていることが確認できました。 ### まとめ Percona XtraBackup から fork された MariaDB Server 用バックアップツール，[Mariabackup](https://staging-mdb.com/kb/en/library/mariabackup-overview/) の基本的な利用方法について解説させて頂きました。 なお，MariaDB ColumnStore 専用の [columnstoreBackup](https://staging-mdb.com/kb/en/library/backup-and-restore-for-mariadb-columnstore-110-onwards/#columnstorebackup) / [columnstoreRestore](https://staging-mdb.com/kb/en/library/backup-and-restore-for-mariadb-columnstore-110-onwards/#columnstorebackup) に関しましては，[BSL 1.1](https://github.com/mariadb-corporation/mariadb-columnstore-tools/blob/master/LICENSE.txt) でライセンスされていますので，ご留意願います。