クエリの履歴
クエリ履歴には、SQL ウェアハウスを使用して実行された SQL クエリが表示されます。 クエリ履歴には過去 30 日間のクエリ データが保持され、その後、自動的に削除されます。
Note
ワークスペースでサーバーレス コンピューティングパブリック プレビューが有効になっている場合、クエリ履歴には、ノートブックとジョブのサーバーレス コンピューティングで実行されるすべての SQL クエリと Python クエリも含まれます。 「サーバーレス コンピューティングに接続する」を参照してください。
この画面から入手できる情報は、クエリに関する問題のデバッグに役立てることができます。
このセクションでは、UI を使用してクエリ履歴を操作する方法について説明します。 API を使用してクエリ履歴を操作する方法については、Query History API に関する記事を参照してください。
重要
SQL クエリのクエリ履歴に記録される時間は、SQL ウェアハウスでクエリの実際の実行に費やされた時間に過ぎません。 内部キューやデータのアップロードおよびダウンロード プロセスに関連する追加の時間など、クエリの実行の準備に関連する追加のオーバーヘッドは記録されません。
クエリ履歴を表示する
クエリのすべての実行の履歴を表示するには:
- サイドバーの
[Query History] をクリックします。 - 必要に応じて、[期間] をクリックして期間別にリストを並べ替えます。 既定では、リストは開始時刻で並べ替えられます。
- クエリの名前をクリックすると、SQL コマンドや実行の詳細など、詳細情報が表示されます。
ユーザー、サービス プリンシパル、日付範囲、SQL ウェアハウス、クエリの状態で一覧をフィルター処理できます。
CAN_MANAGE アクセス許可のない管理者以外のユーザーの場合は、 Query Historyでのみ独自のクエリを表示できます。
注意
所有者として実行アクセス許可を持つユーザーが、実行可能アクセス許可を持つ別のユーザーに対して共有したクエリは、クエリを実行しているユーザーのクエリ履歴に表示され、クエリを共有したユーザーには表示されません。
クエリの詳細を表示する
実行時間、SQL コマンド、返された行数、I/O パフォーマンスなど、クエリの詳細を表示するには:
クエリ履歴を表示します。
クエリの名前をクリックします。
各タスクに費やされた時間、返された行数、I/O パフォーマンスなど、クエリのパフォーマンスに関する簡単な情報が表示されます。
クエリのパフォーマンスの詳細を確認するには、ページの下部にある [クエリ プロファイルを表示] をクリックします。 詳細については、「クエリ プロファイル」を参照してください。
実行中のクエリを終了する
自分または別のユーザーが開始した実行時間の長いクエリを終了するには:
クエリ履歴を表示します。
クエリの名前をクリックします。
[状態] の横の [キャンセル] をクリックします。
注意
[キャンセル] は、クエリが実行されている場合にのみ表示されます。
クエリが終了し、状態が [キャンセル済み] に変わります。
クエリ履歴システム テーブルにアクセスする
Azure Databricks システム テーブルには、特権ユーザーがアカウント全体から表形式のクエリ履歴レコードを表示できるクエリ履歴テーブル (system.query.history) が含まれています。 既定では、管理者のみがアカウントのシステム テーブルにアクセスできます。 クエリ履歴システム テーブルの有効化とアクセスについては、「クエリ履歴システム テーブル リファレンス」をご覧ください。