クエリ履歴システム テーブル リファレンス
重要
このシステム テーブルは パブリック プレビュー にあります。 テーブルにアクセスするには、 system カタログでスキーマを有効にすることが必要です。 詳細については、「システム テーブル スキーマを有効にする」を参照してください。
この記事には、テーブルのスキーマの概要などの、クエリ履歴システム テーブルに関する情報が含まれています。
重要
クエリ履歴システム テーブルにアクセスするには、query スキーマを有効にする必要があります。 システム スキーマを有効にする手順については、「システム テーブル スキーマを有効にする」を参照してください。
テーブル パス: このシステム テーブルは次の場所にあります system.query.history。
クエリ履歴テーブルの使用
クエリ履歴テーブルには、SQL ウェアハウスを使用して実行されるすべての SQL ステートメントのレコードが含まれます。 テーブルには、テーブルへのアクセス元である同じリージョン内のすべてのワークスペースのアカウント全体のレコードが含まれています。
既定では、管理者のみがシステム テーブルにアクセスできます。 テーブルのデータをユーザーまたはグループと共有する場合、Databricks では、ユーザーまたはグループごとに動的ビューを作成することをお勧めします。 「動的ビューを作成する」を参照してください。
クエリ履歴システム テーブル スキーマ
クエリ履歴テーブルでは、次のスキーマを使用します。
| 列名 | データ型 | 説明 | 例 |
|---|---|---|---|
account_id |
string | アカウントの ID。 | 11e22ba4-87b9-4cc2-9770-d10b894b7118 |
workspace_id |
string | クエリが実行されたワークスペースの ID。 | 1234567890123456 |
statement_id |
string | ステートメントの実行を一意に識別する ID。 この ID を使用して、Query History UI でステートメントの実行を見つけることができます。 | 7a99b43c-b46c-432b-b0a7-814217701909 |
session_id |
string | Spark セッション ID。 | 01234567-cr06-a2mp-t0nd-a14ecfb5a9c2 |
execution_status |
string | ステートメントの終了状態。 次のいずれかの値になります。 - FINISHED: 実行が成功しました- FAILED: 付随するエラー メッセージで説明されているエラーにより実行に失敗しました- CANCELED: 実行が取り消されました |
FINISHED |
compute |
struct | ステートメントの実行に使用されたコンピューティング リソースの種類と、該当する場合はリソースの ID を表す構造体。 type 値は WAREHOUSE または SERVERLESS_COMPUTE のどちらかになります。 |
{type: WAREHOUSE,cluster_id: NULL,warehouse_id: ec58ee3772e8d305} |
executed_by_user_id |
string | ステートメントを実行したユーザーの ID。 | 2967555311742259 |
executed_by |
string | ステートメントを実行したユーザーのメール アドレスまたはユーザー名。 | example@databricks.com |
statement_text |
string | SQL ステートメントのテキスト。 カスタマー マネージド キーを構成した場合、statement_text は空です。 |
SELECT 1 |
statement_type |
string | ステートメントの種類。 例: ALTER、COPY、および INSERT。 |
SELECT |
error_message |
string | エラー状態を説明するメッセージ。 カスタマー マネージド キーを構成した場合、error_message は空です。 |
[INSUFFICIENT_PERMISSIONS] Insufficient privileges: User does not have permission SELECT on table 'default.nyctaxi_trips'. |
client_application |
string | ステートメントを実行したクライアント アプリケーション。 例: Databricks SQL、Tableau、および Power BI。 | Databricks SQL |
client_driver |
string | ステートメントを実行するために Azure Databricks への接続に使用されたコネクタ。 例: Databricks SQL Driver for Go、Databricks ODBC Driver、Databricks JDBC Driver。 | Databricks JDBC Driver |
total_duration_ms |
bigint | ステートメントの合計実行時間 (ミリ秒単位 (結果フェッチ時間を除く))。 | 1 |
waiting_for_compute_duration_ms |
bigint | コンピューティング リソースのプロビジョニングを待機するために費やされた時間 (ミリ秒単位)。 | 1 |
waiting_at_capacity_duration_ms |
bigint | 使用可能なコンピューティング容量をキューで待機するために費やされた時間 (ミリ秒単位)。 | 1 |
execution_duration_ms |
bigint | ステートメントの実行に費やされた時間 (ミリ秒単位)。 | 1 |
compilation_duration_ms |
bigint | メタデータの読み込みとステートメントの最適化に費やされた時間 (ミリ秒単位)。 | 1 |
total_task_duration_ms |
bigint | すべてのタスク期間の合計 (ミリ秒単位)。 この時間は、すべてのノードのすべてのコアでクエリの実行にかかった合計時間を表します。 複数のタスクが並列で実行される場合は、実時間よりも大幅に長い値である可能性があります。 タスクが使用可能なノードを待機する場合は、実時間よりも短い値である可能性があります。 | 1 |
result_fetch_duration_ms |
bigint | 実行が完了した後にステートメントの結果をフェッチするのに費やされた時間 (ミリ秒単位)。 | 1 |
start_time |
timestamp | Databricks が要求を受信した時刻。 タイムゾーン情報は、UTC を表す +00:00 という形式で値の末尾に記録されます。 |
2022-12-05T00:00:00.000+0000 |
end_time |
timestamp | ステートメントの実行が終了した時刻 (結果のフェッチ時間を除く)。 タイムゾーン情報は、UTC を表す +00:00 という形式で値の末尾に記録されます。 |
2022-12-05T00:00:00.000+00:00 |
update_time |
timestamp | ステートメントが最後に進行状況の更新を受信した時刻。 タイムゾーン情報は、UTC を表す +00:00 という形式で値の末尾に記録されます。 |
2022-12-05T00:00:00.000+00:00 |
read_partitions |
bigint | 排除後に読み取られたパーティションの数。 | 1 |
pruned_files |
bigint | 排除されたファイルの数。 | 1 |
read_files |
bigint | 排除後に読み取られたファイルの数。 | 1 |
read_rows |
bigint | ステートメントによって読み取られた行の合計数。 | 1 |
produced_rows |
bigint | ステートメントによって返された行の合計数。 | 1 |
read_bytes |
bigint | ステートメントによって読み取られたデータの合計サイズ (バイト単位)。 | 1 |
read_io_cache_percent |
int | IO キャッシュから読み取られた永続データのバイト数の割合。 | 50 |
from_result_cache |
boolean | TRUE は、ステートメントの結果がキャッシュからフェッチされたことを示します。 |
TRUE |
spilled_local_bytes |
bigint | ステートメントの実行中にディスクに一時的に書き込まれたデータのサイズ (バイト単位)。 | 1 |
written_bytes |
bigint | クラウド オブジェクト ストレージに書き込まれた永続データのサイズ (バイト単位)。 | 1 |
shuffle_read_bytes |
bigint | ネットワーク経由で送信されたデータの合計量 (バイト単位)。 | 1 |
query_source |
struct | ジョブ、ノートブック、ダッシュボードなど、このステートメントの実行に関連した 1 つ以上の Databricks エンティティを表すキーと値のペアを含む構造体。 このフィールドは、Databricks エンティティのみを記録します。 | {job_info: { job_id: 64361233243479 job_run_id: 887406461287882 job_task_key: “job_task_1” job_task_run_id: 110378410199121} |
executed_as |
string | ステートメントの実行に使用された権限を持つユーザーまたはサービス プリンシパルの名前。 | example@databricks.com |
executed_as_user_id |
string | ステートメントの実行に使用された権限を持つユーザーまたはサービス プリンシパルの ID。 | 2967555311742259 |
レコードのクエリ プロファイルを表示する
クエリ履歴テーブルのレコードに基づいてクエリのクエリ プロファイルに移動するには、次のようにします。
- 目的のレコードを特定し、レコードの
statement_idをコピーします。 - レコードの
workspace_idを参照して、レコードと同じワークスペースにログインしていることを確認します。 - ワークスペースのサイドバーの
[クエリ履歴] をクリックします。 - [ステートメント ID] フィールドに、レコードの
statement_idを貼り付けます。 - クエリの名前をクリックします。 クエリ メトリックの概要が表示されます。
- [See query profile] (クエリ プロファイルの表示) をクリックします。