スキーマ:

ACCOUNT_USAGEREADER_ACCOUNT_USAGE

QUERY_HISTORY ビュー

このアカウント使用状況ビューを使用して、過去365日(1年)内のさまざまなディメンション(時間範囲、セッション、ユーザー、ウェアハウスなど)でSnowflakeクエリ履歴をクエリできます。

ビューは ACCOUNT_USAGE と READER_ACCOUNT_USAGE の両方のスキーマで使用できますが、次の違いがあります。

  • 次の列は、リーダーアカウントビューで のみ で利用できます。

    • READER_ACCOUNT_NAME

  • 次の列は、リーダーアカウントビューでは提供 されません

    • CLUSTER_NUMBER

    • BYTES_SCANNED

    • ROWS_PRODUCED

    • OUTBOUND_DATA_TRANSFER_CLOUD

    • INBOUND_DATA_TRANSFER_CLOUD

    • INBOUND_DATA_TRANSFER_REGION

    • INBOUND_DATA_TRANSFER_BYTES

こちらもご参照ください:

QUERY_HISTORY , QUERY_HISTORY_BY_* (情報スキーマ表関数)

列名

データ型

説明

READER_ACCOUNT_NAME

TEXT

SQL ステートメントが実行されたリーダーアカウントの名前。

QUERY_ID

TEXT

SQL ステートメントの内部/システム生成識別子。

QUERY_TEXT

TEXT

SQL ステートメントのテキスト。

DATABASE_ID

NUMBER

使用されていたデータベースの内部/システム生成識別子。

DATABASE_NAME

TEXT

クエリ時に使用されていたデータベース。

SCHEMA_ID

NUMBER

使用されていたスキーマの内部/システム生成識別子。

SCHEMA_NAME

TEXT

クエリ時に使用されていたスキーマ。

QUERY_TYPE

TEXT

DML、クエリなど。クエリが現在実行中の場合、またはクエリが失敗した場合、クエリタイプは UNKNOWNになります。

SESSION_ID

NUMBER

ステートメントを実行したセッション。

USER_NAME

TEXT

クエリを発行したユーザー。

ROLE_NAME

TEXT

クエリの時点でセッションでアクティブだったロール。

WAREHOUSE_ID

NUMBER

使用されたウェアハウスの内部/システム生成識別子。

WAREHOUSE_NAME

TEXT

クエリが実行されたウェアハウス(ある場合)。

WAREHOUSE_SIZE

TEXT

このステートメントが実行されたときのウェアハウスのサイズ。

WAREHOUSE_TYPE

TEXT

このステートメントが実行されたときのウェアハウスのタイプ。

CLUSTER_NUMBER

NUMBER

このステートメントが実行されたクラスター(マルチクラスターウェアハウス内)。

QUERY_TAG

TEXT

QUERY_TAG セッションパラメーターを介してこのステートメントに設定されたクエリタグ。

EXECUTION_STATUS

TEXT

クエリの実行ステータス:成功、失敗、インシデント。

ERROR_CODE

NUMBER

クエリがエラーを返した場合のエラーコード

ERROR_MESSAGE

TEXT

クエリがエラーを返した場合のエラーメッセージ

START_TIME

TIMESTAMP_LTZ

ステートメントの開始時間( UTC タイムゾーン)

END_TIME

TIMESTAMP_LTZ

ステートメント終了時間( UTC タイムゾーン)、またはステートメントがまだ実行中の場合は NULL 。

TOTAL_ELAPSED_TIME

NUMBER

経過時間(単位:ミリ秒)

BYTES_SCANNED

NUMBER

このステートメントによってスキャンされたバイト数。

PERCENTAGE_SCANNED_FROM_CACHE

FLOAT

ローカルディスクキャッシュからスキャンされたデータの割合。

BYTES_WRITTEN

NUMBER

書き込まれたバイト数(例:テーブルへのロード時)。

BYTES_WRITTEN_TO_RESULT

NUMBER

結果オブジェクトに書き込まれるバイト数。

BYTES_READ_FROM_RESULT

NUMBER

結果オブジェクトから読み取ったバイト数。

ROWS_PRODUCED

NUMBER

このステートメントによって生成された行の数。

ROWS_INSERTED 1

NUMBER

クエリによって挿入された行の数。

ROWS_UPDATED 1

NUMBER

クエリによって更新された行の数。

ROWS_DELETED 1

NUMBER

クエリによって削除された行の数。

ROWS_UNLOADED 1

NUMBER

データのエクスポート中にアンロードされた行の数。

BYTES_DELETED 1

NUMBER

クエリによって削除されたバイト数。

PARTITIONS_SCANNED

NUMBER

スキャンされたマイクロパーティションの数。

PARTITIONS_TOTAL

NUMBER

このクエリに含まれるすべてのテーブルのマイクロパーティション合計。

BYTES_SPILLED_TO_LOCAL_STORAGE

NUMBER

ローカルディスクにスピルしたデータの量。

BYTES_SPILLED_TO_REMOTE_STORAGE

NUMBER

リモートディスクにスピルしたデータの量。

BYTES_SENT_OVER_THE_NETWORK

NUMBER

ネットワーク経由で送信されたデータの量。

COMPILATION_TIME

NUMBER

コンパイル時間(ミリ秒)

EXECUTION_TIME

NUMBER

実行時間(ミリ秒)

QUEUED_PROVISIONING_TIME

NUMBER

ウェアハウスの作成、再開、またはサイズ変更のために、ウェアハウスサーバーでのプロビジョニングを待機する、ウェアハウスキューで費やされた時間(ミリ秒単位)。

QUEUED_REPAIR_TIME

NUMBER

ウェアハウス内のサーバーの修復を待機する、ウェアハウスキュー内で費やされた時間(ミリ秒単位)。

QUEUED_OVERLOAD_TIME

NUMBER

ウェアハウスが現在のクエリワークロードによって過負荷になっているため、ウェアハウスキューで費やされた時間(ミリ秒)。

TRANSACTION_BLOCKED_TIME

NUMBER

同時 DMLによってブロックされた時間(ミリ秒)。

OUTBOUND_DATA_TRANSFER_CLOUD

TEXT

データを別の地域やクラウドにアンロードするステートメントのターゲットクラウドプロバイダー。

OUTBOUND_DATA_TRANSFER_REGION

TEXT

データを別の地域やクラウドにアンロードするステートメントのターゲット地域。

OUTBOUND_DATA_TRANSFER_BYTES

NUMBER

別の地域やクラウドにデータをアンロードするステートメントで転送されたバイト数。

INBOUND_DATA_TRANSFER_CLOUD

TEXT

別の地域やクラウドからデータをロードするステートメントのソースクラウドプロバイダー。

INBOUND_DATA_TRANSFER_REGION

TEXT

別の地域やクラウドからデータをロードするステートメントのソース地域。

INBOUND_DATA_TRANSFER_BYTES

NUMBER

別の地域やクラウドからデータをロードするステートメントで転送されたバイト数。

LIST_EXTERNAL_FILES_TIME

NUMBER

外部ファイルのリストに費やされた時間(ミリ秒)。

CREDITS_USED_CLOUD_SERVICES

NUMBER

時間内にクラウドサービスのために使用されたクレジットの数。

RELEASE_VERSION

NUMBER

メジャーリリース.マイナーリリース.パッチリリース の形式のリリースバージョン。

EXTERNAL_FUNCTION_TOTAL_INVOCATIONS

NUMBER

このクエリがリモートサービスを呼び出した回数の合計。重要な詳細については、使用上の注意をご参照ください。

EXTERNAL_FUNCTION_TOTAL_SENT_ROWS

NUMBER

このクエリが、すべてのリモートサービスに対してすべての呼び出しで送信した行の総数。

EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS

NUMBER

このクエリが、すべてのリモートサービスに対してすべての呼び出しから受信した行の総数。

EXTERNAL_FUNCTION_TOTAL_SENT_BYTES

NUMBER

このクエリが、すべてのリモートサービスに対してすべての呼び出しで送信したバイトの総数。

EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES

NUMBER

このクエリが、すべてのリモートサービスに対してすべての呼び出しから受信したバイトの総数。

QUERY_LOAD_PERCENT

NUMBER

このクエリがウェアハウスにかける負荷の割合。

1(1,2,3,4,5)

これらのフィールドには、2020年1月18日以降に実行されたクエリのデータのみが表示されます。

使用上の注意

  • ビューの待機時間は最大45分です。

  • 列 EXTERNAL_FUNCTION_TOTAL_INVOCATIONS、 EXTERNAL_FUNCTION_TOTAL_SENT_ROWS、 EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS、 EXTERNAL_FUNCTION_TOTAL_SENT_BYTES、および EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES の値は、多くの要因の影響を受けます。要因には次のようなものがあります。

    • SQL ステートメント内の外部関数の数。

    • 各リモートサービスに送信されたバッチあたりの行数。

    • 一時的なエラーによる再試行の数(例:予期した時間内に応答の受信がなかったため)。