Hologres:クエリの管理

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

• HG_STAT_ACTIVITY (PG_STAT_ACTIVITY) ビュー：SQL 文のランタイム情報を表示して、管理を改善します。

• HoloWeb でのアクティブなクエリの GUI 管理：HoloWeb を使用して、GUI でアクティブなクエリを表示および管理します。

• ロックのトラブルシューティング：アクティブなクエリを使用して、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 を使用して、GUI でアクティブなクエリを表示および管理できます。

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

2. 上部のナビゲーションバーで、[診断と最適化] をクリックします。

3. 左側のナビゲーションウィンドウで、[アクティブ情報管理] > [アクティブなクエリ] に移動します。

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

   クエリ結果リストには、次の情報が含まれています。

   パラメーター	説明
   クエリの開始	クエリが開始された時刻。
   実行時間	クエリが実行されている時間。
   PID	サービスプロセスの ID をクエリできます。
   クエリ	クエリで実行される 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'