Connection pooling#

クライアント全体でバックエンド接続を再利用するように接続プーリングを構成し、サーバーメモリのオーバーヘッドを削減し、多くの短期間のセッションを含むワークロードのスループットを向上させます。 Connection Managerのビルトインプーリングにより、ほとんどの展開でpgBouncerなどの外部ツールの必要性がなくなります。

DBAセットアップと移行ガイダンスについては Configuring connection pooling を、開発者ガイダンスについては Using connection pooling in your application を参照してください。

プールモードの構成#

bdr.alter_node_group_option を使用してノードグループのプールモードを設定します。

SELECT bdr.alter_node_group_option(mygroup, server_pool_mode, transaction);

またはPGD CLIを使用して

pgd group mygroup set-option server_pool_mode transaction

server_pool_mode グループオプションは、プーリング動作を制御します。

Mode	Behavior
none	プーリングはありません。各クライアント接続は、その有効期間全体にわたって専用のバックエンド接続を取得します。クライアントが切断すると、バックエンド接続が閉じます。このモードはデフォルトです。
session	バックエンド接続は、最初に使用するときにクライアントに割り当てられ、クライアントが切断するとプールに返されます。接続マネージャーは、再利用のために接続を返し、セッション状態をリセットする前に pg_upgrade を実行します。
transaction	バックエンド接続は、トランザクションの開始時に割り当てられ、トランザクションが終了するとプールに返されます。トランザクション間では、クライアントはバックエンド接続を保持しないため、他のクライアントが利用できるようにします。再利用のために接続を返す前に、接続マネージャーは`server_reset_mode`グループオプションに従ってそれをクリーンアップし、次のトランザクションにクライアントがサポートされている接続パラメーターを再適用します。リセットモードの構成を参照してください。

現在のプールモードは、 bdr.node_group_summary ビューのserver_pool_mode 列に表示されます。

リセットモードの構成#

ノードグループのリセットモードを設定して、接続マネージャーがプールされたバックエンド接続を再利用のためにプールに返す前にクリーンアップする方法を制御します。このオプションはtransaction プールモードでのみ有効です。 session モードのクリーンアップ動作については、プールモードの構成を参照してください。

クリーンアップがないと、バックエンド接続は、オープントランザクション、プリペアドステートメント、SET 値、一時テーブル、またはアドバイザリロックなど、それを使用したクライアントが残したセッション状態を引き継ぐ場合があります。

bdr.alter_node_group_option を使用します。

SELECT bdr.alter_node_group_option(mygroup, server_reset_mode, <value>);

または、 PGD CLIを使用します。

pgd group mygroup set-option server_reset_mode <value>

server_reset_mode オプションは2つの値を受け入れます。現在のリセットモードは、 bdr.node_group_summary ビューのserver_reset_mode 列に表示されます。

Value	Behavior
discard_all	接続マネージャーは、再利用のために接続を返し、セッション状態をリセットする前に`DISCARD ALL`を実行します。この値はデフォルトです。
fast	接続マネージャーは、実際に必要な場合を除き、クリーンアップをスキップします。クライアントがトランザクションを開いたままにしている場合、接続マネージャーはそれをロールバックします。バックエンドでキャッシュされたプリペアドステートメントの数が`server_max_prepared_statements`グループオプションを超える場合、Connection Managerは`DEALLOCATE ALL`を実行します。それ以外の場合、接続はすぐにプールに戻り、クリーンアップクエリーはまったくありません。セッションレベルの`SET`値のリセット、アドバイザリーロックのリリース、または一時テーブルのクリーンアップは行わないため、あるクライアントのトランザクションによって残された状態は、次にそのバックエンド接続が割り当てられるクライアントのトランザクションから可視できます。

Value

Behavior

discard_all

接続マネージャーは、再利用のために接続を返し、セッション状態をリセットする前に`DISCARD ALL`を実行します。この値はデフォルトです。

fast

接続マネージャーは、実際に必要な場合を除き、クリーンアップをスキップします。クライアントがトランザクションを開いたままにしている場合、接続マネージャーはそれをロールバックします。バックエンドでキャッシュされたプリペアドステートメントの数が`server_max_prepared_statements`グループオプションを超える場合、Connection Managerは`DEALLOCATE ALL`を実行します。それ以外の場合、接続はすぐにプールに戻り、クリーンアップクエリーはまったくありません。セッションレベルの`SET`値のリセット、アドバイザリーロックのリリース、または一時テーブルのクリーンアップは行わないため、あるクライアントのトランザクションによって残された状態は、次にそのバックエンド接続が割り当てられるクライアントのトランザクションから可視できます。

fast は、 discard_all のクリーンアップ保証と引き換えに、すべてのトランザクションの後に実行するのではなくリセットクエリをスキップする PgBouncer's transaction pooling default と同じアプローチに従います。未サポートの機能にリストされている機能を既に回避しているアプリケーションにのみ有効にします。

セッションパラメーターの管理#

接続マネージャーは、すべてのプールモードでバックエンドに特定の接続パラメーターのセットを転送します。認識するパラメーターはclient_encoding 、DateStyle 、TimeZone 、standard_conforming_strings 、application_name 、search_path 、およびextra_float_digits です。 -c name=value 構文を使用して、options 接続パラメーターを介して追加パラメーターを含めることができます。

トランザクション間でバックエンド接続が変更される可能性があるtransaction モードでは、接続マネージャーは新しいバックエンドを割り当てるたびにこれらのパラメーターを再適用します。接続パラメーターのみが再適用されるため、 SET コマンドを使用してトランザクションモードでセッションパラメーターを構成することは避けてください。 SET で行われた変更は、バックエンド接続が変更されたときに保持されません。接続文字列の例については、 Using connection pooling in your application を参照してください。

準備されたステートメントを使用する#

拡張クエリプロトコルを介して送信されるプリペアドステートメントは、すべてのプールモードのトランザクションにわたってシームレスに動作します。接続マネージャーは、バックエンドで欠落しているプリペアドステートメントを自動的に検出し、オンデマンドで再準備し、クライアントとバックエンド間でステートメントの名前付けを透過的に管理します。

デフォルトのdiscard_all リセットモードを使用するtransaction モードでは、各トランザクションの最後にバックエンド接続がプールに返されたときにDISCARD ALL が実行され、PREPARE /EXECUTE SQLステートメントで作成されたプリペアドステートメントの割り当てが解除されます。 fast リセットモードでは、 PREPARE / EXECUTE で作成されたプリペアドステートメントは、それを作成したトランザクションを超えてバックエンドで生き残ることができますが、その同じバックエンド接続を使用する次のトランザクションは同じクライアントからであることが保証されていないため、それに依存するまだ存在するのは安全ではありません。いずれの場合も、 PREPARE /EXECUTE SQLステートメントを使用するトランザクション内で発行するか、代わりに拡張照会プロトコルを使用します。具体的な手順については、開発者ガイドの準備されたステートメントを使用するを参照してください。

接続の再利用#

session およびtransaction モードでは、クライアントが切断されるか、トランザクションが終了すると、接続マネージャーはバックエンド接続をプールに返します。クライアントがサポートされていない機能をトリガーするか、保留中のコマンドで接続を閉じると、接続マネージャーはそのバックエンド接続をプールに返すのではなく、破棄します。他のクライアントは影響を受けません。

未サポートの機能#

一部のPostgres機能は、server_reset_mode に関係なく、transaction モードではサポートされていません。 discard_all では、 DISCARD ALL が依存する状態をクリアするため、これらに依存すると予想通り失敗します。 fast では、そのクリーンアップがスキップされるため、障害は予測できず、代わりに状態が持続して別のクライアントのトランザクションにリークする可能性があります。すでに次のすべてを回避しているアプリケーションの場合にのみfast モードを有効にします。

セッション中に行われたSET 変更は、 transaction モードでは持続しません。代わりに、接続文字列でセッションパラメーターを構成します。詳細は、セッションパラメーターの管理を参照してください。
PREPARE /EXECUTE /DEALLOCATE SQLステートメントはtransaction モードではサポートされていません。これらのステートメントを使用するトランザクション内で発行するか、代わりに拡張照会プロトコルを使用します。詳細は、準備されたステートメントを使用するを参照してください。
ホールダブルカーソルWITH HOLD は、transaction モードではサポートされていません。これらはトランザクション境界を超えて持続するため、トランザクションの終了時にバックエンド接続をプールに返すことと競合します。
LISTEN はtransaction モードではサポートされていません。 LISTEN サブスクリプションは、単一のトランザクションを超えて持続します。これは、バックエンド接続をプールに返すことと競合します。
トランザクション境界を越えて保持されるアドバイザリロックは、 transaction モードではサポートされていません。
トランザクションを超えてアクセスされる一時テーブルは、 transaction モードではサポートされていません。
レプリケーション接続はすべてのプールモードで拒否されます。

Connection pooling

目次