Hologres:クエリの管理

Hologres は PostgreSQL と互換性があります。hg_stat_activity (pg_stat_activity) ビューを使用して、インスタンス内のクエリのランタイム情報を監視し、分析と診断を行うことができます。このトピックでは、以下の操作について説明します。

• hg_stat_activity (pg_stat_activity) ビュー：SQL のランタイム情報を表示して、SQL ステートメントをより適切に管理します。

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

• ロックのトラブルシューティング：アクティブなクエリを使用して、SQL ステートメントがロックを保持しているか、ロックによってブロックされているかを特定します。

• クエリの終了：コマンドを使用して、期待どおりに動作しないクエリを終了します。

• アクティブなクエリのタイムアウトの変更：アクティブなクエリの実行タイムアウトを変更して、デッドロックを防ぎます。

• アイドルクエリのタイムアウトの変更：アイドルクエリのタイムアウトを変更して、デッドロックを防ぎます。

• 低速クエリログの照会: 低速クエリログを使用して、低速または失敗したクエリを診断、分析、最適化します。

• よくある質問：ERROR: canceling statement due to statement timeout エラーの原因と解決策について説明します。

SQL を使用してアクティブなクエリを表示する場合は、以下のステートメントを使用できます。

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

   説明

   スーパーユーザーはすべてのユーザーのランタイム情報を表示できますが、他のユーザーは自身の情報のみを表示できます。

   -- 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         | query_id
   -----------------+-----------+----------+---------------+-----------
    00:00:24.258388 | holotest  | 123xxx   | UPDATE xxx;   | 1267xx
    00:00:1.186394  | testdb    | 156xx    | select xxxx;  | 1783xx

   この結果は、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 をクリックすると、現在のインスタンスのアクティブなクエリを表示および管理できます。

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

   パラメータ	説明
   クエリ開始	クエリが開始された時刻。
   実行時間	クエリの実行時間。
   PID	クエリを処理するサービスのプロセス ID (PID)。
   クエリ	実行された SQL ステートメント。
   状態	接続の現在の状態。一般的な状態には、以下があります： アクティブ：クエリが実行中です。 アイドル：接続がアイドル状態です。 トランザクション中のアイドル：トランザクション内で接続がアイドル状態です。 トランザクション中のアイドル (中止)：失敗したトランザクション内で接続がアイドル状態です。 \N：状態が null です。これは通常、ユーザー接続ではなく、システムのバックグラウンドメンテナンスプロセスを示しており、無視できます。
   ユーザー名	現在の接続のユーザー名。
   アプリケーション	クエリを開始したアプリケーション。
   クライアントアドレス	クライアントの 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'