gbak-クラウドでのオンライン

プログラム：

NAME

gbak —Firebirdデータベースのバックアップ/復元

SYNOPSIS

ギバク -b [バックアップオプション...] [共通オプション...] source ターゲット

ギバク -c | -r [復元オプション...] [共通オプション...] source ターゲット

DESCRIPTION

ギバク Firebirdデータベースのバックアップと復元を管理するためのツールです。

バックアップモードの場合 source は既存のデータベースパス（サーバー名を含む場合があります）であり、 ターゲット is
バックアップファイル名。 / dev / stdout（リダイレクトするため）のような特別なデバイス名にすることもできます
データをSTDOUTにバックアップ）または/ dev / stを使用して、バックアップをテープに保存します。

復元モードの場合 source 既存のバックアップファイル（または/ dev / stdinのような特別なデバイス
STDINまたは/ dev / st（テープからバックアップを取得する場合）および ターゲット Firebirdデータベースへのパスであり、
サーバー名が含まれる場合があります。

すべてのオプションは省略できます。 オプションのフルバージョンと最短の両方の下
可能なバージョンが示されています。

COMMON OPTIONS

-ユーザー ユーザ名
データベースに接続するときに使用するユーザー名。 環境変数をオーバーライドします。 見る
ENVIRONMENT.

-役割] 役割名
データベースに接続するときに使用するSQLロール。 環境変数をオーバーライドします。 見る
ENVIRONMENT.

-パスワード] password
データベースに接続するときに使用するパスワード。 環境変数をオーバーライドします。 見る
ENVIRONMENT.

-サービス]
データベースと通信するときは、サービスマネージャーを使用します。

-確認]
各アクションを報告します。

処理されているメタデータ、処理されているテーブルに関する詳細情報を表示します
バックアップ/復元および処理されるレコードの数。

-y path
ステータス/エラーメッセージを指定されたパスにリダイレクトします。

-z
他の作業を行う前に、完全なバージョン番号を報告してください。

BACKUP OPTIONS

-b [ackup_database]
バックアップモードをオンにします。

-変換]
外部テーブルをテーブルに変換します。

通常、外部テーブルはバックアップおよび復元中に無視されます。 と -変換 オプション
外部テーブルは、他の通常のテーブルと同様にバックアップに含まれます。 そのようなバックアップのとき
が復元されると、これらの以前の外部テーブルは通常のテーブルとして作成されます。

-要素] NUM
ブロッキングファクター。 出力はのブロックに書き込まれます NUM バイト。 にバックアップするときに便利です
テープ。

-g [arbage_collect]
ガベージコレクションを禁止します。

通常、Firebirdは、テーブルを読み取るときにガベージコレクターを実行します。 以来
バックアッププロセスはすべてのテーブルを読み取ります。これにより、データベース全体のガベージコレクションが強制されます。
既存のデータベースに復元するためだけにバックアップを作成する場合は、このガベージ
収集は不要です。 このオプションを使用するもうXNUMXつの理由は、ガベージコレクションの場合です。
gfixまたは自動スイープのいずれかを使用して、他の手段で使用されます。 このスイッチを使用する
バックアッププロセスをスピードアップし、破損したバックアップの場合にも役立ちます
データベース。

-無視]
チェックサムが不良なレコードは無視してください。

このオプションは、破損したデータベースをバックアップする場合にのみ使用してください。

-l [imbo]
辺獄のトランザクションを無視します。

このスイッチにより、バックアッププロセスはリンボ状態のトランザクションを無視します。

-m [etadata_only]
バックアップメタデータのみ。

このオプションを使用すると、メタデータのみがバックアップに書き込まれます。 これにはすべてが含まれます
テーブル/ビュー/トリガー/インデックス/ストアドプロシージャ/ドメイン/ジェネレーターなど。テーブルデータはありません。
バックアップに含まれています。 このようなバックアップは、データベースの「空の」コピーを作成するのに役立ちます。

-nt
転送不可能なバックアップ形式を使用してください。

デフォルトでは、「トランスポータブル」バックアップ形式が使用されます。 これは、データベースをバックアップできることを意味します
リトルエンディアンのマシンで復元し、ビッグエンディアンのマシンで復元します。その逆も同様です。 を使用して -nt
バックアップは、同じ「エンディアン」を持つマシンでのみ役立ちます。

-ol [d_descriptions]
古いスタイルのメタデータの説明を保存する

リストア OPTIONS

-c [reate_database]
復元モードをオンにします。

ターゲット データベースが作成されますが、まだ存在していてはなりません。

-r [ecreate_database] [o [verwrite]]
いいね -データベースの作成、ただし追加することにより 上書きする ターゲットの交換を強制することができます
データベース。

-rep [lace_database]
いいね -データベースの作成、ただし、ターゲットが存在する場合は上書きされます。

-bu [ffers] NUM
ターゲットデータベースを作成するときは、に保存されているデータベースバッファに関する情報を無視してください。
指定された数のバッファをバックアップして使用します。

-拡大]
通常、Firebirdは、文字列をディスクに保存するときにRLE圧縮を使用します。 このオプション
この圧縮をオフにします。

-非活性]
非アクティブ状態のインデックスを復元します。 これは、データを含むバックアップを復元するために使用できます
外部キー/一意の制約と矛盾しています。

-殺す]
復元時にシャドウを作成しないでください。

通常、データベースシャドウは復元中に作成されます。 このオプションはこれを禁止します。

-モード] アクセス
与えられたデータベースを復元する アクセス.

の有効な値 アクセス 　 読み取り専用 と 読み書き。 デフォルトでは、データベースを復元します
元のアクセスモードで。

-n [o_validity]
有効性の制約なしにデータベースを復元します。 これには、外部キー、一意、および
制約を確認してください。 一貫性のないデータを含むバックアップの復元に役立ちます。

-一つずつ]
各テーブルを復元した後、トランザクションの復元をコミットします。

-ページサイズ] NUM
バックアップに保存されているページサイズを上書きします。 の有効な値 NUM 1024、2048、4096、8192、
16384と32768。

-use_ [all_space]
通常、Fireburdは、さらに使用するために各データページにいくらかのスペースを予約します。 これは予約済み
スペースは、新しく挿入されたデータと古いバージョンのデータを保持するために使用されます。 持っている
この目的のためにデータの「近く」に予約されたスペースは、変更を高速化します。 の場合
データベースは主に読み取り操作に使用され、 -use_all_space いくつかを節約します
スペース。

このオプションは、読み取り専用であるため、読み取り専用データベースを復元する場合に特に便利です。
データベースには、バックバージョン用の追加スペースは必要ありません。

-fix_fss_metadata 文字セット
メタデータを復元するときに、UTF8が有効でない場合は、指定されたものから変換してみてください
キャラクターセット。 一部の国の非UTF8で表の説明が示されている場合に便利です
バージョン2.5より前のFirebirdで可能だったエンコーディング

-fix_fss_data 文字セット
テーブルデータを復元するとき、UNICODE_FSS文字セットで定義された列の場合
有効なUTF8が含まれていません（2.5より前のバージョンのFirebirdで可能でした）。
指定された文字セットからデータを変換します。

復元 に 複数ファイル DATABASE

以前は、Firebirdは64ビットファイルポインタを処理できなかったため、制限がありました
データベースを（約）データベースあたり2GBのサイズにします。

2GBは何年もの間データの多くではないので、データベースを広めるためのメカニズムがあります
複数のファイルに。 このようにして、すべてのデータを含む複数の2GBファイルを作成できます。

複数ファイルデータベースに復元する場合、ターゲット引数は次の形式になります。 ファイル_1 ページ_1
ファイル_2 ページ_2 ... ファイル_N-1 ページ_N-1 ファイル_N

各 ページ_n 最大で何ページ入れるかを指定します ファイル_n。 リストの最後は
ページ制限のないファイル名-収まらないすべてのページが含まれます ファイル_N-1。 ご了承ください
ページ_n バイトではなくページで測定されるため、可能な最大数はページによって異なります
サイズ。

32ビットのファイルポインタのみをサポートするファイルシステム（または古いOS）があるとします。
安全にプレイするために、データベースを2GBのファイルに分割することにしました。 のページサイズの場合
データベースが8192の場合、各ファイルは最大2 * 1024 * 1024 * 1024/8192 = 262144ページを持つことができます。

注意
最近のOSおよびファイルシステムでは、Firebirdは64ビットファイルポインタレンダリングを使用できることに注意してください
マルチファイルデータベースは不要です。

ENVIRONMENT

他のすべてのFirebirdユーティリティと同様に、gbakは次の環境変数を受け入れます。

ISC_USERのデフォルト値 -ユーザー オプション

ISC_ROLEのデフォルト値 -役割 オプション

ISC_パスワード
のデフォルト値 -パスワード オプション

例

すべての例で -ユーザー, -役割 と -パスワード わかりやすくするために、オプションは省略されています。 実際には
それら（または対応する環境変数）を使用する必要があります。

ここで使用されているファイル名拡張子は推奨されているだけであることに注意してください。 統合された拡張機能の使用
スキームは、拡張子を見ただけでファイルタイプを推測するのに役立ちます。

一般的に使用される拡張機能は次のとおりです。

.fdbFirebirdデータベース

.gdb Firebirdデータベース、FirebirdがInterbaseであった時代からのレガシー拡張。
gdbは、実際には、作成した会社にちなんで名付けられたGrottonデータベースから取得されます。
1984年のソフトウェア。

.fdb.2マルチファイルデータベースのXNUMX番目のファイル

.fdb.3マルチファイルデータベースのXNUMX番目のファイル

.fdb。N N-マルチファイルデータベースの-番目のファイル

.fbkFirebirdバックアップファイル

.gbkバックアップファイルのレガシー拡張子

.fbk.gzGzip圧縮されたバックアップファイル

バックアップ a データベース に a 圧縮された フォーマット：
gbak -b db-srv：/database.fdb / dev / stdout | gzip> /file.fbk.gz

リストア a データベース に 新製品 ファイル名：
zcat /file.fbk.gz | gbak -c / dev / stdin db-srv：/new-database.fdb

onworks.netサービスを使用してgbakをオンラインで使用する