Delta Live Tables パイプラインのクエリ履歴にアクセスする

この記事では、Delta Live Tables パイプラインの実行に関連付けられているクエリ履歴とクエリプロファイルにアクセスする方法について説明します。この情報を使用して、クエリのデバッグ、パフォーマンスのボトルネックの特定、パイプラインの実行の最適化を行うことができます。

プレビュー

この機能はパブリックプレビュー段階です。ワークスペース管理者は、プレビューページからこの機能を有効にできます。「Databricksプレビューの管理」を参照してください。

要件

パイプラインは 、プレビュー チャンネルで実行するように設定する必要があります。「 Delta Live Tables ランタイムチャンネル」を参照してください。
パイプラインは 、トリガー モードで実行するように設定する必要があります。

パイプラインの更新のクエリ履歴を確認する

要件を満たすすべてのパイプラインについて、具体化されたビューとストリーミングテーブルが更新されると、クエリステートメントがクエリ履歴に表示されます。ターゲットテーブルを更新するフロー実行ごとに 1 つの REFRESH ステートメントがあります。クエリ履歴ページの コンピュート フィルターを使用すると、コンピュートを使用して処理されたクエリのみ Delta Live Tables 表示できます。クエリ履歴 UI の詳細については、「クエリ履歴」を参照してください。

クエリの詳細にアクセスするには、次の手順を実行します。

サイドバー [クエリー履歴 ] をクリックします。
コンピュートドロップダウンフィルターからDLTチェックボックスを選択します。
クエリステートメントをクリックすると、クエリの実行時間や集計されたメトリクスなどの概要の詳細が表示されます。
[ クエリプロファイルの表示 ] をクリックして、クエリプロファイルを開きます。クエリプロファイルの詳細については、クエリプロファイルを参照してください。
必要に応じて、[ クエリソース ] セクションのリンクを使用して、関連するパイプラインを開きます。

ノートブックからのクエリ履歴へのアクセス

Delta Live Tables パイプラインにアタッチされたノートブック内からクエリ履歴を表示するには、次の手順を使用します。

ノートブックを開きます。ノートブックが Delta Live Tables パイプラインに接続されている場合は、パイプラインを検査するためのインターフェイスがノートブックの下部に表示されます。「ノートブックでの Delta Live Tables パイプラインの開発とデバッグ」を参照してください。
[DLT クエリ履歴] タブをクリックします。
クエリの名前をクリックすると、期間、クエリソース、その他の集計メトリクスなど、クエリの詳細が表示されます。このビューで使用できる詳細の詳細については、「クエリの詳細を表示する」を参照してください。

Delta Live Tables パイプライン UI からクエリ履歴にアクセスする

UI の[パイプライン Delta Live Tablesの詳細] ページで、画面下部にある[クエリ履歴] タブをクリックして、パイプラインの履歴にアクセスします。クエリの詳細パネルとプロファイルを表示するには、ステートメントをクリックします。

制限事項

プロビジョニング時間とキューイング時間は使用できません。
クエリの詳細パネルに表示されるメトリクスは、フローの実行中にライブで更新されますが、クエリプロファイルはフローの実行が完了した後にのみ更新されます。