pg_restore

リストアするアーカイブファイル（ディレクトリ書式アーカイブの場合はディレクトリ）の場所を指定します。 指定がない場合は、標準入力が使用されます。

データのみをリストアし、スキーマ（データ定義）はリストアしません。

再作成前にデータベースオブジェクトを整理（削除）します。

リストア前にデータベースを作成します （このオプションがある場合、-dで指定したデータベースは最初のCREATE DATABASEコマンドの発行時にのみ使用されます。 そして、全てのデータはアーカイブ内に記述された名前のデータベースにリストアされます）。

dbnameデータベースに接続し、このデータベースに直接リストアします。

データベースにSQLコマンドを送信中にエラーが発生した場合、処理を終了します。 デフォルトでは、処理を続行し、リストア処理の最後に発生したエラーの数を表示します。

作成するスクリプト（-lを使用した場合はアーカイブの一覧）の出力ファイルを指定します。 デフォルトは標準出力です。

アーカイブの形式を指定します。 pg_restoreは形式を自動認識するので、このオプションは必須ではありません。 指定する値は以下のいずれかになります。

廃止されたオプションで、現在は無視されます。

指定したインデックスの定義のみをリストアします。

pg_restoreのもっとも時間がかかる部分、つまり、データのロード、インデックスの作成、制約の作成部分を複数の同時実行ジョブを使用して実行します。 このオプションは、複数プロセッサマシンで稼働するサーバに大規模なデータベースをリストアする時間を劇的に減らすことができます。

オペレーティングシステムに依存して、各ジョブは1プロセスまたは1スレッドです。 そして別々のサーバへの接続を使用します。

このオプションの最適値はサーバ、クライアント、ネットワークの構成に依存します。 要素にはCPUコア数やディスク構成も含まれます。 試行する最初の値としてサーバのCPUコア数を勧めます。 しかし、多くの場合これより大きな値でもリストア時間を高速化することができます。 当然ながらあまりに大きな値を使用すると、スラッシングのために性能が劣化することになります。

カスタムアーカイブ書式のみがこのオプションをサポートします。 入力ファイルは通常のファイルでなければなりません（例えばパイプはいけません）。 このオプションは、直接データベースサーバに接続するのではなく、スクリプトを生成する場合に無視されます。 また、複数ジョブは--single-transactionオプションといっしょに使用することはできません。

アーカイブの内容を一覧として出力します。 このコマンドが出力する一覧は、-Lオプションに対する入力として使用することができます。 -nや-tなどのフィルタオプションを-lといっしょに使用する場合、一覧出力する項目を制限します。

list-file内で指定したアーカイブ要素のみをリストアします。 また、それらはそのファイルの出現順にリストアされます。 -nや-tなどのフィルタオプションを-Lといっしょに使用する場合、さらにリストアする項目が制限します。

list-fileは通常、事前に行った-l操作の出力を編集して作成されます。 行の移動や削除、または、行の先頭に;を付けてコメントアウトすることが可能です。 後述の例を参照してください。

指定されたスキーマ内のオブジェクトのみをリストアします。 これは特定のテーブルのみをリストアするために-tオプションと組み合わせることができます。

オブジェクトの所有者を元のデータベースに合わせるためのコマンドを出力しません。 デフォルトでは、pg_restoreは、ALTER OWNERまたはSET SESSION AUTHORIZATIONを発行して、作成したスキーマ要素の所有者を設定します。 データベースに最初に接続したのがスーパーユーザ（もしくは、そのスクリプト内の全てのオブジェクトを所有するユーザ）でない場合、これらの文は失敗します。 -Oを付与すると、初期接続に任意のユーザ名を使用できるようになります。ただし、この場合は、全てのオブジェクトの所有者がリストアしたユーザになります。

指定した関数のみをリストアします。 関数や引数の名前は、ダンプファイルの一覧で出力される通りのスペルで正確に入力するよう注意してください。

このオプションは廃止されました。後方互換性を保持するために受け入れられています。

スキーマ（データ定義）のみをリストアし、データ（テーブルの内容）をリストアしません。 シーケンスの現在値はリストアされません。 （"スキーマ"という用語を別の意味で使用する、--schemaオプションと混同しないでください。）

トリガを無効にする場合に使用する、スーパーユーザのユーザ名を指定します。 これは--disable-triggersを使う場合にのみ使用されます。

指定されたテーブルのみについて、定義、データまたはその両方をリストアします。 -nオプションと組み合わせることでスキーマを指定することができます。

指定されたトリガだけをリストアします。

冗長モードを指定します。

pg_restoreのバージョンを表示し、終了します。

アクセス権限（grant/revokeコマンド）のリストアを行いません。

リストアを単一トランザクションとして実行します（つまり発行するコマンドをBEGIN/COMMITで囲みます）。 これにより確実に、すべてのコマンドが完全に成功するか、まったく変更がなされないかのどちらかになります。 このオプションは--exit-on-errorを意味します。

このオプションは、データのみのダンプを作成する際にしか適用されません。 データの再ロード中、pg_restoreに対し、対象テーブル上のトリガを一時的に無効にするコマンドを実行するよう指示します。 このオプションは、データの再ロード中には呼び出したくない参照整合性検査やその他のトリガがある場合に使用します。

現在のところ、--disable-triggersを指定してコマンドを実行するのは、スーパーユーザでなければなりません。 そのため、ユーザは-Sでスーパーユーザを指定するか、あるいはPostgreSQLのスーパーユーザ権限でpg_restoreを実行する必要があります（後者の方がより望ましい方法です）。

デフォルトでは、関連するテーブルの作成に失敗した（たとえば、既に存在するなどの理由により）としてもテーブルデータオブジェクトはリストアされます。 このオプションにより、こうしたテーブルデータは単に無視されるようになります。 これは対象のデータベースに目的のテーブルの中身が含まれている時に便利です。 たとえばPostGISなどのPostgreSQL拡張用の補助テーブルが既に対象のデータベース内に存在する可能性があります。 このオプションを指定すれば、二重ロードや古いデータのロードを防ぐことができます。

このオプションはSQLスクリプト出力を生成する時ではなく、直接データベースにリストアする時にのみ効果的です。

アーカイブにセキュリティラベルが含まれている場合であっても、セキュリティラベルを戻すコマンドを出力しません。

テーブル空間を選択するコマンドを出力しません。 このオプションを付けると、すべてのオブジェクトはリストア時にデフォルトであったテーブル空間内に作成されます。

ALTER OWNERコマンドの代わりに、標準SQLのSET SESSION AUTHORIZATIONコマンドを出力して、オブジェクトの所有権を決定します。 これにより、ダンプの標準への互換性が高まりますが、ダンプ内のオブジェクトの履歴によっては正しくリストアされない可能性が生じます。

pg_restoreコマンドライン引数の使用方法を表示し、終了します。

サーバが稼働しているマシンのホスト名を指定します。 この値がスラッシュから始まる場合、Unixドメインソケット用のディレクトリとして使用されます。 デフォルトは、設定されていればPGHOST環境変数から取得されます。 設定されていなければ、Unixドメインソケット接続と仮定されます。

サーバが接続を監視するTCPポートもしくはローカルUnixドメインソケットファイルの拡張子を指定します。 デフォルトは、設定されている場合、PGPORT環境変数の値となります。設定されていなければ、コンパイル時のデフォルト値となります。

接続ユーザ名です。

パスワードの入力を促しません。 サーバがパスワード認証を必要とし、かつ、.pgpassファイルなどの他の方法が利用できない場合、接続試行は失敗します。 バッチジョブやパスワードを入力するユーザが存在しない場合にこのオプションは有用かもしれません。。

データベースに接続する前に、pg_restoreは強制的にパスワード入力を促します。

サーバがパスワード認証を要求する場合pg_restoreは自動的にパスワード入力を促しますので、これが重要になることはありません。 しかし、pg_restoreは、サーバにパスワードが必要かどうかを判断するための接続試行を無駄に行います。 こうした余計な接続試行を防ぐために-Wの入力が有意となる場合もあります。

リストアを実行する際に使用するロール名を指定します。 このオプションによりpg_restoreはデータベースに接続した後にSET ROLE rolenameコマンドを発行するようになります。 認証に使用したユーザ（-Uで指定されたユーザ）がpg_restoreで必要とされる権限を持たないが、必要な権限を持つロールに切り替えることができる場合に有用です。 一部のインストレーションではスーパーユーザとして直接ログインさせないポリシーを取ることがありますが、このオプションを使用することでポリシーに反することなくリストアを行うことができます。

デフォルトの接続パラメータです。