Esquema:: ACCOUNT_USAGE

Exibição CORTEX_CODE_CLI_USAGE_HISTORY¶

A exibição CORTEX_CODE_CLI_USAGE_HISTORY pode ser utilizada para consultar o histórico de uso da Cortex Code CLI.

As informações na exibição incluem o número de créditos consumidos cada vez que um usuário interage com o Cortex Code CLI. Cada linha na exibição representa uma única solicitação e mostra detalhes sobre os tokens e créditos agregados, além de um detalhamento por modelo. A exibição também inclui metadados relevantes, como ID do usuário e ID da solicitação.

Nota

A exibição não inclui solicitações originadas do Cortex Code no Snowsight. As solicitações originadas do Cortex Code no Snowsight são registradas na exibição CORTEX_CODE_SNOWSIGHT_USAGE_HISTORY.

Colunas¶


Nome da coluna	Tipo de dados	Descrição
USER_ID	NUMBER	O identificador exclusivo do usuário que fez a solicitação.
USER_TAGS	ARRAY	Tags associadas ao usuário. Cada objeto na matriz contém os seguintes pares de valores: `level`: O nível em que a tag é aplicada (por exemplo, «ACCOUNT» ou «USER»). `tag_database`: O banco de dados onde a tag está definida. `tag_schema`: O esquema onde a tag está definida. `tag_name`: O nome da tag. `tag_value`: O valor da tag.
REQUEST_ID	VARCHAR	O identificador único da solicitação.
PARENT_REQUEST_ID	VARCHAR	O identificador da solicitação pai, se aplicável.
USAGE_TIME	TIMESTAMP_TZ	O carimbo de data/hora em que o uso foi registrado.
TOKEN_CREDITS	NUMBER	O número de créditos de token utilizados para a solicitação.
TOKENS	NUMBER	O número total de tokens usados para a solicitação.
TOKENS_GRANULAR	OBJECT	Detalhamento do uso de tokens por modelo. Cada chave é um nome de modelo, e cada valor é um objeto com os seguintes campos: `input`: número de tokens de entrada. `cache_read_input`: número de tokens de entrada de leitura de cache. `cache_write_input`: número de tokens de entrada de gravação de cache. `output`: número de tokens de saída.
CREDITS_GRANULAR	OBJECT	Detalhamento do uso de crédito por modelo. Cada chave é um nome de modelo, e cada valor é um objeto com os seguintes campos: `input`: valor de crédito para tokens de entrada. `cache_read_input`: valor de crédito para tokens de entrada de leitura de cache. `cache_write_input`: valor de crédito para tokens de entrada de gravação de cache. `output`: valor de crédito para tokens de saída.

Notas de uso¶

A exibição fornece o uso de crédito atualizado de uma conta nos últimos 365 dias (1 ano).
O uso da taxa de crédito baseia-se no número de tokens processados, conforme descrito na Tabela de consumo de serviços do Snowflake.

Exemplos¶

Recuperar o histórico de uso da Cortex Code CLI:

SELECT *
  FROM SNOWFLAKE.ACCOUNT_USAGE.CORTEX_CODE_CLI_USAGE_HISTORY;

Recuperar o total de créditos consumidos por usuário nos últimos 30 dias:

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;