Schéma :: ACCOUNT_USAGE

Vue CORTEX_CODE_CLI_USAGE_HISTORY¶

La vue CORTEX_CODE_CLI_USAGE_HISTORY peut être utilisée pour interroger l’historique de l’utilisation de la CLI Cortex Code.

Les informations de la vue incluent le nombre de crédits consommés chaque fois qu’un utilisateur interagit avec la CLI Cortex Code. Chaque ligne de la vue représente une requête unique et fournit des détails sur les jetons et les crédits agrégés ainsi qu’une répartition granulaire par modèle. La vue comprend également des métadonnées pertinentes, comme l’ID utilisateur et l’ID de requête

Note

Cette vue ne comprend pas les requêtes provenant de Cortex Code dans Snowsight. Les requêtes provenant de Cortex Code dans Snowsight sont enregistrées dans la vue CORTEX_CODE_SNOWSIGHT_USAGE_HISTORY.

Colonnes¶


Nom de la colonne	Type de données	Description
USER_ID	NUMBER	Identificateur unique 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.
USAGE_TIME	TIMESTAMP_TZ	L’horodatage auquel l’utilisation a été enregistrée.
TOKEN_CREDITS	NUMBER	Nombre de crédits de jetons utilisés pour la demande.
TOKENS	NUMBER	Nombre total de jetons utilisés pour la requête.
TOKENS_GRANULAR	OBJECT	Répartition granulaire de l’utilisation des jetons par modèle. Chaque clé est un nom de modèle et chaque valeur est un objet contenant les champs suivants : `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.
CREDITS_GRANULAR	OBJECT	Répartition granulaire de l’utilisation du crédit par modèle. Chaque clé est un nom de modèle et chaque valeur est un objet contenant les champs suivants : `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.

Notes sur l’utilisation¶

La vue fournit l’utilisation du crédit mise à jour pour un compte au cours des 365 derniers jours (1 année).
L’utilisation du taux de crédit est basée sur le nombre de jetons traités, comme indiqué dans le Tableau de consommation du service Snowflake.

Exemples¶

Récupérer l’historique d’utilisation de la CLI Cortex Code :

SELECT *
  FROM SNOWFLAKE.ACCOUNT_USAGE.CORTEX_CODE_CLI_USAGE_HISTORY;

Récupérer le total des crédits consommés par utilisateur au cours des 30 derniers jours :

SELECT USER_ID,
       SUM(TOKEN_CREDITS) AS TOTAL_CREDITS
  FROM SNOWFLAKE.ACCOUNT_USAGE.CORTEX_CODE_CLI_USAGE_HISTORY
  WHERE USAGE_TIME >= DATEADD('day', -30, CURRENT_TIMESTAMP())
  GROUP BY USER_ID
  ORDER BY TOTAL_CREDITS DESC;