クエリ履歴
注:
ワークスペースでサーバレス コンピュートが有効になっている場合、クエリ履歴には、ノートブックとジョブのサーバレス コンピュートで実行されたすべての SQL クエリと Python クエリも含まれます。 Connect to サーバレス コンピュートを参照してください。
ワークスペースで DLT のクエリー履歴とプロファイル が有効になっている場合 (パブリック プレビュー)、クエリ履歴には、 SQLウェアハウスまたは Delta Live Tables パイプラインを介して実行されたCREATE
ステートメントと REFRESH
ステートメントが表示されます。
この画面から入手できる情報を使用して、クエリに関する問題のデバッグに役立てることができます。
このセクションでは、UI を使用してクエリ履歴を操作する方法について説明します。 APIを使用してクエリ履歴を操作するには、クエリー履歴を参照してください。
クエリ履歴の表示
クエリの以前の実行を表示するには:
クリックサイドバーに履歴ーあります。
必要に応じて、ページの上部にあるフィルターを使用して、ユーザー、日付範囲、コンピュート、期間、クエリ ステータス、ステートメント タイプ、ステートメント ID でリストをフィルタリングします。
Databricks SQLクエリの場合、少なくとも CAN MONITOR 権限を持たない管理者以外のユーザーは、クエリー履歴で自分のクエリのみを表示できます。
注:
[所有者として実行] アクセス許可を持つユーザーが CAN RUN アクセス許可を持つ別のユーザーと共有している Databricks SQL クエリは、クエリを共有したユーザーではなく、クエリを実行しているユーザーのクエリ履歴に表示されます。
クエリの詳細を表示する
クエリに関する詳細 (完全なクエリ ステートメント、クエリ ソース、実行時間、返されたロー数、I/O パフォーマンス、 実行の詳細など) を表示するため。
クエリ履歴を表示します。
クエリの名前をクリックします。
ステートメント ID: これは、特定のクエリ オブジェクトに関連付けられた汎用一意識別子 (UUID) です。
クエリの状態: クエリには、現在の状態 ( キューに登録済み、 実行中、 完了、 失敗、 またはキャンセル済み) のタグが付けられます。
コンピュートタイプ: このフィールドには、クエリに使用されたコンピュートタイプが表示されます。
クエリ ステートメント: このセクションには、完全なクエリ ステートメントが含まれています。 クエリが長すぎてプレビューに表示できない場合は、[クエリ展開] アイコンをクリックして全文を表示します。
クエリ ソース: このフィールドには、クエリの発生元が表示されます。 クエリは、AI/BI ダッシュボード、クエリ オブジェクト、Databricks SQL エディター、ノートブック、Delta Live Tables パイプライン (パブリック プレビュー) など、さまざまなソースから取得できます。
ウォールクロック期間: スケジューリングの開始からクエリ実行の終了までのウォールクロックの経過時間を示します。 合計は、スケジューリング時間と実行時間の合計として自動的に表示されます。 詳細については、これらの各フィールドをサブカテゴリに展開できます。
概要の詳細: パネルの下部には、集計されたタスク時間、読み取られて返された行、ファイルとパーティション、発生した可能性のあるスピルなど、クエリのパフォーマンスに関する概要の詳細が含まれます。
クエリのパフォーマンス (実行プランなど) の詳細については、ページの下部にある [クエリ プロファイルの表示 ] をクリックしてください。 詳細については、「 クエリ プロファイル」を参照してください。
実行中のクエリを終了する
自分または別のユーザーが開始した実行時間の長いクエリを終了するには、次のようにします。
クエリ履歴を表示します。
クエリの名前をクリックします。
[ステータス] の横にある [キャンセル] をクリックします。
注:
[キャンセル] は、クエリの実行中にのみ表示されます。
クエリが終了し、ステータスが [キャンセル] に変わります。
注:
Delta Live Tablesコンピュートを使用するステートメントは、パイプラインUIからのみキャンセルできます。
クエリ履歴システムテーブルにアクセスする
Databricks システムテーブルには、特権ユーザーがアカウント全体から表形式のクエリ履歴レコードを表示できるクエリ履歴テーブル(system.query.history
)が含まれています。 デフォルトでは、管理者のみがアカウントのシステムテーブルにアクセスできます。 クエリ履歴システムテーブルの有効化とアクセスに関する情報については、「 クエリ履歴システムテーブル リファレンス」を参照してください。