次の方法で共有

クエリの履歴

注

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

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

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

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

クエリ履歴を表示する

クエリの所有者である場合は、以前のクエリの実行を表示できます。 他のユーザーは、少なくとも、クエリを実行した SQL ウェアハウスへの表示可能アクセス権がある場合は、クエリの実行を表示できます。

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

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

注

所有者として実行アクセス許可を持つユーザーが、実行可能アクセス許可を持つ別のユーザーに対して共有した Databricks SQL クエリは、クエリを実行しているユーザーのクエリ履歴に表示され、クエリを共有したユーザーには表示されません。

クエリの詳細を表示する

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

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

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

    クエリ履歴の詳細

    • クエリの状態:クエリには、現在の状態 (Queued、Running、Finished、Failed、Cancelled) がタグ付けされています。
    • ユーザーとコンピューティングの詳細: このクエリ実行のユーザー名、コンピューティングの種類、ランタイムの詳細を参照してください。
    • ID: これは、所定のクエリ実行に関連付けられている汎用一意識別子 (UUID) です。
    • クエリ ステートメント: このセクションには、完全なクエリ ステートメントが含まれています。 クエリが長すぎてプレビューに表示できない場合は、[ ...さらに行 を追加して、フルテキストを表示します。
    • クエリ メトリック: クエリ分析の一般的なメトリックがクエリ テキストの下に表示されます。 一部のメトリックと共に表示されるフィルター アイコンは、スキャン中に排除されたデータの割合を示します。
    • クエリ プロファイルを参照してください。 この概要には、クエリ プロファイルの有向非循環グラフ (DAG) のプレビューが表示されます。 これは、クエリの複雑さと実行フローをすばやく見積もる場合に役立ちます。 詳細な DAG を開くには、[ クエリ プロファイルの表示 ] をクリックします。
    • このクエリの最長演算子を参照してください。 [ トップ演算子 ] パネルを開くには、このボタンをクリックします。 このパネルには、クエリの実行時間が最も長い演算子が表示されます。
    • クエリの実時間: スケジュールの開始からクエリ実行の終了までの合計経過時間が、概要として提供されます。 スケジュール、クエリの最適化、ファイルの排除、実行時間の詳細な内訳が概要の下に表示されます。
    • クエリ ソース: 表示されているオブジェクトの名前をクリックして、クエリ ソースに移動します。
    • 集計されたタスク時間: すべてのノードのすべてのコアでクエリの実行にかかった合計時間を表示します。 複数のタスクが並列に実行されると、ウォールクロック時間よりも大幅に長くなる可能性があります。 タスクが使用可能なノードを待機した場合は、実時間よりも短い値である可能性があります。
    • 入出力 (IO): クエリの実行中に読み取られ、書き込まれたデータに関する詳細を表示します。

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

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

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

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

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

  3. [状態] の横の [キャンセル] をクリックします。

    注

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

クエリが終了し、その状態が Canceled に変わります。

注

Lakeflow 宣言型パイプライン コンピューティングを使用するステートメントは、Pipelines UI からのみ取り消すことができます。

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

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