スキーマ：: ACCOUNT_USAGE

CORTEX_AISQL_USAGE_HISTORY ビュー¶

CORTEX_AISQL_USAGE_HISTORY ビューを使用して、 Cortex AI 関数の使用履歴をクエリできます。

このビューの情報には、AI 関数の呼び出しごとに消費されたクレジット数が含まれています。これは、各クエリの完了時間に基づいて、1時間単位で集計されます。ビューには、ユーザー ID、クエリ ID、関数、モデルなどの関連するメタデータも含まれます。ビューの各行は、関数、モデル、クエリ、ウェアハウスの特定の組み合わせの使用状況を表します。Cortexの請求に関する詳細については、コストの考慮事項をご参照ください。

重要

このビューは、 CORTEX_FUNCTIONS_USAGE_HISTORY ビューと CORTEX_FUNCTIONS_QUERY_USAGE_HISTORY ビューの両方を置き換えます。

列¶

列名	データ型	説明
USAGE_TIME	TIMESTAMP_LTZ	この使用状況の記録が請求された日付と開始時間（ローカルタイムゾーン）。使用状況はクエリが完了するまで記録されないため、このタイムスタンプはクエリが完了した時間を表します。たとえば、クエリが05:30に開始されて08:30に完了する場合、記録は08:00-09:00の時間に集計されます。
MODEL_NAME	TEXT	クエリで使用されるモデルの名前。クエリは複数のモデルを使用することができます。この場合、使用履歴には各モデルの行が含まれます。
FUNCTION_NAME	TEXT	呼び出したCortex AI 関数の名前。クエリは複数の関数を使用することができます。この場合、使用履歴には各関数の行が含まれます。
TOKEN_CREDITS	NUMBER	QUERY_ID、MODEL_NAME、WAREHOUSE_ID の組み合わせごとに、特定の関数およびモデルについて処理されたトークンに基づく、Cortex AI 関数の使用状況に対する請求クレジット数。ウェアハウス使用クレジットは含まれません。
TOKENS	NUMBER	QUERY_ID、MODEL_NAME、WAREHOUSE_ID の組み合わせごとに、特定の関数およびモデルについて処理されたトークンの数。
TOKEN_CREDITS_GRANULAR	OBJECT	QUERY_ID、MODEL_NAME、WAREHOUSE_ID の組み合わせごとに、特定の関数およびモデルについて、トークンタイプ（入力または出力）ごとに請求されたクレジットの内訳を提供する SQL オブジェクト。
TOKENS_GRANULAR	OBJECT	QUERY_ID、MODEL_NAME、WAREHOUSE_ID の組み合わせごとに、特定の関数およびモデルについて、トークンタイプ（入力または出力）ごとに処理されたトークンの内訳を提供する SQL オブジェクト。
QUERY_ID	TEXT	関数を呼び出したクエリの ID。
QUERY_TAG	TEXT	関数を呼び出したクエリに関連付けられたタグ（ある場合）。
USER_ID	TEXT	関数を呼び出したユーザーの内部 ID。認証コードの詳細については、サーバーへの認証をご参照ください。
WAREHOUSE_ID	TEXT	関数を呼び出したクエリを処理した仮想ウェアハウスの ID。

使用上の注意¶

このビューには、2025年11月17日以降に発生した使用状況のみが含まれます。
請求はクエリが完了した後にのみ報告されます。タイムスタンプはクエリが完了した時間です。
クレジットの使用状況は、 Snowflakeサービス利用表に概説されているように、処理されたトークンの数に基づいています。