Hologres:クエリの管理

Hologres は PostgreSQL と互換性があります。インスタンス内のクエリの実行時情報を表示するには、HG_STAT_ACTIVITY (PG_STAT_ACTIVITY) ビューを使用します。これにより、実行中の SQL 文を分析・診断できます。主な操作は以下のとおりです。

• HG_STAT_ACTIVITY (PG_STAT_ACTIVITY) ビュー：SQL の実行時情報を表示し、SQL 文を効率的に管理します。

• HoloWeb コンソールでのアクティブクエリの管理：HoloWeb コンソールでアクティブクエリを表示および管理します。

• ロックのトラブルシューティング：アクティブクエリを使用して、現在の SQL 文がロックを保持しているか、またはロックによってブロックされているかを確認します。

• クエリの停止：期待通りに動作しないクエリをコマンドで停止します。

• アクティブクエリのタイムアウト期間の変更：デッドロックを防止するために、アクティブクエリのタイムアウト期間を変更します。

• アイドルクエリのタイムアウト期間の変更：デッドロックを防止するために、アイドルクエリのタイムアウト期間を変更します。

• スロークエリログの照会：スローや失敗したクエリを診断・分析・最適化するために、スロークエリログを照会します。

• よくある質問：ERROR: canceling statement due to statement timeout エラーの原因と解決策を確認します。

SQL を使用してアクティブクエリを照会する場合は、以下の SQL 文を実行します。

1. 現在のアクティブクエリとその実行ステージ、リソース消費量を表示します。

   説明

   スーパーユーザはすべてのユーザーの SQL 実行時情報を表示できます。スーパーユーザ以外のユーザーは自身の SQL 実行時情報のみ表示できます。

   -- Hologres V2.0 以降の構文
   SELECT query,state,query_id,transaction_id,running_info, extend_info 
   FROM hg_stat_activity 
   WHERE state = 'active' 
   AND     backend_type = 'client backend'
   AND     application_name != 'hologres'
   
   -- Hologres V1.3 以前の構文
   SELECT query,state,pid
   FROM pg_stat_activity 
   WHERE state = 'active' 
   AND     backend_type = 'client backend'
   AND     application_name != 'hologres'

   サンプル結果：

   -------------------------------------------------------------------------------
   query          | insert into test_hg_stat_activity select i, (i % 7) :: text, (i % 1007) from generate_series(1, 10000000)i;
   state          | active
   query_id       | 100713xxxx
   transaction_id | 100713xxxx
   running_info   | {"current_stage" : {"stage_duration_ms" :5994,
                                         "stage_name" :"EXECUTE" },
                      "engine_type" :"{HQE,PQE}",
                      "fe_id" :1,
                      "warehouse_id" :0 }
   extend_info    | {"affected_rows" :9510912,
                     "scanned_rows" :9527296 }

2. 現在実行中のクエリを CPU 消費量順に並べ替えます。

   -- Hologres V2.0 以降の構文
   SELECT query,((extend_info::json)->'total_cpu_max_time_ms')::text::bigint AS cpu_cost,state,query_id,transaction_id 
   FROM hg_stat_activity WHERE state = 'active' ORDER BY 2 DESC;

   サンプル結果：

   ---------------------------------------------------------------------------------
   query          | select xxxxx
   cpu_cost       | 523461
   state          | active
   query_id       | 10053xxxx
   transaction_id | 10053xxxx
   ---------------------------------------------------------------------------------
   query          | insert xxxx
   cpu_cost       | 4817
   state          | active
   query_id       | 1008305xxx
   transaction_id | 1008305xxx

3. 現在実行中のクエリをメモリ消費量順に並べ替えます。

   -- Hologres V2.0 以降の構文
   SELECT query,((extend_info::json)->'total_mem_max_bytes')::text::bigint AS mem_max_cost,state,query_id,transaction_id 
   FROM hg_stat_activity WHERE state = 'active' ORDER BY 2 DESC;

   サンプル結果：

   ---------------------------------------------------------------------------------
   query          | update xxxx;
   mem_max_cost   | 5727634542
   state          | active
   query_id       | 10053302784827629
   transaction_id | 10053302784827629
   ---------------------------------------------------------------------------------
   query          | select xxxx;
   mem_max_cost   | 19535640
   state          | active
   query_id       | 10083259096119559
   transaction_id | 10083259096119559

4. 現在のインスタンス内で長時間実行されているクエリを表示します。

   -- Hologres V2.0 以降の構文
   SELECT current_timestamp - query_start AS runtime, datname::text, usename, query, query_id
       FROM hg_stat_activity
       WHERE state != 'idle'
       AND backend_type = 'client backend'
       AND application_name != 'hologres'
       ORDER BY 1 DESC;
   
   -- Hologres V1.3 以前の構文
   SELECT current_timestamp - query_start AS runtime, datname::text, usename, query, pid
       FROM pg_stat_activity
       WHERE state != 'idle'
       AND backend_type = 'client backend'
       AND application_name != 'hologres'
       ORDER BY 1 DESC;

   サンプル結果：

   runtime          |  datname  | usename  | query_id    |      current_query
   -----------------+----------------+----------+------------------------------------
    00:00:24.258388 | holotest  | 123xxx   | 1267xx | UPDATE xxx;
    00:00:1.186394  | testdb    | 156xx    | 1783xx | select xxxx;

   UPDATE 文は 24 秒間実行されており、まだ完了していません。

HoloWeb コンソールでアクティブクエリを表示および管理できます。

1. HoloWeb コンソールにログインします。詳細については、「HoloWeb への接続とクエリの実行」をご参照ください。

2. 上部ナビゲーションバーで、Diagnostics and Optimization をクリックします。

3. 左側のナビゲーションウィンドウで、Management for Information About Active Queries > Active Query Tasks の順に選択します。

4. Active Query Tasks ページで、Search をクリックして、現在のインスタンスのアクティブクエリを表示および管理します。

   クエリ結果リストには以下の情報が含まれます。

   パラメーター	説明
   Query Start	クエリの開始時刻。
   Runtime	クエリの実行時間。
   PID	クエリサービスプロセスの ID。
   Query	実行されている SQL 文。
   State	現在の接続のステータス。一般的なステータスは以下のとおりです。 active：接続がアクティブです。 idle：アイドル状態です。 idle in transaction：長時間トランザクション内で接続がアイドル状態です。 idle in transaction (Aborted)：失敗したトランザクション内で接続がアイドル状態です。 \N：ステータスが空です。これはユーザ接続ではないプロセスを示しており、通常はシステムのバックグラウンドメンテナンスプロセスであるため、無視できます。
   User Name	現在の接続のユーザー名。
   Application	クエリアプリケーションの種類。
   Client Address	クエリを開始したクライアントの IP アドレス。

   クエリが長時間実行されている場合、対象クエリの Actions 列にある Cancel をクリックして停止できます。複数のクエリを選択して、Batch Cancel をクリックすることも可能です。

5. （オプション）対象クエリの Actions 列にある 詳細 をクリックして、詳細情報を表示します。

   詳細 ページでは、以下の操作を実行できます。

   • Copy：実行されている SQL 文をコピーします。

   • Format：実行されている SQL 文を整形します。

期待通りに動作しないクエリを停止するには、以下のコマンドを実行します。

• 単一のクエリを停止する場合：

  SELECT pg_cancel_backend(<pid>);

• 複数のクエリを一括で停止する場合：

  SELECT pg_cancel_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     application_name != 'hologres'