クエリ履歴システムテーブルリファレンス
プレビュー
このシステムテーブルは パブリック プレビュー段階です。 テーブルにアクセスするには、 system
カタログでスキーマを有効にする必要があります。 詳細については、「 システムテーブル スキーマを有効にする」を参照してください。
この記事には、テーブルのスキーマの概要を含む、クエリ履歴システムテーブルに関する情報が含まれています。
重要
クエリ履歴システムテーブルにアクセスするには、 query
スキーマを有効にする必要があります。 システム スキーマを有効にする手順については、「システムテーブル スキーマを有効にする」を参照してください。
テーブルパス:このシステムテーブルは system.query.history
にあります。
クエリ履歴テーブルの使用
クエリ履歴テーブルには、ウェアハウスを使用して実行されたすべての SQL ステートメント SQLレコードが含まれます。 このテーブルには、テーブルへのアクセス元と同じリージョン内のすべてのワークスペースのアカウント全体のレコードが含まれます。
デフォルトにより、管理者のみがシステムテーブルにアクセスできます。 テーブルのデータをユーザーまたはグループと共有する場合、Databricks ではユーザーまたはグループごとに動的ビューを作成することをお勧めします。 「動的ビューの作成」を参照してください。
クエリ履歴システムテーブルスキーマ
クエリ履歴テーブルでは、次のスキーマが使用されます。
列名 |
データ型 |
説明 |
例 |
---|---|---|---|
|
文字列 |
アカウントのID。 |
|
|
文字列 |
クエリが実行されたワークスペースの ID。 |
|
|
文字列 |
文の実行を一意に識別する ID。 この ID を使用して、クエリー履歴UI でステートメントの実行を見つけることができます。 |
|
|
文字列 |
Spark セッション ID。 |
|
|
文字列 |
文の終了状態。 可能な値は次のとおりです。
|
|
|
構造体 |
ステートメントの実行に使用されるコンピュート リソースのタイプと、該当する場合はリソースの ID を表す構造体。 |
|
|
文字列 |
ステートメントを実行したユーザーの ID。 |
|
|
文字列 |
ステートメントを実行したユーザーの電子メールアドレスまたはユーザー名。 |
|
|
文字列 |
SQL ステートメントのテキスト。 顧客管理キーを設定している場合、 |
|
|
文字列 |
ステートメントのタイプ。 たとえば、 |
|
|
文字列 |
エラー状態を説明するメッセージ。 顧客管理キーを設定している場合、 |
|
|
文字列 |
文を実行したクライアント・アプリケーション。 たとえば、Databricks SQL エディター、Tableau、Power BI などです。 このフィールドは、クライアント アプリケーションによって提供される情報から取得されます。 値は時間の経過とともに静的なままであることが予想されますが、これは保証できません。 |
|
|
文字列 |
ステートメントを実行するために Databricks に接続するために使用されるコネクタ。 例: Databricks SQL Driver for Go、Databricks ODBC ドライバー、Databricks JDBC ドライバー。 |
|
|
bigint |
ステートメントの合計実行時間(ミリ秒単位)(結果フェッチ時間を除く)。 |
|
|
bigint |
コンピュートリソースが失われるのを待つのに費やされた時間(ミリ秒単位)。 |
|
|
bigint |
使用可能なコンピュート容量をキューで待機するのに費やされた時間(ミリ秒)。 |
|
|
bigint |
ステートメントの実行に費やされた時間 (ミリ秒単位)。 |
|
|
bigint |
メタデータの読み込みとステートメントの最適化に費やされた時間 (ミリ秒単位)。 |
|
|
bigint |
すべてのタスクの所要時間の合計(ミリ秒単位)。 この時間は、すべてのノードのすべてのコアでクエリを実行するのにかかった合計時間を表します。 複数のタスクが並行して実行される場合、実時間よりも大幅に長くなる可能性があります。 タスクが利用可能なノードを待機する場合、ウォールクロック期間よりも短くなることがあります。 |
|
|
bigint |
実行の終了後に文の結果をフェッチするのに費やされた時間 (ミリ秒単位)。 |
|
|
timestamp |
Databricks がリクエストを受信した時刻。 タイムゾーン情報は値の末尾に記録され、 |
|
|
timestamp |
文の実行が終了した時刻 (結果のフェッチ時刻を除く)。 タイムゾーン情報は、 |
|
|
timestamp |
ステートメントが進行状況の更新を最後に受信した時刻。 タイムゾーン情報は値の末尾に記録され、 |
|
|
bigint |
プルーニング後に読み取られたパーティションの数。 |
|
|
bigint |
プルーニングされたファイルの数。 |
|
|
bigint |
プルーニング後に読み取られたファイルの数。 |
|
|
bigint |
文によって読み取られたローの合計数。 |
|
|
bigint |
文によって返されたローの合計数。 |
|
|
bigint |
文によって読み取られたデータの合計サイズ (バイト単位)。 |
|
|
int |
IO キャッシュから読み取られた永続データのバイト数の割合。 |
|
|
ブーリアン |
|
|
|
bigint |
文の実行中に一時的にディスクに書き込まれるデータのサイズ (バイト単位)。 |
|
|
bigint |
クラウド オブジェクト ストレージに書き込まれる永続データのサイズ (バイト単位)。 |
|
|
bigint |
ネットワーク経由で送信されたデータの合計量 (バイト単位)。 |
|
|
構造体 |
このステートメントの実行に関与した 1 つ以上の Databricks エンティティ (ジョブ、ノートブック、ダッシュボードなど) を表すキーと値のペアを含む構造体。 このフィールドは、Databricks エンティティのみを記録します。 |
|
|
文字列 |
文の実行に権限が使用されたユーザーまたはサービスプリンシパルの名前。 |
|
|
文字列 |
ステートメントの実行に特権が使用されたユーザーまたはサービスプリンシパルの ID。 |
|