此页面为机器翻译。请阅读英文原文。 English

备份 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 分钟)而不会失败。

作业类型

单个与分组作业

单个作业针对一个数据库,并拥有自己的设置。将其用于公司主数据库:独立的计划、独立的文件夹、独立的保留策略。

分组作业针对包含数据库的文件夹。一组设置适用于该组的所有数据库。在每个周期中,代理会按掩码重新扫描文件夹,因此新数据库会自动纳入备份,无需更改设置。

单个数据库文件夹中的所有数据库
带检查的 gbakvbackupgrpvbackup
带级别的 nbackupnbackupgrpnbackup
nbackup 转储nbackup_dumpgrpnbackup_dump

分组作业包含什么、跳过什么

代理会遍历文件夹,并根据包含和排除掩码检查每个文件。可选地,它还会检查最小大小和文件开头。备份文件(.fbk、.nbk、.delta、归档)永远不会进入备份。

拥有自己单个作业的数据库会自动从分组中排除,即使该作业已关闭。gbak 分组不会包含单个 gbak 作业的数据库。nbackup 分组不会包含 nbackup 和转储作业的数据库。

系统数据库(名称以 security 和 examples 开头的)始终被跳过。扫描预览会显示每次跳过的原因。

D:\data\ · 掩码 *.fdb

  1. sales.fdb在组中
  2. stock.fdb在组中
  3. branch_new.fdb
    新数据库:从级别 0 开始
    在组中
  4. erp.fdb
    拥有自己的单个作业
    跳过
  5. security5.fdb
    系统数据库
    跳过
  6. bck_sales_20261107.fbk
    备份文件
    跳过
  7. 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/。来自不同文件夹的同名数据库不会互相干扰。
HQ Monitor 中的任务。六种备份类型和清单。Restore 任务位于单独的组中:必须显式允许它们,因为它们会更改数据库。

vbackup · grpvbackup

gbak:带检查的备份

在每个步骤之前,代理都会检查可用空间:用于备份、用于测试还原、用于归档。如果没有足够的空间进行还原,代理会以原因 no_space 跳过它,备份仍然保留。gbak 写入临时文件。只有当大小和 gbak 日志都正确时,该文件才会获得 .fbk 名称。因此,文件夹中绝不会出现名称正常但不完整的备份。

  1. 1空间检查用于备份;在还原和压缩前再次检查
  2. 2gbak写入临时 .gbaktmp;在 Firebird 5 上——使用 N 个核心
  3. 3检查大小和日志;然后命名为 .fbk
  4. 4测试还原如果启用;使用单独的文件,而不是生产数据库
  5. 5压缩解包归档并通过 SHA-256 比较
  6. 6✓ 存储复制到另一个文件夹;旧副本会被删除
gbak 任务表单。带时区提示的计划、备份文件夹和名称、单行中的 gbak 选项、超时和空间计算系数。
  • 清晰的名称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 的副本。

nbackup 一周:周日为级别 0,每晚为级别 1,每天四次为级别 2;还原需要每个级别各一个文件
级别 0 级别 1 级别 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 中的别名来设置。

    客户端

    连接 sales.fdb

    磁盘上的文件

    从关闭到替换期间,客户端会收到“database not found”或“database shutdown”。请将循环安排在数据库可以因备份加还原而不可用的时间段。在管道模式下,备份和还原同时运行,并且不会写入备份文件。

    以下情况下循环不会启动

    • 作业中未开启“允许替换”(allow_replace);
    • 数据库处于关闭状态、已加密或是副本;
    • 数据库是安全数据库,无论是其自身还是用于其他数据库;
    • 其旁边存在未完成循环的文件;
    • 磁盘空间不足。

    空间会预先计算:备份文件和还原副本会同时存在于磁盘上,各自大约相当于数据库的大小。原始文件是重命名而非复制,因此不占用空间。如果空间不足,循环会在关闭之前停止:数据库不会被触碰,客户端继续正常工作。

    磁盘上保留的内容

    原始文件。最近几次处于关闭状态的完整原始文件会保留在数据库旁边,数量从 1 到 10,默认为 1。多余的会在下一个循环开始时删除,因此数据库在上一个循环之前的状态始终存在。

    备份文件会在替换后删除。如果还原失败,该文件会保留为 .restore-failed.fbk 以供分析。

    要回到原始文件:停止生产数据库,重命名文件,并对原始文件运行 gfix -online。

    当循环被中断时

    可能有人停止代理、服务器可能重启、可能断电。在替换之前正常停止服务时,代理会让 gbak 完成并回滚循环。对于故障情况,代理会在每个步骤之前将其操作写入意图文件。启动时以及之后每分钟,代理会读取这些文件并将循环恢复到已知状态。

    重命名之前

    数据库恢复为在线

    代理将数据库置为在线并恢复关闭延迟。

    替换之前

    回滚

    中间副本和不完整的备份会被删除,原始文件恢复其旧名称并上线。

    替换之后

    完成

    新数据库继续用于生产,原始文件以关闭状态保留。“之后”脚本未运行:如果重要,请自行运行。

    如果磁盘上的文件与任何已知状态都不匹配,代理不会做任何更改,作业结果会以“operator needed”开头。意图文件列出了所有循环文件的名称。将正确的数据库放到其路径下,代理会自行完成恢复。

    您自己的前后脚本

    “备份前”脚本在关闭之前运行。如果它以错误结束,循环会停止,数据库不会被触碰。“还原后”脚本在替换之后运行。示例:在代理删除备份文件之前将其复制到归档。

    变量备份前还原后
    FBAGENT_HOOK_PHASEprepost
    FBAGENT_JOB_ID作业 ID
    FBAGENT_DB_NAME作业中的名称:别名或路径
    FBAGENT_DB_PATH数据库文件:原始文件,在线相同路径:新数据库,在线
    FBAGENT_ORIG_PATH空原始文件的路径
    FBAGENT_FBK_PATH未来的备份文件;管道模式下为空备份文件,脚本执行后删除;管道模式下为空

    清单 · 健康报告

    控制:哪个数据库没有备份

    清单显示服务器上的所有备份文件,也包括由其他程序创建的备份文件。代理在每次备份后更新它,并每 2 小时完整更新一次。旁边是还原表:测试和生产,为期 14 天。

    每个备份都有一个已验证列:测试还原通过、失败或未运行。旁边是还原后数据库的大小和 gbak 耗时。还原表显示数据库大小和持续时间。

    服务器健康报告会标记没有已注册备份的数据库,并说明原因:作业失败、仍在运行、被推迟,或文件夹中没有文件。发现项旁边的按钮会立即打开新建作业表单。

    清单。每个副本的测试还原失败,您会立即看到。没有自己作业的文件会被标记为 ORPHANED。
    报告中的发现项。“数据库没有备份”:用一个按钮添加 nbackup 或 gbak 作业。

    ← 返回 HQbird 2027 概览