クエリ履歴

注:

ワークスペースでサーバレス コンピュートが有効になっている場合、クエリ履歴には、ノートブックとジョブのサーバレス コンピュートで実行されたすべての SQL クエリと Python クエリも含まれます。 Connect to サーバレス コンピュートを参照してください。

ワークスペースで DLT のクエリー履歴とプロファイル が有効になっている場合 (パブリック プレビュー)、クエリ履歴には、 SQLウェアハウスまたは Delta Live Tables パイプラインを介して実行されたCREATEステートメントと REFRESH ステートメントが表示されます。

この画面から入手できる情報を使用して、クエリに関する問題のデバッグに役立てることができます。

このセクションでは、UI を使用してクエリ履歴を操作する方法について説明します。 APIを使用してクエリ履歴を操作するには、クエリー履歴を参照してください。

クエリ履歴の表示

クエリの以前の実行を表示するには:

  1. クリック履歴アイコンサイドバーに履歴ーあります

  2. 必要に応じて、ページの上部にあるフィルターを使用して、ユーザー、日付範囲、コンピュート、期間、クエリ ステータス、ステートメント タイプ、ステートメント ID でリストをフィルタリングします。

Databricks SQLクエリの場合、少なくとも CAN MONITOR 権限を持たない管理者以外のユーザーは、クエリー履歴で自分のクエリのみを表示できます。

注:

[所有者として実行] アクセス許可を持つユーザーが CAN RUN アクセス許可を持つ別のユーザーと共有している Databricks SQL クエリは、クエリを共有したユーザーではなく、クエリを実行しているユーザーのクエリ履歴に表示されます。

クエリの詳細を表示する

クエリに関する詳細 (完全なクエリ ステートメント、クエリ ソース、実行時間、返されたロー数、I/O パフォーマンス、 実行の詳細など) を表示するため。

  1. クエリ履歴を表示します。

  2. クエリの名前をクリックします。

    クエリ履歴の詳細

    • ステートメント ID: これは、特定のクエリ オブジェクトに関連付けられた汎用一意識別子 (UUID) です。

    • クエリの状態: クエリには、現在の状態 ( キューに登録済み実行中完了失敗またはキャンセル済み) のタグが付けられます。

    • コンピュートタイプ: このフィールドには、クエリに使用されたコンピュートタイプが表示されます。

    • クエリ ステートメント: このセクションには、完全なクエリ ステートメントが含まれています。 クエリが長すぎてプレビューに表示できない場合は、[クエリクエリーを展開展開] アイコンをクリックして全文を表示します。

    • クエリ ソース: このフィールドには、クエリの発生元が表示されます。 クエリは、AI/BI ダッシュボード、クエリ オブジェクト、Databricks SQL エディター、ノートブック、Delta Live Tables パイプライン (パブリック プレビュー) など、さまざまなソースから取得できます。

    • ウォールクロック期間: スケジューリングの開始からクエリ実行の終了までのウォールクロックの経過時間を示します。 合計は、スケジューリング時間と実行時間の合計として自動的に表示されます。 詳細については、これらの各フィールドをサブカテゴリに展開できます。

    • 概要の詳細: パネルの下部には、集計されたタスク時間、読み取られて返された行、ファイルとパーティション、発生した可能性のあるスピルなど、クエリのパフォーマンスに関する概要の詳細が含まれます。

  3. クエリのパフォーマンス (実行プランなど) の詳細については、ページの下部にある [クエリ プロファイルの表示 ] をクリックしてください。 詳細については、「 クエリ プロファイル」を参照してください。

実行中のクエリを終了する

自分または別のユーザーが開始した実行時間の長いクエリを終了するには、次のようにします。

  1. クエリ履歴を表示します。

  2. クエリの名前をクリックします。

  3. [ステータス] の横にある [キャンセル] をクリックします。

    注:

    [キャンセル] は、クエリの実行中にのみ表示されます。

クエリが終了し、ステータスが [キャンセル] に変わります。

注:

Delta Live Tablesコンピュートを使用するステートメントは、パイプラインUIからのみキャンセルできます。

クエリ履歴システムテーブルにアクセスする

Databricks システムテーブルには、特権ユーザーがアカウント全体から表形式のクエリ履歴レコードを表示できるクエリ履歴テーブル(system.query.history)が含まれています。 デフォルトでは、管理者のみがアカウントのシステムテーブルにアクセスできます。 クエリ履歴システムテーブルの有効化とアクセスに関する情報については、「 クエリ履歴システムテーブル リファレンス」を参照してください。