HQbird 备份
备份 Firebird
按计划执行 gbak 和 nbackup,可针对单个数据库,也可针对文件夹中的所有数据库。对于 gbak,您可以在每次备份后开启测试恢复。数据库会从备份自动更新,中途失败也不会使其处于未知状态。
- 6 种备份作业类型
- nbackup 级别 0…4
- zip · gz · zstd 并校验归档
- S3 无需中间文件
- 测试恢复
两种工具
gbak 或 nbackup
HQbird 支持两种 Firebird 备份类型,并且可以对同一个数据库同时使用两者。gbak 生成逻辑副本:它比数据库小,恢复时会对其进行校验。nbackup 复制数据库页面:速度快,增量占用空间小。
| gbak(已验证备份) | nbackup(增量) | |
|---|---|---|
| 复制内容 | 数据和元数据。垃圾数据和旧记录版本不会进入副本。 | 数据库文件的页面。级别 0 为全量;级别 1…N 仅包含已更改的页面。 |
| 大小 | 通常远小于数据库;压缩效果好。 | 级别 0 与数据库大小相同;增量很小。 |
| 恢复 | 创建新数据库并重新构建索引。对于大型数据库,这需要很长时间。 | 合并级别链。速度快。 |
| 检查 | 如果作业中已开启,每次备份后进行测试恢复。 | 通过 GUID 检查链。没有级别 0 时——代理会立即创建。 |
| 适用场景 | 可靠的副本、在版本和服务器之间迁移、备份-恢复-替换。 | 白天频繁的恢复点,且不对服务器造成负载。 |
如果同一数据库的 gbak 和 nbackup 必须在同一分钟启动,gbak 会推迟 15 分钟。当 nbackup 正在使用数据库时,gbak 会等待(默认最多 60 分钟)而不会失败。
作业类型
单个与分组作业
单个作业针对一个数据库,并拥有自己的设置。将其用于公司主数据库:独立的计划、独立的文件夹、独立的保留策略。
分组作业针对包含数据库的文件夹。一组设置适用于该组的所有数据库。在每个周期中,代理会按掩码重新扫描文件夹,因此新数据库会自动纳入备份,无需更改设置。
| 单个数据库 | 文件夹中的所有数据库 | |
|---|---|---|
| 带检查的 gbak | vbackup | grpvbackup |
| 带级别的 nbackup | nbackup | grpnbackup |
| nbackup 转储 | nbackup_dump | grpnbackup_dump |
分组作业包含什么、跳过什么
代理会遍历文件夹,并根据包含和排除掩码检查每个文件。可选地,它还会检查最小大小和文件开头。备份文件(.fbk、.nbk、.delta、归档)永远不会进入备份。
拥有自己单个作业的数据库会自动从分组中排除,即使该作业已关闭。gbak 分组不会包含单个 gbak 作业的数据库。nbackup 分组不会包含 nbackup 和转储作业的数据库。
系统数据库(名称以 security 和 examples 开头的)始终被跳过。扫描预览会显示每次跳过的原因。
D:\data\ · 掩码 *.fdb
- sales.fdb在组中
- stock.fdb在组中
- branch_new.fdb
新数据库:从级别 0 开始在组中 - erp.fdb
拥有自己的单个作业跳过 - security5.fdb
系统数据库跳过 - bck_sales_20261107.fbk
备份文件跳过 - orders.fdb.delta
nbackup 增量文件跳过
- 数据库从文件夹中移除它会变为“孤立”。其备份按规则保留:N 天或始终保留。或者它们立即进入
_orphaned文件夹,并在 7 天后删除。 - 数据库重命名新名称会从级别 0 开始一条新链。旧备份按孤立数据库的规则保留。
- 重复失败连续失败 5 次后,数据库会暂停 6 小时,然后再次尝试。
- 一个数据库中的错误不会停止分组分组会继续处理下一个数据库。这是“出错后继续处理下一个数据库”设置;对于 gbak、nbackup、转储和 sweep 分组,默认开启。
- 作业行中的分组结果“找到 N 个数据库 · 成功 M 个 · 错误 X 个 · 总时间”。详细信息中有一个出错数据库的表格:名称、路径和错误文本的开头。
- 时间预算时间用完后,周期不会启动新的数据库。对于 nbackup 分组,您可以开启在下一个周期从下一个数据库继续。
- 并行度同时处理分组中多少个数据库。服务器上长任务的通用限制:默认情况下,同时运行的不得超过两个。
- 每个数据库只允许一个操作单个任务和组任务、gbak 和 nbackup 会看到彼此的锁。
- 与源相同的文件夹树“重复源文件夹树”复选框:数据库
x/y/EMPLOYEE.FDB的备份会保存到<backup folder>/x/y/EMPLOYEE.FDB/。来自不同文件夹的同名数据库不会互相干扰。
vbackup · grpvbackup
gbak:带检查的备份
在每个步骤之前,代理都会检查可用空间:用于备份、用于测试还原、用于归档。如果没有足够的空间进行还原,代理会以原因 no_space 跳过它,备份仍然保留。gbak 写入临时文件。只有当大小和 gbak 日志都正确时,该文件才会获得 .fbk 名称。因此,文件夹中绝不会出现名称正常但不完整的备份。
- 1空间检查用于备份;在还原和压缩前再次检查
- 2gbak写入临时
.gbaktmp;在 Firebird 5 上——使用 N 个核心 - 3检查大小和日志;然后命名为
.fbk - 4测试还原如果启用;使用单独的文件,而不是生产数据库
- 5压缩解包归档并通过 SHA-256 比较
- 6✓ 存储复制到另一个文件夹;旧副本会被删除
- 清晰的名称
bck_sales_20261107_02-00.fbk:数据库名称的开头和时间。同一文件夹中的两个数据库不会写入相同的名称。 - 重叠警告如果两个任务向同一文件夹写入名称开头相同的文件,代理和编辑器会显示警告。
- 测试还原结果ok、failed、带原因跳过或 not_run。你可以在上次任务结果和清单中看到它。在编辑器中,每次还原都会显示两条命令:备份和还原。
- 旧测试数据库新任务使用
-rep启动测试还原:gbak 会覆盖上一次运行的副本。代理会先断开此副本的客户端。如果测试数据库路径与生产数据库或另一个任务的数据库相同,则跳过还原。 - gbak 日志和命令控制台中可见最后的错误行;你可以下载日志。日志会随其备份一起删除。代理保留运行命令的历史记录:每个任务步骤最多 50 条,密码已隐藏。
- 会破坏检查的开关
-Y将 gbak 输出发送到文件,但代理通过此输出检查备份。因此不允许使用-Y。流式任务在还原行中也不接受-SE。编辑器会标记这些开关。 - 超时软超时:警告。硬超时:停止 gbak。
- 按步骤统计 gbak 时间代理会自行向每个备份和还原添加
-ST TDRW开关,并从输出中获取 gbak 时间。你不需要在任务选项中添加自己的-ST:编辑器不接受它。 - 代理设置登录选项中不允许使用
-user、-password、-fetch_password和-trusted开关。如果数据库所有者记录在数据库访问设置中,测试还原会以数据库所有者身份运行。还原行会显示它以哪个用户名运行。 - 清晰的消息空间和时间使用熟悉的单位:“8.1 GiB free, 11.8 GiB needed”、“timed out after 60 s”。
nbackup · grpnbackup
nbackup:级别和还原点
级别 0 复制整个数据库。级别 1 复制上次级别 0 之后更改的页面。级别 2 复制上次级别 1 之后的更改。要将数据库还原到你需要的时刻,三个文件就足够了。
示例计划:级别 0 每周一次,级别 1 每晚一次,级别 2 每天四次。这样每周有 36 个还原点:1 + 7 + 28。它保留 5 份级别 0、7 份级别 1 和 24 份级别 2 的副本。
- 无缺口的链没有级别 0——代理会立即创建它。对于其他级别,这是“立即创建缺失的低级别”设置。如果没有它,当较低级别缺失时,运行会被跳过。
- 通过 GUID 检查每个级别都绑定到其较低级别;外来文件不会进入链中。
- 三种计划模式简单——按天和小时。高级——为每个级别设置 cron,最高到级别 4。计划——带级别、天和时间的规则。
- nbackup dump级别链之外的数据库文件完整副本,按自己的计划执行。
- 数据库处于 delta 状态如果 nbackup 中断后数据库仍处于锁定状态,代理会尝试合并 delta。
计划模式
计划是一组规则:级别、日期和时间。日期可以是每天、每周的某几天或每月的某几天。如果两条规则在同一分钟匹配,则运行较低级别。当最后一个级别 0 的年龄超过设定的天数时,计划可以自行生成一个级别 0。当增量增长超过数据库大小的设定比例时,它会比计划更早地运行较低级别。在组作业中,每个数据库构建自己的级别链。
编辑器以日历形式展示未来数周的计划:哪个级别在何时运行。一个按钮可将简单或高级计划转换为计划,你可以在保存前撤销此操作。
- 按周期保留一个周期是一个级别 0 及其所有增量。代理保留或删除整个周期:按周期数量、按天数或按总大小。最新的完整周期永远不会被删除。编辑器会提前显示备份将占用多少空间。
- 计划状态每个级别的最后一份副本、已用空间以及下次清理将删除的内容。代理在每次计划运行后更新状态。
压缩 · S3 · 存储
备份的存储位置
备份可以直接发送到 S3:gbak 或 nbackup 写入流,流再发送到存储桶。服务器磁盘上没有中间文件,因此你不需要在服务器上为备份预留空间。
zip、gz 或 zstd 压缩适用于本地备份和流式备份。对于本地备份,代理会解压完成的归档文件,并按大小和 SHA-256 与源文件进行比较。只有在此之后才会删除源文件。如果检查失败,则不会删除任何内容。
- 按数量保留gbak:保留多少个文件。nbackup:每个级别保留多少份副本。
- 复制到其他位置复制到第二个文件夹或网络路径。上传到 S3、FTP 或 FTPS——使用单独的 file_sync 作业。
- 备份后运行你自己的脚本用于 gbak。它会获得备份、测试数据库和 gbak 日志的路径。
- 归档加密gbak 作业可以使用代理密钥中的密码对 zip 归档进行加密(AES-256),无论是在磁盘上还是在 S3 流中。7-Zip 可以打开该归档。恢复时会自动找到正确的密钥。
- 从归档恢复格式根据文件内容检测,无论是本地还是从 S3。
- 从 S3 恢复恢复作业直接从存储桶读取备份。
- 防病毒将备份和恢复文件夹排除在实时扫描之外。
- 你选择压缩方式新作业创建时不启用压缩。zstd 在格式列表中排在首位。你可以为任何格式的归档设置自己的文件扩展名。
- Amazon S3 指南分步设置存储桶、密钥和作业。提供英文和葡萄牙文版本。
Amazon S3 · 兼容存储
备份到 S3
代理将备份发送到 Amazon S3 或兼容存储中的存储桶。这适用于 gbak 和 nbackup 作业。你不需要为此使用其他程序。
设置分为三部分:准备存储桶和访问密钥,在代理设置中创建 s3 目标,在备份作业中开启上传。每个作业使用两种模式之一。
| 文件复制 | 流式传输到 S3 | |
|---|---|---|
| 服务器磁盘上的文件 | 是。备份先写入磁盘,然后发送。 | 否。备份直接发送到存储桶。 |
| 备份所需的磁盘空间 | 需要。 | 不需要。 |
| 目标位置 | S3、FTP、FTPS | 仅 S3 |
| 删除存储桶中的旧副本 | 否。使用存储桶生命周期规则。 | 是,按作业的保留规则。 |
| 上传失败 | 本地备份仍然有效。 | 没有备份:存储桶中不会留下任何对象。 |
- 如何选择文件复制:当你既需要本地副本又需要 S3 中的副本时。流式传输:当服务器磁盘较小或 S3 是唯一的备份位置时。
- 从 S3 恢复恢复作业直接从存储桶读取流式备份:最新的对象或你指定的对象。代理会检查每个对象的大小和 SHA-256。
- 加密存储桶加密在存储端保护对象。作业中的归档加密会在文件离开服务器之前用密码保护它。
- 存储桶保持公共访问被阻止。添加一条规则,在一天后删除未完成的分段上传。
- 仅用于备份的密钥创建一个单独的用户。只授予它所需的权限:写入、读取和删除对象,中止上传以及列出存储桶中未完成的上传。如果存储桶使用 KMS 密钥加密,它还需要对该密钥的权限。在 Amazon EC2 服务器上,你可以不使用密钥:代理使用服务器的 IAM 角色。
- 检查使用“立即运行”按钮启动作业,查看结果,并在依赖备份之前进行一次测试恢复。
常见错误
| 错误 | 原因 | 如何处理 |
|---|---|---|
AccessDenied | 缺少某项权限,或权限中的路径不同。 | 检查用户权限。 |
SignatureDoesNotMatch | 密钥错误,或其值中有空格。 | 重新复制密钥。 |
PermanentRedirect | 设置中的区域与存储桶区域不匹配。 | 修正区域。 |
NoSuchBucket | 存储桶名称错误。 | 修正名称。 |
RequestTimeTooSkewed | 服务器时钟错误。 | 使用 NTP 同步时钟。 |
restore.replace_cycle
备份-恢复-替换
该周期会重建生产数据库。代理进行 gbak 备份,将其恢复到新文件,并将新文件放到旧文件的位置。新数据库没有垃圾,索引是全新的,而且通常小得多。生产数据库会被安全地断开连接并重命名:代理首先将其置于 shutdown full 状态,所有连接关闭,然后文件才会获得新名称。
默认情况下,该循环在周六 02:00 运行;您可以更改计划。立即运行会立刻启动循环,但会先要求您输入数据库文件名。数据库可以通过路径或 databases.conf 中的别名来设置。
客户端
磁盘上的文件
从关闭到替换期间,客户端会收到“database not found”或“database shutdown”。请将循环安排在数据库可以因备份加还原而不可用的时间段。在管道模式下,备份和还原同时运行,并且不会写入备份文件。
以下情况下循环不会启动
- 作业中未开启“允许替换”(allow_replace);
- 数据库处于关闭状态、已加密或是副本;
- 数据库是安全数据库,无论是其自身还是用于其他数据库;
- 其旁边存在未完成循环的文件;
- 磁盘空间不足。
空间会预先计算:备份文件和还原副本会同时存在于磁盘上,各自大约相当于数据库的大小。原始文件是重命名而非复制,因此不占用空间。如果空间不足,循环会在关闭之前停止:数据库不会被触碰,客户端继续正常工作。
磁盘上保留的内容
原始文件。最近几次处于关闭状态的完整原始文件会保留在数据库旁边,数量从 1 到 10,默认为 1。多余的会在下一个循环开始时删除,因此数据库在上一个循环之前的状态始终存在。
备份文件会在替换后删除。如果还原失败,该文件会保留为 .restore-failed.fbk 以供分析。
要回到原始文件:停止生产数据库,重命名文件,并对原始文件运行 gfix -online。
当循环被中断时
可能有人停止代理、服务器可能重启、可能断电。在替换之前正常停止服务时,代理会让 gbak 完成并回滚循环。对于故障情况,代理会在每个步骤之前将其操作写入意图文件。启动时以及之后每分钟,代理会读取这些文件并将循环恢复到已知状态。
数据库恢复为在线
代理将数据库置为在线并恢复关闭延迟。
回滚
中间副本和不完整的备份会被删除,原始文件恢复其旧名称并上线。
完成
新数据库继续用于生产,原始文件以关闭状态保留。“之后”脚本未运行:如果重要,请自行运行。
如果磁盘上的文件与任何已知状态都不匹配,代理不会做任何更改,作业结果会以“operator needed”开头。意图文件列出了所有循环文件的名称。将正确的数据库放到其路径下,代理会自行完成恢复。
您自己的前后脚本
“备份前”脚本在关闭之前运行。如果它以错误结束,循环会停止,数据库不会被触碰。“还原后”脚本在替换之后运行。示例:在代理删除备份文件之前将其复制到归档。
| 变量 | 备份前 | 还原后 |
|---|---|---|
FBAGENT_HOOK_PHASE | pre | post |
FBAGENT_JOB_ID | 作业 ID | |
FBAGENT_DB_NAME | 作业中的名称:别名或路径 | |
FBAGENT_DB_PATH | 数据库文件:原始文件,在线 | 相同路径:新数据库,在线 |
FBAGENT_ORIG_PATH | 空 | 原始文件的路径 |
FBAGENT_FBK_PATH | 未来的备份文件;管道模式下为空 | 备份文件,脚本执行后删除;管道模式下为空 |
清单 · 健康报告
控制:哪个数据库没有备份
清单显示服务器上的所有备份文件,也包括由其他程序创建的备份文件。代理在每次备份后更新它,并每 2 小时完整更新一次。旁边是还原表:测试和生产,为期 14 天。
每个备份都有一个已验证列:测试还原通过、失败或未运行。旁边是还原后数据库的大小和 gbak 耗时。还原表显示数据库大小和持续时间。
服务器健康报告会标记没有已注册备份的数据库,并说明原因:作业失败、仍在运行、被推迟,或文件夹中没有文件。发现项旁边的按钮会立即打开新建作业表单。