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