Hologres:接続の管理

概要

pg_stat_activityビューのクエリ

select * from pg_stat_activity ;

使用上の注意

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

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

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ビューをクエリすることにより、指定された状態のすべての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: この状態は、アクティブなSQLステートメントを追跡する機能がプロセスで無効になっていることを示します。

   たとえば、次のステートメントを実行して、現在のインスタンスへのアイドル状態の接続をクエリできます。

   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>);  -- バックエンドプロセスの接続を閉じます。

-- バックエンドプロセスのアイドル状態の接続を閉じて解放します。
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 パラメータは、アイドル状態の接続の自動解放を有効にするデータベースの名前を指定します。

ベストプラクティス

FAQ

• SQLステートメントを実行すると terminating connection due to idle state timeout というエラーメッセージが返された場合はどうすればよいですか？

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

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