Hologres:接続の管理

接続とクエリ管理の概要

pg_stat_activityビューのクエリ

select * from pg_stat_activity ;

使用上の注意

すべての接続に関する情報を表示できるのはスーパーユーザーのみです。 通常のユーザーは、自分の接続に関する情報のみを表示できます。

Hologresインスタンスへのデフォルトの最大接続数をクエリする

HoloWebコンソールで接続を管理する

SQLステートメントを実行して接続情報をクエリする

SQLステートメントを実行して接続情報をクエリできます。

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

   次のコマンドを使用して、現在のデータベースへの接続数を表示できます。メトリックの詳細については、「メトリックの説明」をご参照ください。

   • 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` ビューをクエリして、指定された状態のすべての Java Database Connectivity (JDBC) または PostgreSQL 接続をクエリするために、次の文を実行することもできます。

   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接続を使用します。 Hologresインスタンスへの最大接続数がビジネス要件を満たしている場合、これらの接続について心配する必要はありません。 HologresインスタンスへのSQL接続の数が max_connections で指定された上限に近づいているか、達している場合は、アプリケーションで接続リークが発生しているかどうかを確認します。 接続リークが発生した場合は、アプリケーションの接続プールに適切な制限を設定するか、アイドル状態の接続を解放します。 アイドル状態の接続を解放する方法の詳細については、このトピックの接続を解放するをご参照ください。

3. 各FEノードへの接続数をクエリします。

   Hologres V1.3.23以降では、次のステートメントを実行して、Hologresインスタンスの各FEノードへの接続数をクエリできます。 このステートメントは、接続がないFEノードに関する情報は返しません。

   select * from hologres.hg_connections;

   返された結果のフィールドの説明：

   • fe_id: FEノードのID。

   • used_connections: FEノードによって使用されている接続の数。

   • max_connections: FEノードに許可される最大接続数。 このフィールドの値は、 show max_connections コマンドの戻り値と同じです。

接続を解放する

次のシナリオでは、HologresインスタンスまたはHologresインスタンスの単一のFEノードへの接続数が上限に達します。

• 接続数が 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。

これらのシナリオでは、スーパーユーザーとしてHologresインスタンスに接続し、次のステートメントを実行して、過剰なアイドル状態の接続が存在するかどうかを確認できます。

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は、Hologresインスタンスのスーパーユーザー用に接続を自動的に予約します。 インスタンスへの予約済み接続の数は、インスタンスの仕様によって異なります。 詳細については、インスタンス管理をご参照ください。 Hologresインスタンスの場合、予約済み接続は、インスタンスへの接続数が上限に達したときにスーパーユーザーが接続を管理するために使用されます。 たとえば、スーパーユーザーはアイドル状態の接続を閉じることができます。 通常のユーザーが使用できる最大接続数は、最大接続数から予約済み接続の数を引いた値です。 通常のユーザーの場合は、スーパーユーザーアカウントを使用してデータベースを管理しないことをお勧めします。 そうしないと、接続が予約されず、接続を解放できません。

単一ユーザーの最大接続数

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

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

アイドル状態の接続を自動的に解放するようにシステムを有効にする

Hologresインスタンスへの接続数が上限に近づいているか、達している場合は、接続リークが発生している可能性があります。 アイドル状態の接続の自動解放を有効にして、特定の期間使用されていない接続を解放できます。 接続が指定された期間アイドル状態のままになっている場合、接続は自動的に閉じられます。 SQLステートメントが実行されていない接続は、アイドル状態と見なされます。

• 制限

  Hologres V0.10.25以降では、アイドル状態の接続の自動解放がサポートされています。 HologresインスタンスのバージョンがV0.10.25より前の場合は、HologresコンソールでHologresインスタンスを手動でアップグレードするか、テクニカルサポートのDingTalkグループに参加してください。 HologresコンソールでHologresインスタンスを手動でアップグレードする方法の詳細については、「インスタンスのアップグレード」トピックの手動アップグレードをご参照ください。 Hologres DingTalkグループへの参加方法の詳細については、Hologresのオンラインサポートを受けるをご参照ください。

• 構文例

  • セッションレベル

    -- 接続が 600,000 ミリ秒（10分）間アイドル状態の場合、接続は自動的に閉じられます。
    SET idle_session_timeout = 600000;

  • データベースレベル

    -- 接続が 600,000 ミリ秒（10分）間アイドル状態の場合、接続は自動的に閉じられます。
    ALTER DATABASE  <db_name> SET idle_session_timeout = 600000;

    db_name パラメータは、アイドル状態の接続の自動解放を有効にするデータベースの名前を指定します。

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

よくあるエラー

• SQL 文を実行すると、次のエラーが発生します：terminating connection due to idle state timeout。

• 原因: アイドル状態の接続を自動的に解放するためのタイムアウト期間がHologresインスタンスに設定されています。 指定されたタイムアウト期間が経過すると、接続は自動的に閉じられます。 その後、このエラーメッセージが返されます。

• 解決策: Hologresインスタンスに再度接続するか、アイドル状態の接続を自動的に解放するためのタイムアウト期間を増やします。 タイムアウト期間を増やす方法の詳細については、このトピックのアイドル状態の接続を自動的に解放するようにシステムを有効にするをご参照ください。