Schéma :: ACCOUNT_USAGE

Vue CORTEX_AISQL_USAGE_HISTORY¶

La vue CORTEX_AISQL_USAGE_HISTORY peut être utilisée pour interroger l’historique des fonctions Cortex AI.

Les informations contenues dans la vue incluent le nombre de crédits consommés chaque fois qu’une fonction AI est appelée, agrégée par incrément d’une heure, en fonction de l’heure à laquelle chaque requête a été traitée. La vue comprend également des métadonnées pertinentes, telles que l’ID d’utilisateur, l’ID de requête, la fonction et le modèle. Chaque ligne de la vue représente l’utilisation d’une combinaison spécifique de fonction, de modèle, de requête et d’entrepôt. Pour plus d’informations sur la facturation Cortex, voir Considérations relatives aux clients.

Important

Cette vue remplace à la fois les vues CORTEX_FUNCTIONS_USAGE_HISTORY et CORTEX_FUNCTIONS_QUERY_USAGE_HISTORY.

Colonnes¶

Nom de la colonne	Type de données	Description
USAGE_TIME	TIMESTAMP_LTZ	Date et début de l’heure (dans le fuseau horaire local) à laquelle cet enregistrement d’utilisation a été facturé. L’utilisation n’est pas enregistrée tant que la requête n’est pas traitée, donc cet horodatage représente l’heure à laquelle la requête a abouti. Par exemple, si une requête commence à 05 h 30 et se termine à 08 h 30, l’enregistrement est agrégé entre 08 h 00 et 09 h 00.
MODEL_NAME	TEXT	Nom du modèle utilisé dans la requête. Une requête peut utiliser plusieurs modèles ; dans ce cas, l’historique d’utilisation comprend une ligne pour chaque modèle.
FUNCTION_NAME	TEXT	Nom de la fonction Cortex AI appelée. Une requête peut utiliser plusieurs fonctions ; dans ce cas, l’historique d’utilisation comprend une ligne pour chaque fonction.
TOKEN_CREDITS	NUMBER	Nombre de crédits facturés pour l’utilisation des fonctions Cortex AI en fonction des jetons traités pour la fonction et le modèle spécifiés pour la combinaison de QUERY_ID, MODEL_NAME et WAREHOUSE_ID. N’inclut pas les crédits d’utilisation d’entrepôt.
TOKENS	NUMBER	Nombre de jetons traités pour la fonction et le modèle spécifiés pour la combinaison de QUERY_ID, MODEL_NAME et WAREHOUSE_ID.
TOKEN_CREDITS_GRANULAR	OBJECT	Un objet SQL qui fournit une répartition des crédits facturés par type de jeton (entrée ou sortie) pour la fonction et le modèle spécifiés pour la combinaison de QUERY_ID, MODEL_NAME et WAREHOUSE_ID.
TOKENS_GRANULAR	OBJECT	Un objet SQL qui fournit une répartition des jetons traités par type de jeton (entrée ou sortie) pour la fonction et le modèle spécifiés pour la combinaison de QUERY_ID, MODEL_NAME et WAREHOUSE_ID.
QUERY_ID	TEXT	L’ID de la requête dans laquelle la fonction a été appelée.
QUERY_TAG	TEXT	La balise, le cas échéant, associée à la requête dans laquelle la fonction a été appelée.
USER_ID	TEXT	L’ID interne de l’utilisateur qui a appelé la fonction. Pour plus d’informations sur l’authentification, voir Authentification auprès du serveur.
WAREHOUSE_ID	TEXT	L’ID de l’entrepôt virtuel qui a traité la requête dans laquelle la fonction a été appelée.

Notes sur l’utilisation¶

Cette vue inclut uniquement l’utilisation qui a eu lieu à partir du 17 novembre 2025.
La facturation n’est signalée qu’une fois la requête terminée. L’horodatage correspond à l’heure à laquelle la requête a abouti.
L’utilisation du crédit est basée sur le nombre de jetons traités, comme indiqué dans la Table de consommation du service Snowflake.