system.session_query_ids

​

Description

• 現在実行中のクエリは、このテーブルに対して SELECT を実行した時点ですでに現れます。
• 失敗したクエリも記録されます。たった今失敗したクエリの ID を取得することは、主要なユースケースの 1 つです。

​

インターフェイスごとのセッションスコープ

• ネイティブ/TCP接続 (clickhouse-client、ドライバー) および clickhouse-local: セッションは接続そのものであるため、複数クエリを実行するクライアント呼び出しも含め、その接続内のすべてのクエリにわたって履歴が蓄積されます。
• session_id パラメータを指定したHTTP: 同じ session_id を渡すリクエストの間では、セッションが期限切れになるまで履歴が保持されます。
• session_id を指定しないHTTP: リクエストごとに独立したセッションとなるため、テーブルには常に現在のクエリのみが表示されます。

​

履歴のサイズ

​

TRUNCATE

​

カラム

• sequence_number (UInt64) — セッション内におけるクエリの位置。単調増加します。
• query_id (String) — クエリ ID。system.query_log と結合できます。

​

例

SELECT 1 FORMAT Null;
SELECT 2 FORMAT Null;

SELECT * FROM system.session_query_ids;

┌─sequence_number─┬─query_id─────────────────────────────┐
│               1 │ 4c9e97a3-b806-4a5c-9a94-5a614c3d0b3f │
│               2 │ 8f9a2f59-30d3-4f8e-b3a1-6a0c1a4d3e2b │
│               3 │ f2b1c4d8-7e6a-4b5c-8d9e-0a1b2c3d4e5f │
└─────────────────┴──────────────────────────────────────┘

SYSTEM FLUSH LOGS query_log;

SELECT query_id, type, query, query_duration_ms
FROM system.query_log
WHERE query_id IN (SELECT query_id FROM system.session_query_ids)
ORDER BY event_time_microseconds;

​

関連項目

• system.query_log - 実行されたクエリの詳細。
• session_query_ids_history_size 設定。