Hologres:クエリを管理する

Hologres は PostgreSQL と互換性があります。HG_STAT_ACTIVITY (PG_STAT_ACTIVITY) ビューを使用して、Hologres インスタンス上のクエリの 実行 情報を表示できます。これは、クエリ実行情報を分析し、関連する問題を診断するのに役立ちます。クエリ管理機能には、次の操作が含まれます。

• HG_STAT_ACTIVITY (PG_STAT_ACTIVITY) ビューを使用する: SQL 文のランタイム情報を表示して、SQL 文をより適切に管理します。

• HoloWebを使用して、視覚化された方法でアクティブなクエリを表示および管理する: HoloWebを使用して、視覚化された方法でアクティブなクエリを表示および管理します。

• ロックの問題のトラブルシューティング: アクティブなクエリのSQLステートメントがロックを取得しているか、ロックが解放されるのを待機しているかを確認します。

• クエリをキャンセルする: ステートメントを実行することにより、期待どおりでないクエリをキャンセルします。

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

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

• 低速クエリログをクエリする: 低速クエリログをクエリして、低速クエリまたは失敗したクエリを診断、分析、および最適化します。

• FAQ: エラーメッセージ ERROR: canceling statement due to statement timeout が報告された場合に問題を解決します。

このセクションでは、SQL ステートメントを使用してアクティブなクエリを表示する方法について説明します。

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

   説明

   Hologres インスタンスのスーパーユーザーは、Hologres インスタンスのすべてのユーザーによって送信された 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. 上部のナビゲーションバーで、[診断と最適化] をクリックします。

3. 左側のナビゲーションペインで、[アクティブなクエリ情報の管理] > [アクティブなクエリタスク] を選択します。

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

   次の表は、クエリ結果のパラメーターについて説明しています。

   パラメーター	説明
   クエリの開始	クエリの実行が開始された時刻。
   実行時間	クエリが実行されている期間。
   PID	クエリのプロセス ID（PID）。
   クエリ	データのクエリを実行するために実行される SQL ステートメント。
   状態	現在の接続のステータス。有効な値： active：接続はアクティブです。 idle：接続はアイドル状態です。 idle in transaction：接続は長時間実行トランザクションでアイドル状態です。 idle in transaction (Aborted)：接続は失敗したトランザクションでアイドル状態です。 \N：この値は、プロセスがユーザー接続プロセスではないことを示します。ほとんどの場合、この状態はシステムバックエンドのメンテナンスプロセスに対して返され、無視できます。
   ユーザー名	現在の接続の作成に使用されるユーザー名。
   アプリケーション	クエリを開始するアプリケーションのタイプ。
   クライアントアドレス	クエリ要求を送信するクライアントの IP アドレス。

   クエリが長時間完了しない場合は、[操作] 列の [キャンセル] をクリックしてクエリをキャンセルできます。複数のクエリを選択し、[一括キャンセル] をクリックして、複数のクエリを一度にキャンセルすることもできます。

5. （オプション）クエリの [操作] 列の [詳細] をクリックして、クエリの詳細を表示します。

   [詳細] ページでは、次の操作を実行できます。

   • [コピー]：クエリ用に実行された SQL ステートメントをコピーします。

   • [フォーマット]：クエリ用に実行された 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'