クエリ履歴システムテーブルリファレンス
プレビュー
このシステムテーブルは パブリック プレビュー段階です。 テーブルにアクセスするには、 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 |
ネットワーク経由で送信されたデータの合計量 (バイト単位)。 |
|