Esquema:: ACCOUNT_USAGE

Exibição CORTEX_AI_FUNCTIONS_USAGE_HISTORY¶

Esta visualização do uso da conta pode ser utilizada para consultar o histórico de uso do Cortex AI Functions.

Ela inclui o número de tokens e créditos consumidos cada vez que uma função do Cortex é chamada, agregados em janelas de uma hora. A exibição também inclui metadados relevantes, como o ID de warehouse, os horários de início e término da execução da função e o nome da função e do modelo, se especificado. Cada linha representa o uso para uma única chamada de função.

Colunas¶

Nome da coluna	Tipo de dados	Descrição
START_TIME	TIMESTAMP_LTZ	Início da janela de agregação de uso. A resolução da janela é de 1 hora. Por exemplo, se uma consulta começou às 5:30 e terminou às 8:30, quatro registros aparecem na exibição de uso, um para cada uma das janelas de agregação de 5:00, 6:00, 7:00 e 8:00.
END_TIME	TIMESTAMP_LTZ	Fim da janela de agregação de uso.
FUNCTION_NAME	VARCHAR	Nome da Cortex AI Function chamada. O histórico de uso contém uma linha para cada função chamada em uma consulta.
MODEL_NAME	VARCHAR	Nome do modelo. Vazio para Cortex AI Functions em que um modelo não é especificado como argumento. O histórico de uso contém uma linha para cada modelo utilizado em uma consulta.
QUERY_ID	VARCHAR	O ID da consulta na qual a função foi chamada.
WAREHOUSE_ID	NUMBER	Identificador gerado pelo sistema para o warehouse utilizado pela consulta que chama a Cortex AI Function.
ROLE_NAMES	ARRAY	Funções associadas à consulta. A função principal é o primeiro elemento da matriz.
QUERY_TAG	VARCHAR	A tag, se houver, associada à consulta na qual a função foi chamada.
USER_ID	VARCHAR	Identificador gerado pelo sistema para o usuário que executou a consulta que chama a Cortex AI Function.
METRICS	ARRAY	Uma análise das métricas de uso para a função e o modelo especificados para a combinação de QUERY_ID, MODEL_NAME e WAREHOUSE_ID. Consulte Coluna de métricas abaixo para obter mais detalhes.
CREDITS	NUMBER	Número de créditos faturados para o uso da Cortex AI Function com base nas métricas da função e do modelo especificados para a combinação de QUERY_ID, MODEL_NAME e WAREHOUSE_ID. Não inclui créditos de uso do warehouse.
IS_COMPLETED	BOOLEAN	Indica se a consulta foi concluída nesta janela de agregação.

Coluna de métricas¶

A coluna de métricas contém uma análise detalhada das métricas de uso da função e do modelo especificados para a combinação de QUERY_ID, MODEL_NAME e WAREHOUSE_ID. Cada elemento contém um objeto key (com tipo metric e campos unit) e um value. A estrutura varia de acordo com o método de medição, conforme descrito a seguir:

Medição baseada em tokens (a maioria das funções de AI): faturas por contagem de tokens, seja como contagens separadas de tokens de entrada e saída ou como contagem total de tokens, dependendo da função.

Exemplo: [{"key":{"metric":"input","unit":"tokens"},"value":17},{"key":{"metric":"output","unit":"tokens"},"value":65}]`<br>`[{"key":{"metric":"total","unit":"tokens"},"value":527}]
Medição baseada em página (AI_PARSE_DOCUMENT): faturas por página.

Exemplo: [{"key":{"metric":"total","unit":"pages"},"value":3}]

Notas de uso¶

Esta exibição inclui apenas o uso ocorrido que ocorreu de 5 de janeiro de 2026 em diante.
Os campos de atribuição de ID, tag de consulta e funções estão disponíveis para dados adquiridos após 16 de fevereiro de 2026.
A exibição fornece o uso de crédito atualizado de uma conta nos últimos 365 dias (1 ano).
A exibição rastreia tanto as chamadas de função concluídas quanto as chamadas que ainda estão em andamento.
As consultas em execução são atualizadas a cada 30 minutos (melhor esforço) com um SLA de uma hora.
O uso da taxa de crédito é determinado com base na função chamada, no modelo usado e nos tokens processados, conforme descrito na Tabela de consumo do serviço Snowflake.