スキーマ：: ACCOUNT_USAGE 、 READER_ACCOUNT_USAGE

QUERY_HISTORY ビュー¶

このAccount Usageビューを使用して、過去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_ACCELERATION_BYTES_SCANNED
- QUERY_ACCELERATION_PARTITIONS_SCANNED
- QUERY_ACCELERATION_UPPER_LIMIT_SCALE_FACTOR

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

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	クエリの実行ステータス。有効な値: `success`、 `fail`、 `incident`。
ERROR_CODE	NUMBER	クエリがエラーを返した場合のエラーコード
ERROR_MESSAGE	TEXT	クエリがエラーを返した場合のエラーメッセージ
START_TIME	TIMESTAMP_LTZ	ステートメントの開始時間（ UTC タイムゾーン）
END_TIME	TIMESTAMP_LTZ	ステートメントの終了時刻（UTC タイムゾーン）。
TOTAL_ELAPSED_TIME	NUMBER	経過時間（単位：ミリ秒）
BYTES_SCANNED	NUMBER	このステートメントによってスキャンされたバイト数。
PERCENTAGE_SCANNED_FROM_CACHE	FLOAT	ローカルディスクキャッシュからスキャンされたデータの割合。値は0.0〜1.0の範囲です。真のパーセントを得るために、100を掛けます。
BYTES_WRITTEN	NUMBER	書き込まれたバイト数（例：テーブルへのロード時）。
BYTES_WRITTEN_TO_RESULT	NUMBER	結果オブジェクトに書き込まれるバイト数。たとえば、 `select * from . . .` は、選択範囲の各フィールドを表す表形式の結果のセットを生成します。 . . 一般に、結果オブジェクトはクエリの結果として生成されたものを表し、 `BYTES_WRITTEN_TO_RESULT` は返された結果のサイズを表します。
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	`major_release.minor_release.patch_release` の形式のリリースバージョン。
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	このクエリ実行に対するウェアハウス内のアクティブなコンピューティングリソースのおおよその割合。
IS_CLIENT_GENERATED_STATEMENT	BOOLEAN	クエリがクライアントによって生成されたかどうかを示します。
QUERY_ACCELERATION_BYTES_SCANNED	NUMBER	Query Acceleration Service によってスキャンされたバイト数。
QUERY_ACCELERATION_PARTITIONS_SCANNED	NUMBER	Query Acceleration Serviceによってスキャンされたパーティションの数。
QUERY_ACCELERATION_UPPER_LIMIT_SCALE_FACTOR	NUMBER	クエリが受けたであろうメリットの上限スケールファクター。
CHILD_QUERIES_WAIT_TIME	NUMBER	メモ化可能な関数を呼び出すときに、キャッシュされたルックアップが完了するまでの時間（ミリ秒単位）。
OWNER	TEXT	クエリ時点におけるセッション内のアクティブだったロールを所有するロールの名前。
OWNER_ROLE_TYPE	TEXT	オブジェクトを所有するロールの型（`ROLE` または `DATABASE_ROLE`）。削除されたオブジェクトには所有者のロールがないため、オブジェクトを削除すると、Snowflakeは NULL を返すことに注意してください。
TRANSACTION_ID	NUMBER	ステートメントを含むトランザクションの ID。ステートメントがトランザクション内で実行されない場合は0。
ROLE_TYPE	VARCHAR	`ROLE` または `DATABASE_ROLE` がクエリを実行したかどうかを指定します。

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 ステートメント内の外部関数の数。
- 各リモートサービスに送信されたバッチあたりの行数。
- 一時エラーによる再試行の数（例: 予期した時間内に応答の受信がなかったため）。
デフォルトでは、CHILD_QUERIES_WAIT_TIME 列は出力に含まれません。

列を含めるには、 2023_01 動作変更リリースバンドルを有効にする必要があります。

動作変更リリースバンドルを有効にする方法については、動作変更の管理をご参照ください。