Schéma :

ACCOUNT_USAGE

Vue SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY

La vue SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY peut être utilisée pour interroger l’historique de Snowflake Intelligence.

Note

Cette vue ne comprend pas les demandes provenant des Agents Corte. Les requêtes provenant des Agents Cortex sont enregistrées dans la vue CORTEX_AGENT_USAGE_HISTORY.

Les informations de la vue incluent le nombre de crédits consommés chaque fois qu’un utilisateur interagit avec Snowflake Intelligence. Une requête entraîne un ou plusieurs appels aux agents sous-jacents et aux autres outils (par exemple, Cortex Analyst et Cortex Search). Chaque ligne de la vue représente un appel à l’agent et fournit des détails sur les jetons et les crédits agrégés dans l’appel, ainsi que des détails granulaires. La vue comprend également des métadonnées pertinentes, comme l’ID utilisateur, l’ID de requête, l’ID Snowflake Intelligence et l’ID d’agent. Pour plus d’informations sur la facturation Cortex, consultez Considérations relatives aux clients.

Colonnes

Nom de la colonne

Type de données

Description

START_TIME

TIMESTAMP_LTZ

Heure de début à laquelle la requête du message Snowflake Intelligence a été reçue.

END_TIME

TIMESTAMP_LTZ

Heure de fin à laquelle la réponse du message Snowflake Intelligence a été envoyée.

USER_ID

NUMBER

Identificateur unique de l’utilisateur qui a fait la demande.

USER_NAME

VARCHAR

Nom de l’utilisateur qui a fait la demande.

USER_TAGS

ARRAY

Balises associées à l’utilisateur. Chaque objet du tableau contient les paires de valeurs suivantes :

  • level : Niveau auquel la balise est appliquée (par exemple « ACCOUNT » ou « USER »).

  • tag_database : Base de données où la balise est définie.

  • tag_schema : Schéma où la balise est définie.

  • tag_name : Nom de la balise.

  • tag_value : La valeur de la balise.

REQUEST_ID

VARCHAR

L’identificateur unique de la demande.

PARENT_REQUEST_ID

VARCHAR

Identificateur de la requête parente, le cas échéant.

SNOWFLAKE_INTELLIGENCE_ID

NUMBER

Identificateur unique de l’instance Snowflake Intelligence.

SNOWFLAKE_INTELLIGENCE_NAME

VARCHAR

Nom de l’instance Snowflake Intelligence.

SNOWFLAKE_INTELLIGENCE_TAGS

ARRAY

Balises associées à l’instance Snowflake Intelligence. Chaque objet du tableau contient les paires de valeurs suivantes :

  • level : Niveau auquel la balise est appliquée (par exemple « ACCOUNT » ou « SNOWFLAKE_INTELLIGENCE »).

  • tag_database : Base de données où la balise est définie.

  • tag_schema : Schéma où la balise est définie.

  • tag_name : Nom de la balise.

  • tag_value : La valeur de la balise.

AGENT_DATABASE_ID

NUMBER

Identificateur unique de la base de données de l’agent.

AGENT_DATABASE_NAME

VARCHAR

Nom de la base de données de l’agent.

AGENT_SCHEMA_ID

NUMBER

Identificateur unique du schéma de l’agent.

AGENT_SCHEMA_NAME

VARCHAR

Nom du schéma de l’agent.

AGENT_ID

NUMBER

Identificateur unique de l’agent.

AGENT_NAME

VARCHAR

Nom de l’agent.

AGENT_TAGS

ARRAY

Balises associées à l’agent. Chaque objet du tableau contient les paires de valeurs suivantes :

  • level : Niveau auquel la balise est appliquée (par exemple « SCHEMA » ou « CORTEX_AGENT »).

  • tag_database : Base de données où la balise est définie.

  • tag_schema : Schéma où la balise est définie.

  • tag_name : Nom de la balise.

  • tag_value : La valeur de la balise.

TOKEN_CREDITS

NUMBER

Nombre de crédits de jetons utilisés pour la demande. Utilisé pour la budgétisation au niveau de l’utilisateur.

TOKENS

NUMBER

Somme des jetons utilisés par l’agent Snowflake Intelligent.

TOKENS_GRANULAR

ARRAY

Répartition granulaire de l’utilisation des jetons par requête, type de service (cortex_agents, cortex_analyst) et modèle. Inclut le nombre de jetons d’entrée, cache_read_input, cache_write_input et de sortie par modèle. Le nom de modèle « inconnu » est utilisé lorsqu’un modèle n’est pas présent dans les données de tarification. Chaque objet du tableau contient les paires de valeurs suivantes :

  • request_id : L’identificateur unique de la demande.

  • service_type : Type de service, tel que « cortex_agents » ou « cortex_analyst ».

  • model : Nom du modèle utilisé pour la requête.

  • input : Nombre de jetons d’entrée.

  • cache_read_input : Nombre de jetons d’entrée de lecture du cache.

  • cache_write_input : Nombre de jetons d’entrée d’écriture du cache.

  • output : Nombre de jetons de sortie.

  • start_time : Heure de début de la requête.

CREDITS_GRANULAR

ARRAY

Répartition granulaire de l’utilisation du crédit par requête, type de service (cortex_agents, cortex_analyst) et modèle. Inclut les valeurs de crédit d’entrée, cache_read_input, cache_write_input et de sortie par modèle. Le nom de modèle « inconnu » est utilisé lorsqu’un modèle n’est pas présent dans les données de tarification. Chaque objet du tableau contient les paires de valeurs suivantes :

  • request_id : L’identificateur unique de la demande.

  • service_type : Type de service, tel que « cortex_agents » ou « cortex_analyst ».

  • model : Nom du modèle utilisé pour la requête.

  • input : Valeur de crédit pour les jetons d’entrée.

  • cache_read_input : Valeur de crédit pour les jetons d’entrée de lecture du cache.

  • cache_write_input : Valeur de crédit pour les jetons d’entrée d’écriture du cache.

  • output : Valeur de crédit pour les jetons de sortie.

  • start_time : Heure de début de la requête.

METADATA

OBJECT

Réservé pour des métadonnées supplémentaires. Actuellement vide.

Exemples

Récupérer l’historique d’utilisation 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"}}] | {}       |
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+---------------------------+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+