pg_recvlogical

新しい論理レプリケーションスロットを--slotで指定した名前で、--pluginの出力プラグインを使い、--dbnameで指定したデータベースに対して作成します。

--slotで指定された名前のレプリケーションスロットを削除して、終了します。

--slotで指定した論理レプリケーションスロットからストリームの変更を開始し、シグナルを受けて終了するまで継続します。 サーバ側の変更ストリームがサーバのシャットダウンまたは接続断によって終了した場合は、--no-loopが指定されていなければ、ループ内でリトライします。

ストリームのフォーマットは、スロットが作成された時に指定された出力プラグインによって決定されます。

接続はスロットの作成時に使用したのと同じデータベースに対してでなければなりません。

受け取り、デコードしたトランザクションデータをこのファイルに書き込みます。 標準出力に出力するには-を使います。

出力ファイルがディスクに安全にフラッシュされることを確実にするため、pg_recvlogicalがfsync()の呼び出しを実行する頻度を指定します。

サーバはクライアントに対して、フラッシュを実行し、またフラッシュ位置をサーバに報告するように、ときどき要求します。 この設定はそれに加えて、フラッシュをより高頻度で実行するものです。

0という間隔を指定すると、fsync()の呼び出しをまったく実行しなくなりますが、それでも状況をサーバに報告はします。 この場合、クラッシュするとデータが失われるかもしれません。

--startモードでは、レプリケーションを指定のLSNから開始します。 この効果の詳細については第46章および項49.3を参照してください。 その他のモードでは無視されます。

サーバへの接続が失われたとき、ループ内でリトライせず、単に終了します。

オプションnameと(指定されていれば)オプション値valueを出力プラグインに渡します。 存在するオプションとその効果は、利用する出力プラグインに依存します。

スロットを作成するとき、指定された論理デコードの出力プラグインを使います。 第46章を参照してください。 このオプションは、スロットが既に存在する時は、何の効果もありません。

このオプションはpg_receivexlogの同じ名前のオプションと同じ効果があります。 そちらの説明を参照してください。

--startモードでは、slot_nameという名前の既存の論理レプリケーションスロットを使います。 --create-slotでは、この名前のスロットを作成します。 --drop-slotモードでは、この名前のスロットを削除します。

冗長モードを有効にします。

接続するデータベースです。 この意味の詳細は動作の説明を参照してください。 libpqの接続文字列とすることもできます。 詳細は項31.1.1を参照してください。 デフォルトはユーザ名です。

サーバが動作しているマシンのホスト名を指定します。 値がスラッシュで始まるときは、Unixドメインソケットのディレクトリとみなされます。 デフォルト値は、環境変数PGHOSTが設定されていればそれが使用され、設定されていなければUnixドメインソケット接続を試みます。

サーバが接続を監視しているTCPポート番号またはローカルのUnixドメインソケットのファイル拡張子を指定します。 デフォルトは環境変数PGPORTが設定されていればそれを使用し、そうでなければコンパイル時に設定されたデフォルト値です。

接続で使用するユーザ名です。 デフォルトは現在のOSのユーザ名です。

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

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

サーバがパスワード認証を要求する場合、pg_recvlogicalは自動的にパスワード入力を促しますから、このオプションは本質的ではありません。 しかし、サーバがパスワードを必要とすることを確認するためにpg_recvlogicalが無駄な接続試行を行うことになります。 無駄な接続試行を避けるために-Wを指定するのが有効になる場合もあるでしょう。

pg_recvlogicalのバージョンを出力して、終了します。

pg_recvlogicalのコマンド行引数に関するヘルプを表示して、終了します。