HQbirdのバックアップ
バックアップ Firebird
スケジュールされた gbak と nbackup を、1 つのデータベースにもフォルダ内のすべてのデータベースにも。gbak では、各バックアップ後のテスト復元を有効にできます。データベースはバックアップから自動的に更新され、途中で失敗しても不明な状態のまま残ることはありません。
- 6 種類のバックアップジョブ
- nbackup レベル 0…4
- zip · gz · zstd アーカイブチェック付き
- S3 中間ファイルなし
- テスト復元
2 つのツール
gbak または nbackup
HQbird は両方の Firebird バックアップタイプをサポートしており、1 つのデータベースに両方を使用できます。gbak は論理コピーを作成します。データベースより小さく、復元によって検証されます。nbackup はデータベースのページをコピーします。高速で、増分はわずかな容量しか取りません。
| gbak(検証済みバックアップ) | nbackup(増分) | |
|---|---|---|
| コピーする内容 | データとメタデータ。ガベージや古いレコードバージョンはコピーに含まれません。 | データベースファイルのページ。レベル 0 は完全、レベル 1…N は変更されたページのみを含みます。 |
| サイズ | 通常、データベースよりはるかに小さく、圧縮効率も良好です。 | レベル 0 はデータベースのサイズ、増分は小さくなります。 |
| 復元 | 新しいデータベースを作成し、インデックスを再構築します。大規模なデータベースでは時間がかかります。 | レベルのチェーンをマージします。高速です。 |
| チェック | ジョブで有効になっていれば、各バックアップ後のテスト復元。 | GUID によるチェーンチェック。レベル 0 がない場合は、エージェントがすぐに作成します。 |
| 用途 | 信頼性の高いコピー、バージョンやサーバー間の移動、Backup-Restore-Replace。 | サーバーに負荷をかけずに、日中に頻繁な復元ポイントを取得。 |
1 つのデータベースの gbak と nbackup が同じ分に開始する必要がある場合、gbak は 15 分後に移動します。nbackup がデータベースを使用している間、gbak は待機し(デフォルトで最大 60 分)、失敗しません。
ジョブタイプ
個別ジョブとグループジョブ
個別ジョブは 1 つのデータベースを対象とし、独自の設定を持ちます。主要な会社のデータベースにはこれを使用します。独自のスケジュール、独自のフォルダ、独自の保持期間を持ちます。
グループジョブはデータベースを含むフォルダを対象とします。グループ内のすべてのデータベースに 1 つの設定セットを適用します。各サイクルで、エージェントはマスクによってフォルダを再度スキャンするため、新しいデータベースは設定を変更することなく自動的にバックアップに含まれます。
| 1 つのデータベース | フォルダ内のすべてのデータベース | |
|---|---|---|
| チェック付き gbak | vbackup | grpvbackup |
| レベル付き nbackup | nbackup | grpnbackup |
| nbackup ダンプ | nbackup_dump | grpnbackup_dump |
グループジョブが取得するものとスキップするもの
エージェントはフォルダを走査し、各ファイルをインクルードマスクとエクスクルードマスクに対してチェックします。オプションで、最小サイズとファイルの先頭もチェックします。バックアップファイル(.fbk、.nbk、.delta、アーカイブ)はバックアップに含まれません。
独自の個別ジョブを持つデータベースは、そのジョブがオフであっても、グループから自動的に除外されます。gbak グループは個別 gbak ジョブのデータベースを取得しません。nbackup グループは nbackup およびダンプジョブのデータベースを取得しません。
システムデータベース(security や examples で始まる名前)は常にスキップされます。スキャンプレビューには、各スキップの理由が表示されます。
D:\data\ · mask *.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 時間一時停止され、その後再試行されます。
- 1 つのデータベースのエラーはグループを停止しませんグループは次のデータベースに進みます。これは「エラー後に次のデータベースを続行する」設定で、gbak、nbackup、ダンプ、スイープグループではデフォルトで有効です。
- ジョブ行のグループ結果「N 個のデータベースを検出 · M 個成功 · X 個エラー · 合計時間」。詳細にはエラーが発生したデータベースの表があります: 名前、パス、エラーテキストの先頭。
- 時間予算時間が過ぎると、サイクルは新しいデータベースを開始しません。nbackup グループでは、次のサイクルで次のデータベースからの継続を有効にできます。
- 並列処理グループのデータベースを同時に処理する数。サーバー上の長時間タスクの共通制限: デフォルトでは、同時に実行されるのは 2 つまでです。
- データベースごとに1操作個別ジョブとグループジョブ、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:データベース名の先頭部分と時刻。同じフォルダ内の2つのデータベースが同じ名前を書き込むことはありません。 - 重複の警告2つのジョブが同じ名前で始まるファイルを1つのフォルダに書き込む場合、エージェントとエディタが警告を表示します。
- テストリストアの結果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 空き、11.8 GiB 必要」、「60 秒後にタイムアウト」。
nbackup · grpnbackup
nbackup: レベルとリストアポイント
レベル 0 はデータベース全体をコピーします。レベル 1 は最後のレベル 0 以降に変更されたページをコピーします。レベル 2 は最後のレベル 1 以降の変更をコピーします。データベースを必要な時点にリストアするには、3つのファイルで十分です。
スケジュール例:レベル 0 を週に1回、レベル 1 を毎晩、レベル 2 を1日4回。これにより週あたり36のリストアポイントが得られます:1 + 7 + 28。レベル 0 のコピーを5つ、レベル 1 を7つ、レベル 2 を24保持します。
- ギャップのないチェーンレベル 0 がない場合、エージェントはすぐに作成します。他のレベルでは、これが「不足している下位レベルを即座に作成する」設定です。この設定がない場合、下位レベルが不足している間は実行がスキップされます。
- GUID によるチェック各レベルは下位レベルに紐付けられており、外部のファイルがチェーンに入り込むことはありません。
- 3つのスケジュールモードシンプル — 日と時間で指定。詳細 — 各レベルの cron、最大レベル 4 まで。プラン — レベル、日、時間によるルール。
- nbackup ダンプレベルチェーンとは別に、独自のスケジュールでデータベースファイルの完全なコピーを作成します。
- デルタ状態のデータベースnbackup が中断された後もデータベースがロックされたままの場合、エージェントはデルタのマージを試みます。
プランモード
プランとは、レベル、曜日、時刻のルールの集合です。曜日は毎日、曜日指定、または月の日付指定が可能です。同じ分に 2 つのルールが一致した場合、低いレベルが実行されます。プランは、最後のレベル 0 が設定した日数より古くなると、自動的にレベル 0 を実行できます。インクリメントがデータベースサイズの設定割合を超えて増加すると、スケジュールより早く低いレベルを実行します。グループジョブでは、各データベースが独自のレベルチェーンを構築します。
エディタは数週間先までのプランをカレンダーで表示します。どのレベルがいつ実行されるかを確認できます。1 つのボタンでシンプルまたは詳細スケジュールをプランに変換でき、保存前に元に戻すことができます。
- サイクルによる保持サイクルとは、レベル 0 とそのすべてのインクリメントです。エージェントはサイクル全体を保持または削除します。サイクル数、日数、または合計サイズで指定できます。最新の完全なサイクルは決して削除されません。エディタはバックアップが使用する容量を事前に表示します。
- プランの状態各レベルの最新コピー、使用済み容量、次回のクリーンアップで削除される内容。エージェントはプラン実行後に状態を更新します。
圧縮 · S3 · ストレージ
バックアップの保存先
バックアップは S3 に直接送信できます。gbak または nbackup がストリームに書き込み、そのストリームがバケットに送られます。サーバーディスク上に中間ファイルは作成されないため、サーバー上にバックアップ用のスペースは不要です。
zip、gz、zstd 圧縮はローカルバックアップとストリーミングバックアップの両方で機能します。ローカルバックアップでは、エージェントが完成したアーカイブを展開し、サイズと SHA-256 でソースと比較します。その後にのみソースファイルが削除されます。チェックに失敗した場合、何も削除されません。
- 件数による保持gbak: 保持するファイル数。nbackup: 各レベルのコピー数。
- 他の場所へのコピー2 番目のフォルダまたはネットワークパスへのコピー。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 ジョブの両方で機能します。別のプログラムは必要ありません。
設定は 3 つの部分からなります。バケットとアクセスキーを準備し、エージェント設定で s3 ターゲットを作成し、バックアップジョブでアップロードを有効にします。各ジョブは 2 つのモードのいずれかを使用します。
| ファイルコピー | S3 へのストリーム | |
|---|---|---|
| サーバーディスク上のファイル | あり。バックアップはディスクに書き込まれてから送信されます。 | なし。バックアップはバケットに直接送られます。 |
| バックアップ用のディスク容量 | 必要。 | 不要。 |
| 送信先 | S3、FTP、FTPS | S3 のみ |
| バケット内の古いコピーの削除 | なし。バケットのライフサイクルルールを使用してください。 | あり。ジョブの保持ルールによります。 |
| アップロードの失敗 | ローカルバックアップは有効なまま残ります。 | バックアップなし: バケットにオブジェクトは残りません。 |
- 選び方ファイルコピー: ローカルコピーと S3 のコピーの両方が必要な場合。ストリーム: サーバーディスクが小さい場合、または S3 がバックアップの唯一の保存先である場合。
- S3 からのリストアリストアジョブは、ストリーミングされたバックアップをバケットから直接読み取ります。最新のオブジェクト、または指定したオブジェクトを対象にできます。エージェントは各オブジェクトのサイズと SHA-256 を確認します。
- 暗号化バケットの暗号化はストレージ側でオブジェクトを保護します。ジョブのアーカイブ暗号化は、ファイルがサーバーを離れる前にパスワードで保護します。
- バケットパブリックアクセスはブロックしたままにしてください。未完了のマルチパートアップロードを 1 日後に削除するルールを追加してください。
- バックアップ専用のキー専用のユーザーを作成してください。必要な権限のみを付与します。オブジェクトの書き込み、読み取り、削除、アップロードの中止、バケットの未完了アップロードの一覧表示です。バケットが KMS キーで暗号化されている場合は、そのキーに対する権限も必要です。Amazon EC2 サーバーでは、キーなしで運用できます。エージェントがサーバーの IAM ロールを使用します。
- 確認「今すぐ実行」ボタンでジョブを開始し、結果を確認し、バックアップに依存する前にテストリストアを行ってください。
よくあるエラー
| エラー | 原因 | 対処方法 |
|---|---|---|
AccessDenied | 権限が不足しているか、権限内のパスが異なります。 | ユーザー権限を確認してください。 |
SignatureDoesNotMatch | キーが間違っているか、値にスペースが含まれています。 | キーを再度コピーしてください。 |
PermanentRedirect | 設定のリージョンがバケットのリージョンと一致しません。 | リージョンを修正してください。 |
NoSuchBucket | バケット名が間違っています。 | 名前を修正してください。 |
RequestTimeTooSkewed | サーバーの時計がずれています。 | NTP で時計を同期してください。 |
restore.replace_cycle
バックアップ-リストア-置換
このサイクルは本番データベースを再構築します。エージェントは gbak バックアップを作成し、新しいファイルにリストアして、新しいファイルを古いファイルの場所に配置します。新しいデータベースにはガベージがなく、インデックスも新しく、通常は大幅に小さくなります。本番データベースは安全に切断および名前変更されます。エージェントはまずシャットダウン full 状態にし、すべての接続が閉じてから、ファイルに新しい名前を付けます。
デフォルトでは、サイクルは土曜日の 02:00 に実行されます。スケジュールは変更できます。今すぐ実行 はサイクルをすぐに開始しますが、その前にデータベースファイル名の入力を求めます。データベースはパスまたは databases.conf のエイリアスで指定できます。
クライアント
ディスク上のファイル
シャットダウンから置き換えまでの間、クライアントには「database not found」または「database shutdown」が返されます。サイクルは、バックアップとリストアに要する時間だけデータベースが利用不可になっても問題ない時間帯にスケジュールしてください。パイプモードでは、バックアップとリストアが同時に実行され、バックアップファイルは書き出されません。
次の場合、サイクルは開始されません
- ジョブで「置き換えを許可」(allow_replace) がオンになっていない場合。
- データベースがシャットダウン中、暗号化されている、またはレプリカである場合。
- データベースがセキュリティデータベース(自身のもの、または他のデータベース用)である場合。
- 未完了のサイクルのファイルがその隣にある場合。
- 十分なディスク容量がない場合。
容量は事前に計算されます。バックアップファイルとリストアされたコピーが同時にディスク上に存在し、それぞれデータベースとほぼ同じサイズになります。元のファイルはコピーではなく名前変更されるため、容量を消費しません。容量が不足している場合、サイクルはシャットダウン前に停止します。データベースには手を加えず、クライアントは作業を続けられます。
ディスク上に残るもの
元のファイル。シャットダウン状態の最新の元ファイルがデータベースの隣に保持されます。1〜10 個で、デフォルトは 1 個です。余分なものは次のサイクルの開始時に削除されるため、最後のサイクル前の状態のデータベースは常に存在します。
バックアップファイルは置き換え後に削除されます。リストアが失敗した場合、ファイルは分析用に .restore-failed.fbk として保持されます。
元の状態に戻すには:本番データベースを停止し、ファイルの名前を変更して、元のファイルに対して gfix -online を実行します。
サイクルが中断された場合
エージェントが停止されたり、サーバーが再起動したり、電源障害が発生したりする可能性があります。置き換え前の正常なサービス停止では、エージェントは gbak を完了させてからサイクルをロールバックします。障害が発生した場合に備えて、エージェントは各ステップの前に、実行内容をインテントファイルに書き込みます。起動時およびその後 1 分ごとに、エージェントはこれらのファイルを読み取り、サイクルを既知の状態に戻します。
データベースがオンラインに戻る
エージェントはデータベースをオンラインに戻し、シャットダウン遅延を復元します。
ロールバック
中間コピーと不完全なバックアップが削除され、元のファイルは元の名前を取り戻してオンラインになります。
完了
新しいデータベースが本番環境に残り、元のファイルはシャットダウン状態で保持されます。「after」スクリプトは実行されていません。重要な場合はご自身で実行してください。
ディスク上のファイルが既知のどの状態とも一致しない場合、エージェントは何も変更せず、ジョブの結果は「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 の時間があります。リストアテーブルには、データベースのサイズと所要時間が表示されます。
サーバーヘルスレポートは、登録されたバックアップがないデータベースに印を付け、その理由を示します。ジョブが失敗した、まだ実行中、延期された、またはフォルダにファイルがない、などです。検出結果の隣のボタンを押すと、新しいジョブのフォームがすぐに開きます。