Schema:

ACCOUNT_USAGE

Ansicht SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY

Die Ansicht SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY kann zur Abfrage des Nutzungsverlaufs von Snowflake Intelligence verwendet werden.

Bemerkung

Diese Ansicht enthält keine Anforderungen, die von Cortex Agents stammen. Anforderungen, die von Cortex Agents stammen, werden in der CORTEX_AGENT_USAGE_HISTORY-Ansicht erfasst.

Die in der Ansicht enthaltenen Informationen umfassen die Anzahl der Credits, die bei jeder Benutzerinteraktion mit Snowflake Intelligence verbraucht werden. Eine Anforderung führt zu einem oder mehreren Aufrufen der zugrunde liegenden Agenten und beliebigen Tools, z. B. Cortex Analyst und Cortex Search. Jede Zeile in der Ansicht stellt einen Aufruf an den Agenten dar und enthält Details zu den aggregierten Token und Credits des Aufrufs sowie detaillierte Details. Die Ansicht enthält auch relevante Metadaten, wie z. B. die Benutzer-ID, Anforderungs-ID, Snowflake Intelligence-ID und Agenten-ID. Weitere Informationen zur Cortex-Abrechnung finden Sie unter Hinweise zu Kosten.

Spalten

Spaltenname

Datentyp

Beschreibung

START_TIME

TIMESTAMP_LTZ

Startzeit, zu der die Snowflake Intelligence-Nachrichtenanforderung empfangen wurde.

END_TIME

TIMESTAMP_LTZ

Endzeit, zu der die Snowflake Intelligence-Nachrichtenantwort gesendet wurde.

USER_ID

NUMBER

Der eindeutige Bezeichner des Benutzenden, der die Anforderung gestellt hat.

USER_NAME

VARCHAR

Der Name des Benutzenden, der die Anforderung gestellt hat.

USER_TAGS

ARRAY

Tags, die dem Benutzenden zugeordnet sind. Jedes Objekt im Array enthält die folgenden Wert-Paare:

  • level: Die Ebene, auf der das Tag angewendet wird (z. B. „ACCOUNT“ oder „USER“).

  • tag_database: Die Datenbank, in der das Tag definiert ist.

  • tag_schema: Das Schema, in dem das Tag definiert ist.

  • tag_name: Der Name des Tags.

  • tag_value: Der Wert des Tags.

REQUEST_ID

VARCHAR

Der eindeutige Bezeichner der Anforderung.

PARENT_REQUEST_ID

VARCHAR

Der Bezeichner der übergeordneten Anforderung, falls zutreffend.

SNOWFLAKE_INTELLIGENCE_ID

NUMBER

Der eindeutige Bezeichner der Snowflake Intelligence-Instanz.

SNOWFLAKE_INTELLIGENCE_NAME

VARCHAR

Der Name der Snowflake Intelligence-Instanz.

SNOWFLAKE_INTELLIGENCE_TAGS

ARRAY

Tags, die mit der Snowflake Intelligence-Instanz verknüpft sind. Jedes Objekt im Array enthält die folgenden Wert-Paare:

  • level: Die Ebene, auf der das Tag angewendet wird (z. B. „ACCOUNT“ oder „SNOWFLAKE_INTELLIGENCE“).

  • tag_database: Die Datenbank, in der das Tag definiert ist.

  • tag_schema: Das Schema, in dem das Tag definiert ist.

  • tag_name: Der Name des Tags.

  • tag_value: Der Wert des Tags.

AGENT_DATABASE_ID

NUMBER

Der eindeutige Bezeichner der Agentendatenbank.

AGENT_DATABASE_NAME

VARCHAR

Der Name der Agentendatenbank.

AGENT_SCHEMA_ID

NUMBER

Der eindeutige Bezeichner des Agentenschemas.

AGENT_SCHEMA_NAME

VARCHAR

Der Name des Agentenschemas.

AGENT_ID

NUMBER

Der eindeutige Bezeichner des Agenten.

AGENT_NAME

VARCHAR

Der Name des Agenten.

AGENT_TAGS

ARRAY

Tags, die dem Agenten zugeordnet sind. Jedes Objekt im Array enthält die folgenden Wert-Paare:

  • level: Die Ebene, auf der das Tag angewendet wird (z. B. „SCHEMA“ oder „CORTEX_AGENT“).

  • tag_database: Die Datenbank, in der das Tag definiert ist.

  • tag_schema: Das Schema, in dem das Tag definiert ist.

  • tag_name: Der Name des Tags.

  • tag_value: Der Wert des Tags.

TOKEN_CREDITS

NUMBER

Die Anzahl der für die Anforderung verwendeten Token-Credits. Wird für die Budgetierung auf Benutzerebene verwendet.

TOKENS

NUMBER

Summe der vom Snowflake Intelligence-Agenten verwendeten Token.

TOKENS_GRANULAR

ARRAY

Detaillierte Aufschlüsselung der Token-Nutzung nach Anfrage, Diensttyp (cortex_agents, cortex_analyst) und Modell. Beinhaltet die Zählungen für Eingabe, cache_read_input, cache_write_input und Ausgabe-Token pro Modell. Der „unbekannte“ Modellname wird verwendet, wenn ein Modell nicht in den Preisdaten vorhanden ist. Jedes Objekt im Array enthält die folgenden Wert-Paare:

  • request_id: Der eindeutige Bezeichner der Anforderung.

  • service_type: Der Diensttyp, z. B. „cortex_agents“ oder „cortex_analyst“.

  • model: Der für die Anforderung verwendete Modellname.

  • input: Anzahl der Eingabe-Token.

  • cache_read_input: Anzahl der Eingabe-Token für den Lesecache.

  • cache_write_input: Anzahl der Eingabe-Token für den Schreibcache.

  • output: Anzahl der Ausgabe-Token.

  • start_time: Die Startzeit der Anforderung.

CREDITS_GRANULAR

ARRAY

Detaillierte Aufschlüsselung der Credit-Nutzung nach Anfrage, Diensttyp (cortex_agents, cortex_analyst) und Modell. Beinhaltet die Werte für Eingabe, cache_read_input, cache_write_input und Ausgabe von Credits pro Modell. Der „unbekannte“ Modellname wird verwendet, wenn ein Modell nicht in den Preisdaten vorhanden ist. Jedes Objekt im Array enthält die folgenden Wert-Paare:

  • request_id: Der eindeutige Bezeichner der Anforderung.

  • service_type: Der Diensttyp, z. B. „cortex_agents“ oder „cortex_analyst“.

  • model: Der für die Anforderung verwendete Modellname.

  • input: Credit-Wert für Eingabe-Token.

  • cache_read_input: Credit-Wert für Eingabe-Token im Lesecache.

  • cache_write_input: Credit-Wert für Eingabe-Token im Schreibcache.

  • output: Credit-Wert für Ausgabe-Token.

  • start_time: Die Startzeit der Anforderung.

METADATA

OBJECT

Reserviert für zusätzliche Metadaten. Derzeit leer.

Beispiele

Abrufen des Nutzungsverlaufs von Snowflake Intelligence:

SELECT *
  FROM SNOWFLAKE.ACCOUNT_USAGE.SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY;
Copy
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+---------------------------+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
| 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"}}] | {}       |
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+---------------------------+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+