メインコンテンツまでスキップ

クエリ履歴

クエリ履歴にはSQL 、ウェアハウスを使用して 実行されたクエリ 示されています。クエリ履歴には過去 30 日間のクエリ データが保持され、その後は自動的に削除されます。

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

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

クエリ履歴の表示

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

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

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

注記

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

クエリの詳細を表示する

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

  1. 前のセクションで説明したクエリ履歴にアクセスします。

  2. 表示するクエリテキストをクリックします。右側に概要パネルが開きます。

    クエリ履歴の詳細

    • クエリの状態: クエリには、現在のステータス ( キュー登録済み実行中完了失敗またはキャンセル 済み) のタグが付けられます。
    • ユーザーとコンピュートの詳細: このクエリ実行のユーザー名、コンピュートの種類、ランタイムの詳細を参照してください。
    • 身分証明書: これは、特定のクエリ実行に関連付けられた汎用一意識別子 (UUID) です。
    • クエリステートメント: このセクションには、完全なクエリ ステートメントが含まれています。クエリが長すぎてプレビューに表示できない場合は、 ...全文を表示するための行数が増え ました。
    • Query メトリクス: クエリ分析の一般的なメトリクスは、クエリテキストの下に表示されます。 一部のメトリクスとともに表示されるフィルター アイコンは、スキャン中にプルーニングされたデータの割合を示します。
    • クエリ プロファイルを参照してください。 この概要には、クエリ プロファイル有向非巡回グラフ (DAG) のプレビューが示されています。これは、クエリの複雑さと実行フローをすばやく見積もるのに役立ちます。[ クエリ プロファイルの表示 ] をクリックして、詳細な DAG を開きます。
    • このクエリの最長演算子を参照してください。 このボタンをクリックすると、[ Top operators ] パネルが開きます。このパネルには、クエリで最も長く実行されている演算子が表示されます。
    • 実時間表示のクエリ: スケジューリングの開始からクエリ実行の終了までの経過時間の合計がサマリーとして提供されます。スケジュール設定、クエリの最適化とファイルのプルーニング、および実行時間の詳細な内訳が概要の下に表示されます。
    • クエリソース: リストされたオブジェクトの名前をクリックして、クエリソースに移動します。
    • 集計タスク時間: すべてのノードのすべてのコアでクエリを実行するのにかかった合計時間を表示します。複数のタスクが並行して実行される場合は、ウォールクロックの期間よりも大幅に長くなる可能性があります。タスクが使用可能なノードを待機していた場合は、ウォールクロックの期間よりも短くなる可能性があります。
    • 入力/出力 (IO): クエリの実行中に読み取られたデータと書き込まれたデータの詳細を表示します。
  3. クエリのパフォーマンス (実行プランなど) の詳細については、ページの下部にある [クエリ プロファイルの表示 ] をクリックしてください。 詳細については、「 クエリ プロファイル」を参照してください。

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

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

  1. 前のセクションで説明したクエリ履歴にアクセスします。

  2. クエリ テキストをクリックします。

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

注記

[キャンセル] は、クエリが実行されている場合にのみ表示されます。

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

注記

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

クエリ履歴システムテーブルへのアクセス

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