MariaDB 教程 / 使用 mariadb-dump 备份并验证恢复条件

mariadb-dump 创建的是逻辑备份,文件中包含重建对象定义和数据行的 SQL。应明确备份范围、选择一致性选项和输出路径、检查退出状态,并在另一个空数据库恢复验证;只有文件存在并不能证明备份可用。

先界定备份范围与恢复目标

本篇只备份独立数据库 backup46_lab 的四张 InnoDB 表,并不覆盖整个实例的账户、配置或外部文件。允许丢失多少数据、允许多长恢复时间,会影响备份频率、保存位置及是否还需要日志恢复方案。存储卷或同盘副本也不能代替单独的备份。

范围 本篇内容 真实系统还需审查
数据 四张 InnoDB 表 其他引擎、数据量与并发结构修改
对象 基本表、主键与外键 视图、DEFINER、例程、触发器和事件
账户与配置 不属于这个数据库转储 单独的恢复流程与依赖
验证 在另一个空库恢复 结构、数据行、约束、业务合计与访问

从源库生成 SQL 后,应先审查文件,再恢复到独立目标并比较内容,不能直接把生成文件当作验证完成:

从源数据库生成 SQL 文件,恢复到另一个空数据库,再比较结构、数据行、约束与业务金额

选项与对象处理依据是 MariaDB 的 mariadb-dump 官方文档。对生产备份,应结合实际工具版本、对象清单和恢复目标,而不是仅复制一行命令。

建立独立的备份源数据库

使用有建库权限的管理员连接,先检查 SHOW DATABASES;,确认 backup46_lab 未被使用。如果已经存在,应停止并选新名称、同步调整后续命令,不能删除已有库让示例运行。以下完整样本不依赖先前练习的数据状态;SQL 在 MariaDB 客户端执行。

CREATE DATABASE backup46_lab CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE backup46_lab;
CREATE TABLE c46_customers (
 customer_id INT NOT NULL PRIMARY KEY,
 customer_name VARCHAR(50) NOT NULL,
 city VARCHAR(30) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE c46_products (
 product_id INT NOT NULL PRIMARY KEY,
 product_name VARCHAR(100) NOT NULL,
 category VARCHAR(30) NOT NULL,
 price DECIMAL(10,2) NOT NULL CHECK (price >= 0),
 stock INT NOT NULL CHECK (stock >= 0)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE c46_orders (
 order_id INT NOT NULL PRIMARY KEY,
 customer_id INT NOT NULL,
 ordered_at DATETIME NOT NULL,
 status VARCHAR(20) NOT NULL,
 shipping_fee DECIMAL(10,2) NOT NULL DEFAULT 1000,
 CONSTRAINT fk_c46_order_customer FOREIGN KEY (customer_id)
  REFERENCES c46_customers(customer_id) ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE c46_items (
 order_id INT NOT NULL,
 product_id INT NOT NULL,
 quantity INT NOT NULL CHECK (quantity > 0),
 unit_price DECIMAL(10,2) NOT NULL CHECK (unit_price >= 0),
 PRIMARY KEY (order_id, product_id),
 CONSTRAINT fk_c46_item_order FOREIGN KEY (order_id)
  REFERENCES c46_orders(order_id) ON DELETE RESTRICT,
 CONSTRAINT fk_c46_item_product FOREIGN KEY (product_id)
  REFERENCES c46_products(product_id) ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO c46_customers VALUES
 (1,'김민수','서울'),(2,'이서연','부산'),
 (3,'박지우','서울'),(4,'최하늘','대전');
INSERT INTO c46_products VALUES
 (1,'노트','문구',3500,20),(2,'볼펜','문구',1500,50),
 (3,'머그컵','생활',8000,12),(4,'스탠드','생활',25000,5);
INSERT INTO c46_orders
 (order_id,customer_id,ordered_at,status,shipping_fee) VALUES
 (101,1,'2026-01-10 10:00:00','paid',1000),
 (102,1,'2026-01-20 11:00:00','paid',1000),
 (103,2,'2026-02-05 12:00:00','paid',1000),
 (104,3,'2026-02-10 13:00:00','canceled',1000);
INSERT INTO c46_items VALUES
 (101,1,2,3500),(101,2,3,1500),(102,3,1,8000),
 (103,1,1,3500),(103,3,2,8000),(104,2,1,1500);

应有四位客户、四件商品、四张订单和六条明细。原始韩文 UTF-8 字符串保留不变;商品 1~4 分别是笔记本、圆珠笔、马克杯和台灯,客户 1、3 的城市为首尔,2、4 分别为釜山、大田。比较时使用编号,执行时保留字面量。

已有的 shopcourse 授权不会自动涵盖新库。由管理员给已存在的学习账户增加本篇数据库范围的权限:

GRANT ALL PRIVILEGES ON backup46_lab.* TO 'course_user'@'127.0.0.1';

这里的 ALL 仅限这个可丢弃的练习数据库,不是全局权限,也不是给正式备份账户的通用建议。实际账户应根据需要读取的对象、选项及管理流程设计权限;可结合账户身份与最小权限验证核对实际连接。

检查工具版本,并防止覆盖已有备份文件

先确认 mariadb-dump 与 mariadb 位于 PATH 或使用已安装 bin 目录中的完整路径。以下命令在操作系统终端执行,不是在 SQL 提示符执行。先检查两个工具的版本,避免新工具生成的语法被不兼容的旧恢复客户端读取。

mariadb-dump --version
mariadb --version

Windows PowerShell 示例使用 --result-file,让转储工具直接写文件,避免 PowerShell 不同版本的输出重定向编码差异。端口与账户换成实际学习配置;密码仅在提示时输入。

New-Item -ItemType Directory -Path 'C:/mariadb-lab' -Force | Out-Null
$backup46Path='C:/mariadb-lab/backup46-first.sql'
if (Test-Path -LiteralPath $backup46Path) { throw 'Choose a new backup filename.' }
mariadb-dump --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --single-transaction --quick --skip-lock-tables --result-file=C:/mariadb-lab/backup46-first.sql backup46_lab
if ($LASTEXITCODE -ne 0) { throw 'Backup failed: inspect the error and verify the file.' }
Get-Item -LiteralPath $backup46Path | Select-Object Name,Length
Get-FileHash -LiteralPath $backup46Path -Algorithm SHA256

目标文件已存在时会主动停止,要求改用新文件名。命令失败可能留下空文件或部分文件,必须检查错误;文件非零大小或能计算 SHA-256 哈希,仅能证明有这些字节,不能证明内容完整或能够恢复。保留失败文件用于诊断,再用新名称重新备份。

Ubuntu 终端使用下面的 Bash 方案,与 PowerShell 方案二选一。子 shell 把 umask 077 和禁止覆盖的 set -C 限制在本次操作内,不改变后续终端会话的习惯设置。

mkdir -p "$HOME/mariadb-lab"
(
  umask 077
  set -C
  backup_file="$HOME/mariadb-lab/backup46-first.sql"
  if mariadb-dump --protocol=tcp --host=127.0.0.1 --port=3306 \
      --user=course_user --password --default-character-set=utf8mb4 \
      --single-transaction --quick --skip-lock-tables backup46_lab > "$backup_file"; then
    test -s "$backup_file" || exit 1
    sha256sum "$backup_file"
  else
    printf '%s\n' 'Backup failed; preserve the partial file for diagnosis.' >&2
    exit 1
  fi
)

同名目标已存在时重定向会失败,不会覆盖原文件。成功后仍应检查实际输出和错误信息。若遇到 TLS 连接错误,应按官方客户端与服务器 TLS 要求检查版本、证书名称、可信 CA 和必要的客户端证书;备份与恢复客户端也要使用符合要求的选项文件或证书参数,不要惯常关闭校验。

理解一致性快照选项的适用条件

--single-transaction 为 InnoDB 等事务表提供一致性读取基础,但不会把非事务引擎变成事务引擎。备份期间应协调 ALTER、CREATE、DROP、RENAME 和 TRUNCATE 等结构操作,避免破坏快照假设;不能只因命令带这个选项就忽略并发 DDL。

--quick 逐步读取行,避免把整个结果一次缓存在客户端。--skip-lock-tables 在这里明确指定表锁选项,但不代表备份没有锁等待、磁盘、网络或服务器负载影响。需要在实际负载和对象规模下评估,而不是把小样本结果当作生产性能承诺。

命令有意没有加入 --databases,以支持后续恢复到不同名称的空库。即使如此,也应检查实际转储内容有无 CREATE DATABASE、USE 或跨库引用,不能只凭命令形式假定恢复目标必然不会改变。

清点其他对象,并保护备份内容

这个样本没有视图、存储例程、触发器和事件。真实数据库应清点这些对象,检查当前工具版本的选项、权限、DEFINER 以及恢复后的执行身份。需要例程或事件时审查 --routines、--events 等选项,并查看真实输出,不要从选项名称推断全部依赖都已保存。

转储包含结构与业务数据,应按政策设置访问控制、加密、保存期限及异地或独立故障域的副本。仅放在源数据库同一块磁盘上,无法抵御该磁盘损坏;不要把转储放进公开代码仓库或网站目录。复制时可以用 SHA-256 核对字节相同,但还必须实际恢复验证。

恢复验证通过前,保留源库与备份

源库的核对基线是客户四行、商品四行、订单四行、明细六行,已付款商品总额 39000。使用下面的查询记录业务金额;运费和已取消订单不计入该指标,定义与月度销售和客户报表核对一致。

SELECT SUM(i.quantity*i.unit_price) AS paid_goods
FROM backup46_lab.c46_orders o
JOIN backup46_lab.c46_items i ON i.order_id=o.order_id
WHERE o.status='paid';

在独立空库恢复后,比较全部字段、行数、主外键和约束,并用相同查询核对 39000。行数相同却单价或状态不同仍可能是错误恢复;只有合计相同也不能证明每条明细都正确。保留源库和备份,直到恢复验证及保存策略均满足要求,不要在生成文件后自动删除源数据库。