Hologres:接続の管理

接続とクエリの管理

pg_stat_activity ビューのクエリ

select * from pg_stat_activity;

使用方法

スーパーユーザーのみがすべての接続情報を表示できます。標準ユーザーは自身の接続のみを表示できます。

デフォルトの最大接続数

HoloWeb での接続の管理

SQL を使用した接続情報のクエリ

SQL を使用して接続情報をクエリする場合は、次の操作を実行できます。

1. 現在のデータベースへの接続数をクエリします。

   次のコマンドを実行して、現在のデータベースへの接続数を表示できます。フィールドの詳細については、「pg_stat_activity ビューのクエリ」をご参照ください。

   • Hologres V1.1 以降の場合：

     SELECT  datname::TEXT
             ,COUNT(1) AS COUNT
     FROM    pg_stat_activity
     WHERE   backend_type = 'client backend'
     AND     application_name != 'hologres'
     GROUP BY datname::TEXT;

   • Hologres V0.10 以前の場合：

     SELECT  datname
             ,COUNT(1) AS COUNT
     FROM    pg_stat_activity
     WHERE   backend_type = 'client backend'
     AND     application_name != 'hologres'
     GROUP BY datname;

2. 各接続の状態を表示します。

   Hologres コンソールの HoloWeb を使用して各インスタンスの接続状態を表示するか、次のステートメントを実行して pg_stat_activity ビューをクエリし、すべての JDBC または PSQL 接続の状態を取得できます。

   select * from pg_stat_activity where backend_type = 'client backend' and state = '<statename>';

   <statename> を次のいずれかの状態パラメーターに置き換えます。

   • idle：アイドル接続。プロセスは新しいクライアントコマンドを待機しています。

   • active：アクティブな接続。プロセスはクエリを実行しています。

   • idle in transaction：プロセスはトランザクション中にありますが、現在クエリを実行していません (トランザクション中のアイドル)。

   • idle in transaction (aborted)：プロセスは失敗したトランザクション中にあり、現在クエリを実行していません (失敗したトランザクション中のアイドル)。

   • fastpath function call：プロセスが fast-path 関数を実行していることを示します。

   • disabled：プロセスの track activities が無効になっていることを示します。

   たとえば、次のコマンドを実行して、現在のインスタンスのアイドル接続をクエリできます。

   select * from pg_stat_activity where backend_type = 'client backend' and state = 'idle';

   Holoweb などの Hologres の周辺コンポーネントは JDBC を使用し、一定数の接続を消費します。十分な数の接続がある場合は、この使用状況について心配する必要はありません。SQL 接続数が常に max_connections に近づくか達する場合、アプリケーションに接続リークがないか確認し、適切な接続プールサイズを設定する必要があります。または、次のセクションで説明するようにアイドル接続を解放することもできます。詳細については、「接続の終了」をご参照ください。

3. 各アクセスノードの接続数を表示する

   インスタンスの各 FE ノードの現在の接続数をクエリできます。この機能は Hologres V1.3.23 以降でサポートされています。アクティブな接続がない FE ノードは、クエリ結果に表示されません。

   select * from hologres.hg_connections;

   次の表に、クエリ結果のフィールドを示します。

   • fe_id：FE ノードの ID。

   • used_connections：FE ノードで現在使用中の接続数。

   • max_connections：FE ノードの最大接続数。show max_connections コマンドの戻り値と同じです。

接続の終了

次の条件は、システムまたは特定のアクセスノードの接続制限に達したことを示します。

• 接続数が max_connections の値に達したか超えた場合、Hologres コンソールの [監視とアラーム] ページで接続数を確認できます。

• FATAL: sorry, too many clients already connection limit exceeded for superusers エラーが発生します。

• FATAL: remaining connection slots are reserved for non-replication superuser connections エラーが報告されます。

これらの問題が発生した場合は、スーパーユーザーアカウントでインスタンスに接続し、次のステートメントを実行して、アイドル接続が過剰でないか確認します。

select * from pg_stat_activity where backend_type = 'client backend' and state = 'idle';

クエリ結果に不要なアイドルプロセスが過剰に表示される場合は、結果から pid を見つけ、次のステートメントを実行してアイドル接続を解放します。フィールドの詳細については、「pg_stat_activity ビューのクエリ」をご参照ください。

select pg_cancel_backend(<pid>);     -- 接続中のクエリをキャンセルします。
select pg_terminate_backend(<pid>);  -- 対応するバックエンド接続プロセスを終了します。

-- バックエンドの IDLE 接続プロセスを一括で終了して、接続を解放します。
SELECT pg_terminate_backend(pid)
        ,query
        ,datname
        ,usename
        ,application_name
        ,client_addr
        ,client_port
        ,backend_start
        ,state
FROM    pg_stat_activity
WHERE   length(query) > 0
AND     pid != pg_backend_pid()
AND     backend_type = 'client backend'
AND     state = 'idle'
AND     application_name != 'hologres'
AND     query not like '%pg_cancel_backend%';

スーパーユーザー用の予約済み接続

Hologres は、スーパーユーザー用に多数の接続を予約しています。予約される接続の数はインスタンスの仕様によって異なります。詳細については、「インスタンス管理」をご参照ください。これらの予約済み接続は、最大接続制限に達したときにアイドル接続を終了するなど、管理タスク用です。標準ユーザーが利用できる最大接続数は、max_connections から予約済み接続の数を引いたものです。通常のデータベース操作にスーパーユーザーアカウントを使用しないことを推奨します。これにより、利用可能なすべての接続が枯渇し、管理チャネルを使用してそれらを解放できなくなる可能性があります。

ユーザーの接続制限

SELECT rolname, rolconnlimit
FROM pg_roles
WHERE rolconnlimit <> -1;

       rolname | rolconnlimit 
---------------+--------------
 p4_283813xxxx |      1
(1 row)

アイドル接続の自動終了

インスタンスへの接続数が常に上限に近い場合、アプリケーションに接続リークがある可能性があります。アイドル接続の自動終了を有効にして、リソースを解放できます。接続が指定された時間より長くアイドル状態になると、自動的に切断されます。

• 制限事項

  アイドル接続の自動終了は、Hologres V0.10.25 以降でのみサポートされています。インスタンスがそれより前のバージョンを実行している場合は、「アップグレード中に発生する一般的なエラー」をご参照いただくか、Hologres DingTalk グループに参加してインスタンスのアップグレードをリクエストしてください。オンラインサポート用の DingTalk グループへの参加方法については、「オンラインサポートをさらに受けるにはどうすればよいですか?」をご参照ください。

• 構文

  • セッションレベル

    -- 接続が 10 分間 (600,000 ミリ秒) アイドル状態であった場合に、自動的に切断します。
    SET idle_session_timeout = 600000;

  • データベースレベル

    -- このデータベースへの接続が 10 分間 (600,000 ミリ秒) アイドル状態であった場合に、自動的に切断します。
    ALTER DATABASE <db_name> SET idle_session_timeout = 600000;

    <db_name> を、アイドル接続の自動終了を有効にするデータベースの名前に置き換えます。

接続のベストプラクティス

よくあるエラー

• SQL 実行中にエラーメッセージが返されます： terminating connection due to idle state timeout。

• 原因：設定されたアイドルタイムアウトを超えたため、接続が自動的に終了されました。

• 解決策：インスタンスに再接続するか、アイドル接続のタイムアウトを増やします。アイドル接続のタイムアウトを変更する方法については、「アイドル接続の自動終了」をご参照ください。