Esquema:: ACCOUNT_USAGE

Exibição CORTEX_AISQL_USAGE_HISTORY¶

A exibição CORTEX_AISQL_USAGE_HISTORY pode ser usada para consultar o histórico de uso de Funções de AI do Cortex.

As informações na exibição incluem o número de créditos consumidos cada vez que uma função de AI é chamada, agregada em incrementos de uma hora, com base no tempo em que cada consulta foi concluída. A exibição também inclui metadados relevantes, como ID do usuário, ID da consulta, função e modelo. Cada linha na exibição representa o uso para uma combinação específica de função, modelo, consulta e warehouse. Para obter mais informações sobre o faturamento do Cortex, consulte Considerações sobre custo.

Importante

Essa exibição substitui as exibições CORTEX_FUNCTIONS_USAGE_HISTORY e CORTEX_FUNCTIONS_QUERY_USAGE_HISTORY.

Colunas¶

Nome da coluna	Tipo de dados	Descrição
USAGE_TIME	TIMESTAMP_LTZ	A data e início da hora (no fuso horário local) em que este registro de uso foi faturado. O uso não é registrado até que a consulta seja concluída, portanto, esse carimbo de data/hora representa a hora em que a consulta foi concluída. Por exemplo, se uma consulta começa às 05:30 e termina às 08:30, o registro é agregado na hora 08:00-09:00.
MODEL_NAME	TEXT	Nome do modelo usado na consulta. Uma consulta pode usar mais de um modelo; nesse caso, o histórico de uso inclui uma linha para cada modelo.
FUNCTION_NAME	TEXT	O nome da função de AI do Cortex chamada. Uma consulta pode usar mais de uma função. Nesse caso, o histórico de uso inclui uma linha para cada função.
TOKEN_CREDITS	NUMBER	Número de créditos cobrados pelo uso da função de AI do Cortex com base nos tokens processados para a função e o modelo especificados para a combinação de QUERY_ID, MODEL_NAME e WAREHOUSE_ID. Não inclui créditos de uso do warehouse.
TOKENS	NUMBER	Número de tokens processados para a função e modelo especificados para a combinação de QUERY_ID, MODEL_NAME e WAREHOUSE_ID.
TOKEN_CREDITS_GRANULAR	OBJECT	Um objeto SQL que fornece uma discriminação dos créditos faturados por tipo de token (entrada ou saída) para a função e modelo especificados para a combinação de QUERY_ID, MODEL_NAME e WAREHOUSE_ID.
TOKENS_GRANULAR	OBJECT	Um objeto SQL que fornece uma discriminação de tokens processados por tipo de token (entrada ou saída) para a função e modelo especificados para a combinação de QUERY_ID, MODEL_NAME e WAREHOUSE_ID.
QUERY_ID	TEXT	O ID da consulta na qual a função foi chamada.
QUERY_TAG	TEXT	A tag, se houver, associada à consulta na qual a função foi chamada.
USER_ID	TEXT	O ID interno do usuário que invocou a função. Para obter mais informações sobre autenticação, consulte Autenticação no servidor.
WAREHOUSE_ID	TEXT	O ID do warehouse virtual que processou a consulta na qual a função foi chamada.

Notas de uso¶

Essa exibição inclui apenas o uso que ocorreu de 17 de novembro de 2025 em diante.
O faturamento é relatado somente após a conclusão da consulta, e o carimbo de data/hora é a hora em que a consulta foi concluída.
O uso da taxa de crédito baseia-se no número de mensagens processadas, conforme descrito em Tabela de consumo de serviços do Snowflake.