スキーマ：: ACCOUNT_USAGE

CORTEX_AI_FUNCTIONS_USAGE_HISTORY ビュー¶

このアカウント使用状況ビューを使用して、:doc:`Cortex AI関数</user-guide/snowflake-cortex/aisql>`の使用履歴をクエリできます。

ビューには、Cortex関数が呼び出されるたびに消費されるトークンとクレジットの数が1時間単位で集計されて表示されます。また、ウェアハウスの ID、関数実行の開始時刻と終了時刻、関数名とモデル名(指定された場合)などのメタデータも表示されます。各行は、単一の関数呼び出しの使用状況を表します。

列¶

列名	データ型	説明
START_TIME	TIMESTAMP_LTZ	使用量集計ウィンドウの開始時間。ウィンドウの単位は1時間です。例えば、クエリが 05:30 に開始され 08:30 に完了した場合、使用量ビューには 5:00、6:00、7:00、および 8:00 の各集計ウィンドウに対応する4つのレコードが表示されます。
END_TIME	TIMESTAMP_LTZ	使用量集計ウィンドウの終了時間。
FUNCTION_NAME	VARCHAR	呼び出されたCortex AI関数の名前。使用履歴には、クエリで呼び出された各関数の行が含まれます。
MODEL_NAME	VARCHAR	モデルの名前。モデルが引数として指定されていないCortex AI関数の場合は空になります。使用履歴には、クエリで使用された各モデルの行が含まれます。
QUERY_ID	VARCHAR	関数を呼び出したクエリの ID。
WAREHOUSE_ID	NUMBER	Cortex AI関数を呼び出すクエリで使用される、システム生成のウェアハウス識別子。
ROLE_NAMES	ARRAY	クエリに関連付けられたロール。プライマリロールは配列の最初の要素です。
QUERY_TAG	VARCHAR	関数を呼び出したクエリに関連付けられたタグ（ある場合）。
USER_ID	VARCHAR	Cortex AI関数を呼び出すクエリを実行したユーザーに対するシステム生成の識別子。
METRICS	ARRAY	QUERY_ID、MODEL_NAME、WAREHOUSE_IDの組み合わせごとに、指定された関数とモデルの使用量メトリックを分類した内訳。詳細については、以下の`メトリック列`_を参照してください。
CREDITS	NUMBER	QUERY_ID、MODEL_NAME、WAREHOUSE_IDの組み合わせごとに、特定の関数およびモデルのメトリックに基づいて請求される、Cortex AI関数のクレジット消費量。ウェアハウス使用クレジットは含まれません。
IS_COMPLETED	BOOLEAN	その集計ウィンドウでクエリが完了したかどうか。

メトリック列¶

メトリック列には、QUERY_ID、MODEL_NAME、WAREHOUSE_IDの組み合わせごとに、指定された関数とモデルの使用量メトリックを分類した内訳が含まれます。各要素には、``key``オブジェクト（``metric``型および``unit``フィールド）と``value``が含まれます。構造は計測方法によって以下のように異なります。

**トークンベースの計測**（ほとんどのAI関数）：使用する関数に応じて、入力と出力のトークン数を個別に集計して課金されるか、合計トークン数に基づいて課金されます。

例: [{"key":{"metric":"input","unit":"tokens"},"value":17},{"key":{"metric":"output","unit":"tokens"},"value":65}]`<br>`[{"key":{"metric":"total","unit":"tokens"},"value":527}]
**ページベースの計測**（AI_PARSE_DOCUMENT）：ページ単位で請求されます。

例: [{"key":{"metric":"total","unit":"pages"},"value":3}]

使用上の注意¶

このビューには、2026年1月5日以降に発生した使用量のみが含まれます。
ユーザーID属性、クエリタグ、およびロールの各フィールドは、2026年2月16日を過ぎた後に取得されたデータで利用可能です。
このビューは、直近の365日(1年)内のアカウントの最新のクレジット使用状況を表示します。
このビューは、完了した関数呼び出しとまだ進行中の呼び出しの両方を追跡します。
実行中のクエリは、30分ごと（ベストエフォート）に更新されます。SLAは1時間です。
クレジットの使用状況は、呼び出した関数、使用したモデル、処理したトークンに基づき、 Snowflake Service Consumption Table に概説する方法で算出されます。