MariaDBをmariabackupでホットバックアップする手順｜フルバックアップ・増分バックアップ・リストアの実務

この記事のポイント

・mariabackupはInnoDBをロックなしでホットバックアップできるMariaDB公式ツール
・mariadb-backupパッケージをdnfで導入し、専用バックアップユーザーで実行する
・リストアは--prepare（前処理）→ --copy-back（データ戻し）の2ステップで完結する
・増分バックアップを組み合わせると毎日の差分だけ保存でき、バックアップ容量を削減できる

# mariadb-backup パッケージをインストール
sudo dnf install -y mariadb-backup

# バージョンを確認する
mariabackup --version

mariabackup based on MariaDB server 10.11.6-MariaDB

-- MariaDB に root でログイン
sudo mariadb -u root

-- バックアップ専用ユーザーを作成する
CREATE USER 'mariabackup'@'localhost' IDENTIFIED BY 'StrongPass!2026';

-- 必要な権限を付与する
GRANT RELOAD, LOCK TABLES, PROCESS, REPLICATION CLIENT ON *.* TO 'mariabackup'@'localhost';

FLUSH PRIVILEGES;

-- 付与された権限を確認する
SHOW GRANTS FOR 'mariabackup'@'localhost';

+----------------------------------------------------------------------+
| Grants for mariabackup@localhost                                     |
+----------------------------------------------------------------------+
| GRANT RELOAD, PROCESS, LOCK TABLES, REPLICATION CLIENT ON *.* TO   |
| `mariabackup`@`localhost` IDENTIFIED BY PASSWORD '***'               |
+----------------------------------------------------------------------+

# バックアップ保存先ディレクトリを作成する
sudo mkdir -p /backup/mariadb/full

# フルバックアップを取得する（--target-dir に保存先を指定）
sudo mariabackup --backup \
  --target-dir=/backup/mariadb/full \
  --user=mariabackup \
  --password=StrongPass!2026

[00] 2026-08-22 14:05:31 Connecting to MySQL server host: localhost, user: mariabackup, password: set
[00] 2026-08-22 14:05:31 Using server version 10.11.6-MariaDB
[00] 2026-08-22 14:05:31 mariabackup: Starting backup!
[00] 2026-08-22 14:05:31 Backup created in directory '/backup/mariadb/full/'
[00] 2026-08-22 14:05:32 Copying ./ibdata1
[00] 2026-08-22 14:05:33 Copying ./ib_logfile0
[01] 2026-08-22 14:05:33 Copying ./sampledb/orders.ibd
[01] 2026-08-22 14:05:37 Copying ./sampledb/products.ibd
[00] 2026-08-22 14:05:42 Executed FLUSH NO_WRITE_TO_BINLOG TABLES
[00] 2026-08-22 14:05:42 Backup successfully locked.
[00] 2026-08-22 14:05:43 Backup lock released
[00] 2026-08-22 14:05:43 completed OK!

ls -lh /backup/mariadb/full/

total 196M
drwxr-x--- 2 root root   4096 Aug 22 14:05 sampledb
-rw-r----- 1 root root    427 Aug 22 14:05 backup-my.cnf
-rw-r----- 1 root root    26M Aug 22 14:05 ibdata1
-rw-r----- 1 root root   5.0M Aug 22 14:05 ib_logfile0
-rw-r----- 1 root root    164 Aug 22 14:05 xtrabackup_info
-rw-r----- 1 root root     23 Aug 22 14:05 xtrabackup_checkpoints

# バックアップに--prepareを実行して整合性をとる
sudo mariabackup --prepare --target-dir=/backup/mariadb/full

[00] 2026-08-22 15:30:11 Starting InnoDB instance for recovery.
[00] 2026-08-22 15:30:12 InnoDB: Buffer pool(s) load completed at 150820 15:30:12
...
[00] 2026-08-22 15:30:14 completed OK!

# MariaDB を停止する
sudo systemctl stop mariadb

# 既存の datadir を退避する（念のため削除ではなくリネーム）
sudo mv /var/lib/mysql /var/lib/mysql.bak

# 空の datadir を作成する
sudo mkdir /var/lib/mysql

# バックアップからデータを戻す
sudo mariabackup --copy-back --target-dir=/backup/mariadb/full

# datadir の所有者を mysql:mysql に修正する
sudo chown -R mysql:mysql /var/lib/mysql

# MariaDB を起動する
sudo systemctl start mariadb

# 正常に起動したか確認する
sudo systemctl status mariadb

* mariadb.service - MariaDB 10.11 database server
     Loaded: loaded (/usr/lib/systemd/system/mariadb.service; enabled; preset: disabled)
     Active: active (running) since Fri 2026-08-22 15:35:42 JST; 5s ago
     Status: "Taking your SQL requests now..."
   Main PID: 8821 (mariadbd)

# 1回目の増分バックアップ（フルバックアップを基点にする）
sudo mkdir -p /backup/mariadb/inc1
sudo mariabackup --backup \
  --target-dir=/backup/mariadb/inc1 \
  --incremental-basedir=/backup/mariadb/full \
  --user=mariabackup \
  --password=StrongPass!2026

# 2回目の増分バックアップ（inc1 を基点にする）
sudo mkdir -p /backup/mariadb/inc2
sudo mariabackup --backup \
  --target-dir=/backup/mariadb/inc2 \
  --incremental-basedir=/backup/mariadb/inc1 \
  --user=mariabackup \
  --password=StrongPass!2026

# ステップ1: フルバックアップを準備する（--apply-log-onlyで開いたまま）
sudo mariabackup --prepare --apply-log-only \
  --target-dir=/backup/mariadb/full

# ステップ2: 1回目の増分を適用する（まだ--apply-log-only）
sudo mariabackup --prepare --apply-log-only \
  --target-dir=/backup/mariadb/full \
  --incremental-dir=/backup/mariadb/inc1

# ステップ3: 2回目の増分を適用する（最後は--apply-log-onlyをつけない）
sudo mariabackup --prepare \
  --target-dir=/backup/mariadb/full \
  --incremental-dir=/backup/mariadb/inc2

# ステップ4: MariaDBを停止してデータを戻す（フルバックアップと同じ手順）
sudo systemctl stop mariadb
sudo mv /var/lib/mysql /var/lib/mysql.bak
sudo mkdir /var/lib/mysql
sudo mariabackup --copy-back --target-dir=/backup/mariadb/full
sudo chown -R mysql:mysql /var/lib/mysql
sudo systemctl start mariadb

#!/bin/bash
# /usr/local/bin/mariadb-full-backup.sh

BACKUP_BASE=/backup/mariadb
DATE=$(date +%Y%m%d_%H%M%S)
TARGET_DIR=${BACKUP_BASE}/full_${DATE}
LOG_FILE=/var/log/mariadb-backup.log
BACKUP_USER=mariabackup
BACKUP_PASS=StrongPass!2026
KEEP_DAYS=7

# バックアップを実行する
mkdir -p "${TARGET_DIR}"
mariabackup --backup \
  --target-dir="${TARGET_DIR}" \
  --user="${BACKUP_USER}" \
  --password="${BACKUP_PASS}" >> "${LOG_FILE}" 2>&1

if [ $? -eq 0 ]; then
  echo "$(date '+%Y-%m-%d %H:%M:%S') [OK] Full backup: ${TARGET_DIR}" >> "${LOG_FILE}"
else
  echo "$(date '+%Y-%m-%d %H:%M:%S') [FAIL] Full backup failed" >> "${LOG_FILE}"
  exit 1
fi

# KEEP_DAYS 世代より古いバックアップを削除する
find "${BACKUP_BASE}" -maxdepth 1 -name "full_*" -type d \
  -mtime +${KEEP_DAYS} -exec rm -rf {} +

# 実行権限を付与する
sudo chmod 750 /usr/local/bin/mariadb-full-backup.sh

# cron に登録する（毎日 02:00 に実行）
sudo crontab -e
# 追加する行:
0 2 * * * /usr/local/bin/mariadb-full-backup.sh

# MariaDB の起動状態を確認する
sudo systemctl status mariadb

# ソケットファイルのパスを確認する
sudo mariadb -u root -e "SHOW VARIABLES LIKE 'socket';"

# ソケットパスを明示して接続する
sudo mariabackup --backup \
  --socket=/var/lib/mysql/mysql.sock \
  --user=mariabackup \
  --password=StrongPass!2026 \
  --target-dir=/backup/mariadb/full

# ユーザーの存在と権限を確認する
sudo mariadb -u root -e "SHOW GRANTS FOR 'mariabackup'@'localhost';"

# ユーザーが存在しない場合は再作成する
sudo mariadb -u root -e "
  CREATE USER IF NOT EXISTS 'mariabackup'@'localhost' IDENTIFIED BY 'StrongPass!2026';
  GRANT RELOAD, LOCK TABLES, PROCESS, REPLICATION CLIENT ON *.* TO 'mariabackup'@'localhost';
  FLUSH PRIVILEGES;
"

# datadir を退避してから空ディレクトリを作成する
sudo systemctl stop mariadb
sudo mv /var/lib/mysql /var/lib/mysql.bak.$(date +%Y%m%d)
sudo mkdir /var/lib/mysql

# SELinux コンテキストを修正する
sudo restorecon -Rv /var/lib/mysql

# 再起動を試みる
sudo systemctl start mariadb