- スキーマ：
SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY ビュー¶
SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY ビューは、 Snowflake Intelligence の使用履歴をクエリするために使用できます。
注釈
このビューには、Cortex Agentsから発信されたリクエストは含まれません。Cortex Agentsから発信されたリクエストは、:doc:`CORTEX_AGENT_USAGE_HISTORY</sql-reference/account-usage/cortex_agent_usage_history>`ビューに記録されます。
ビュー内の情報には、ユーザーが|sf-intelligence|とやり取りするたびに消費されるクレジット数が含まれます。1つのリクエストに対して、背後で動作するエージェントやツール（例：Cortex AnalystやCortex Search）が、1回または複数回呼び出されます。ビューの各行はエージェントへの呼び出しを表し、呼び出しで集計されたトークンとクレジットの詳細、および詳細な情報が表示されます。ビューには、ユーザーID、リクエストID、Snowflake Intelligence ID、エージェントIDなどの関連するメタデータも含まれます。Cortexの請求について詳しくは、:ref:`label-cortex_agent_cost_considerations`を参照してください。
列¶
列名 |
データ型 |
説明 |
|---|---|---|
START_TIME |
TIMESTAMP_LTZ |
Snowflake Intelligenceメッセージリクエストを受信した開始時間。 |
END_TIME |
TIMESTAMP_LTZ |
Snowflake Intelligenceのメッセージ応答が送信された終了時間。 |
USER_ID |
NUMBER |
リクエストを行ったユーザーの一意の識別子。 |
USER_NAME |
VARCHAR |
リクエストを行ったユーザーの名前。 |
USER_TAGS |
ARRAY |
ユーザーに関連付けられたタグ。配列の各オブジェクトには、次の値のペアが含まれます。
|
REQUEST_ID |
VARCHAR |
リクエストに対する一意の識別子。 |
PARENT_REQUEST_ID |
VARCHAR |
該当する場合は、親リクエストの識別子。 |
SNOWFLAKE_INTELLIGENCE_ID |
NUMBER |
Snowflake Intelligenceインスタンスの一意の識別子。 |
SNOWFLAKE_INTELLIGENCE_NAME |
VARCHAR |
Snowflake Intelligenceインスタンスの名前。 |
SNOWFLAKE_INTELLIGENCE_TAGS |
ARRAY |
Snowflake Intelligenceインスタンスに関連付けられたタグ。配列の各オブジェクトには、次の値のペアが含まれます。
|
AGENT_DATABASE_ID |
NUMBER |
エージェントデータベースの一意の識別子。 |
AGENT_DATABASE_NAME |
VARCHAR |
エージェントデータベースの名前。 |
AGENT_SCHEMA_ID |
NUMBER |
エージェントスキーマの一意の識別子。 |
AGENT_SCHEMA_NAME |
VARCHAR |
エージェントスキーマの名前。 |
AGENT_ID |
NUMBER |
エージェントの一意の識別子。 |
AGENT_NAME |
VARCHAR |
エージェントの名前。 |
AGENT_TAGS |
ARRAY |
エージェントに関連付けられたタグ。配列の各オブジェクトには、次の値のペアが含まれます。
|
TOKEN_CREDITS |
NUMBER |
リクエストに使用されたトークンクレジットの数。ユーザーレベルの予算に使用されます。 |
TOKENS |
NUMBER |
Snowflake Intelligentエージェントが使用するトークンの合計。 |
TOKENS_GRANULAR |
ARRAY |
リクエスト、サービスタイプ（cortex_agents、cortex_analyst）、モデルごとのトークン使用量の詳細な内訳。モデルごとに、入力（input）、キャッシュ読み取り入力（cache_read_input）、キャッシュ書き込み入力（cache_write_input）、および出力（output）のトークン数が含まれます。価格データにモデルが存在しない場合は、「unknown」というモデル名が使用されます。配列の各オブジェクトには、次の値のペアが含まれます。
|
CREDITS_GRANULAR |
ARRAY |
リクエスト、サービスタイプ（cortex_agents、cortex_analyst）、モデルごとのクレジット使用量の詳細な内訳。モデルごとに、入力（input）、キャッシュ読み取り入力（cache_read_input）、キャッシュ書き込み入力（cache_write_input）、および出力（output）のクレジット消費量が含まれます。価格データにモデルが存在しない場合は、「unknown」というモデル名が使用されます。配列の各オブジェクトには、次の値のペアが含まれます。
|
METADATA |
OBJECT |
追加のメタデータ用に予約されています。現在は空です。 |
例¶
|sf-intelligence|使用履歴を取得します。
SELECT *
FROM SNOWFLAKE.ACCOUNT_USAGE.SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY;
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+---------------------------+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
| START_TIME | END_TIME | USER_ID | USER_NAME | USER_TAGS | REQUEST_ID | PARENT_REQUEST_ID | SNOWFLAKE_INTELLIGENCE_ID | SNOWFLAKE_INTELLIGENCE_NAME | SNOWFLAKE_INTELLIGENCE_TAGS | AGENT_DATABASE_ID | AGENT_DATABASE_NAME | AGENT_SCHEMA_ID | AGENT_SCHEMA_NAME | AGENT_ID | AGENT_NAME | AGENT_TAGS | TOKEN_CREDITS | TOKENS | TOKENS_GRANULAR | CREDITS_GRANULAR | METADATA |
|-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+---------------------------+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------|
| 2026-02-06 10:11:51.642 +0000 | 2026-02-06 10:11:55.932 +0000 | 42563 | JKOWAL | [{"level": "ACCOUNT", "tag_database": "SI", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "engineering"}, {"level": "USER", "tag_database": "FINANCE", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "engineering"}] | 9a5bbdce-7427-4166-b839-de8adc81e5cf | NULL | 123456 | finance_analytics_si | [{"level": "ACCOUNT", "tag_database": "SI", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "finance"}, {"level": "SNOWFLAKE_INTELLIGENCE", "tag_database": "FINANCE", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "finance"}] | 234 | finance | 4231 | analytics | 9234 | agent1 | [{"level": "SCHEMA", "tag_database": "SI", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "finance"}, {"level": "CORTEX_AGENT", "tag_database": "FINANCE", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "finance"}] | 20.000000000 | 1900 | [{"9a5bbdce-7427-4166-b839-de8adc81e5cf": {"cortex_agents": {"modelX": {"input": 100, "cache_read_input": 300, "cache_write_input": 400, "output": 200}}, "start_time": "2026-02-06 10:11:51.642 +0000"}}, {"28adaa9a-cbde-4293-bce2-157c807e0dd7": {"cortex_analyst": {"modelY": {"input": 100, "output": 200}, "modelZ": {"input": 100, "output": 200}}, "start_time": "2026-02-06 10:11:52.642 +0000"}}, {"1444950f-6f5b-493f-800c-f62bb307d21c": {"cortex_analyst": {"unknown": {"input": 100, "output": 200}}, "start_time": "2026-02-06 10:11:53.331 +0000"}}] | [{"9a5bbdce-7427-4166-b839-de8adc81e5cf": {"cortex_agents": {"modelX": {"input": 1, "cache_read_input": 2, "cache_write_input": 3, "output": 4}}, "start_time": "2026-02-06 10:11:51.642 +0000"}}, {"28adaa9a-cbde-4293-bce2-157c807e0dd7": {"cortex_agent": {"modelY": {"input": 1, "output": 4}, "modelZ": {"input": 1, "output": 4}}, "start_time": "2026-02-06 10:11:52.642 +0000"}}, {"1444950f-6f5b-493f-800c-f62bb307d21c": {"cortex_analyst": {"unknown": {"input": 0, "output": 0}}, "start_time": "2026-02-06 10:11:53.331 +0000"}}] | {} |
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+---------------------------+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+