Esquemas:: ACCOUNT_USAGE , READER_ACCOUNT_USAGE

Exibição QUERY_HISTORY¶

Esta exibição do Account Usage pode ser usada para consultar o histórico de consultas do Snowflake por várias dimensões (intervalo de tempo, sessão, usuário, warehouse etc.) nos últimos 365 dias (1 ano).

A exibição está disponível tanto nos esquemas ACCOUNT_USAGE como READER_ACCOUNT_USAGE com as seguintes diferenças:

A coluna seguinte está disponível somente na exibição da conta do leitor:
- READER_ACCOUNT_NAME
As seguintes colunas não são fornecidas na exibição da conta do leitor:
- CLUSTER_NUMBER
- BYTES_SCANNED
- ROWS_PRODUCED
- OUTBOUND_DATA_TRANSFER_CLOUD
- INBOUND_DATA_TRANSFER_CLOUD
- INBOUND_DATA_TRANSFER_REGION
- INBOUND_DATA_TRANSFER_BYTES
- QUERY_ACCELERATION_BYTES_SCANNED
- QUERY_ACCELERATION_PARTITIONS_SCANNED
- QUERY_ACCELERATION_UPPER_LIMIT_SCALE_FACTOR

Consulte também:

QUERY_HISTORY , QUERY_HISTORY_BY_* (Função de tabela do Information Schema)

Colunas¶

Nome da coluna	Tipo de dados	Descrição
READER_ACCOUNT_NAME	TEXT	Nome da conta do leitor na qual a instrução SQL foi executada.
QUERY_ID	TEXT	Identificador interno/gerado pelo sistema para a instrução SQL.
QUERY_TEXT	TEXT	Texto da instrução SQL.
DATABASE_ID	NUMBER	Identificador interno/gerado pelo sistema para o banco de dados que estava em uso.
DATABASE_NAME	TEXT	Banco de dados que estava em uso no momento da consulta.
SCHEMA_ID	NUMBER	Identificador interno/gerado pelo sistema para o esquema que estava em uso.
SCHEMA_NAME	TEXT	Esquema que estava em uso no momento da consulta.
QUERY_TYPE	TEXT	DML, consulta etc. Se a consulta tiver falhado, o tipo de consulta pode ser UNKNOWN.
SESSION_ID	NUMBER	Sessão que executou a instrução.
USER_NAME	TEXT	Usuário que emitiu a consulta.
ROLE_NAME	TEXT	Função que estava ativa na sessão no momento da consulta.
WAREHOUSE_ID	NUMBER	Identificador interno/gerado pelo sistema do warehouse que foi utilizado.
WAREHOUSE_NAME	TEXT	Warehouse em que a consulta foi executada, se houver.
WAREHOUSE_SIZE	TEXT	Tamanho do warehouse quando esta instrução foi executada.
WAREHOUSE_TYPE	TEXT	Tipo do warehouse quando esta instrução foi executada.
CLUSTER_NUMBER	NUMBER	O cluster (em um warehouse multicluster) no qual esta instrução foi executada.
QUERY_TAG	TEXT	Tag de consulta definida para esta instrução pelo parâmetro de sessão QUERY_TAG.
EXECUTION_STATUS	TEXT	Status de execução da consulta. Valores válidos: `success`, `fail`, `incident`.
ERROR_CODE	NUMBER	Código de erro, se a consulta tiver retornado um erro
ERROR_MESSAGE	TEXT	Mensagem de erro, se a consulta tiver retornado um erro
START_TIME	TIMESTAMP_LTZ	Hora de início da instrução (no fuso horário UTC)
END_TIME	TIMESTAMP_LTZ	Hora de término da instrução (no fuso horário UTC).
TOTAL_ELAPSED_TIME	NUMBER	Tempo transcorrido (em milissegundos).
BYTES_SCANNED	NUMBER	Número de bytes digitalizados por esta instrução.
PERCENTAGE_SCANNED_FROM_CACHE	FLOAT	A porcentagem de dados escaneados a partir do cache de disco local. O valor varia de 0,0 a 1,0. Multiplique por 100 para obter uma porcentagem verdadeira.
BYTES_WRITTEN	NUMBER	Número de bytes escritos (por exemplo, ao carregar em uma tabela).
BYTES_WRITTEN_TO_RESULT	NUMBER	Número de bytes gravados em um objeto de resultado. Por exemplo, `select * from . . .` produziria um conjunto de resultados em formato tabular representando cada campo na seleção. . . Em geral, o objeto de resultado representa o que for produzido como resultado da consulta, e `BYTES_WRITTEN_TO_RESULT` representa o tamanho do resultado retornado.
BYTES_READ_FROM_RESULT	NUMBER	Número de bytes lidos de um objeto resultado.
ROWS_PRODUCED	NUMBER	Número de linhas produzidas por esta instrução.
ROWS_INSERTED 1	NUMBER	Número de linhas inseridas pela consulta.
ROWS_UPDATED 1	NUMBER	Número de linhas atualizadas pela consulta.
ROWS_DELETED 1	NUMBER	Número de linhas excluídas pela consulta.
ROWS_UNLOADED 1	NUMBER	Número de linhas descarregadas durante a exportação de dados.
BYTES_DELETED 1	NUMBER	Número de bytes excluídos pela consulta.
PARTITIONS_SCANNED	NUMBER	Número de micropartições escaneadas.
PARTITIONS_TOTAL	NUMBER	Total de micropartições de todas as tabelas incluídas nesta consulta.
BYTES_SPILLED_TO_LOCAL_STORAGE	NUMBER	Volume de dados despejados em disco local.
BYTES_SPILLED_TO_REMOTE_STORAGE	NUMBER	Volume de dados despejados em disco remoto.
BYTES_SENT_OVER_THE_NETWORK	NUMBER	Volume de dados enviados pela rede.
COMPILATION_TIME	NUMBER	Tempo de compilação (em milissegundos)
EXECUTION_TIME	NUMBER	Tempo de execução (em milissegundos)
QUEUED_PROVISIONING_TIME	NUMBER	Tempo (em milissegundos) gasto na fila do warehouse, esperando que o warehouse compute recursos para provisionar, devido à criação, retomada ou redimensionamento do warehouse.
QUEUED_REPAIR_TIME	NUMBER	Tempo (em milissegundos) gasto na fila do warehouse, esperando que os recursos computados no warehouse sejam reparados.
QUEUED_OVERLOAD_TIME	NUMBER	Tempo (em milissegundos) gasto na fila de espera do warehouse, devido à sobrecarga do warehouse devido à carga de trabalho atual da consulta.
TRANSACTION_BLOCKED_TIME	NUMBER	Tempo (em milissegundos) gasto bloqueado por um DML concorrente.
OUTBOUND_DATA_TRANSFER_CLOUD	TEXT	Provedor de nuvem de destino para instruções que descarregam dados para outra região e/ou nuvem.
OUTBOUND_DATA_TRANSFER_REGION	TEXT	Região de destino para instruções que descarregam dados para outra região e/ou nuvem.
OUTBOUND_DATA_TRANSFER_BYTES	NUMBER	Número de bytes transferidos em instruções que descarregam dados para outra região e/ou nuvem.
INBOUND_DATA_TRANSFER_CLOUD	TEXT	Provedor de nuvem de origem para instruções que carregam dados de outra região e/ou nuvem.
INBOUND_DATA_TRANSFER_REGION	TEXT	Região de origem para instruções que carregam dados de outra região e/ou nuvem.
INBOUND_DATA_TRANSFER_BYTES	NUMBER	Número de bytes transferidos em instruções que carregam dados de outra região e/ou nuvem.
LIST_EXTERNAL_FILES_TIME	NUMBER	Tempo (em milissegundos) gasto listando arquivos externos.
CREDITS_USED_CLOUD_SERVICES	NUMBER	Número de créditos usados para serviços de nuvem.
RELEASE_VERSION	NUMBER	Versão de lançamento no formato de `major_release.minor_release.patch_release`.
EXTERNAL_FUNCTION_TOTAL_INVOCATIONS	NUMBER	O número agregado de vezes que esta consulta chamou serviços remotos. Para obter detalhes importantes, consulte as Notas de uso.
EXTERNAL_FUNCTION_TOTAL_SENT_ROWS	NUMBER	O número total de linhas que esta consulta enviou em todas as chamadas para todos os serviços remotos.
EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS	NUMBER	O número total de linhas que esta consulta recebeu de todas as chamadas para todos os serviços remotos.
EXTERNAL_FUNCTION_TOTAL_SENT_BYTES	NUMBER	O número total de bytes que esta consulta enviou em todas as chamadas para todos os serviços remotos.
EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES	NUMBER	O número total de bytes que esta consulta recebeu de todas as chamadas para todos os serviços remotos.
QUERY_LOAD_PERCENT	NUMBER	A porcentagem aproximada de recursos de computação ativos no warehouse para a execução desta consulta.
IS_CLIENT_GENERATED_STATEMENT	BOOLEAN	Indica se a consulta foi gerada pelo cliente.
QUERY_ACCELERATION_BYTES_SCANNED	NUMBER	Número de bytes digitalizados por Query Acceleration Service.
QUERY_ACCELERATION_PARTITIONS_SCANNED	NUMBER	Número de partições digitalizadas por Query Acceleration Service.
QUERY_ACCELERATION_UPPER_LIMIT_SCALE_FACTOR	NUMBER	Fator de escala no limite superior do qual uma consulta teria se beneficiado.
CHILD_QUERIES_WAIT_TIME	NUMBER	Tempo (em milissegundos) para completar a pesquisa em cache ao chamar uma função memoizável.
OWNER	TEXT	O nome da função que é proprietária da função que estava ativa na sessão no momento da consulta.
OWNER_ROLE_TYPE	TEXT	O tipo de função que possui o objeto, seja `ROLE` ou `DATABASE_ROLE`. Note que o Snowflake retorna NULL se você excluir o objeto porque não há função de proprietário para um objeto excluído.
TRANSACTION_ID	NUMBER	ID da transação que contém a instrução ou 0 se a instrução não for executada dentro de uma transação.
ROLE_TYPE	VARCHAR	Especifica se um `ROLE` ou `DATABASE_ROLE` executou a consulta.

1(1,2,3,4,5): Esses campos exibem os dados somente de consultas executadas a partir de 18 de janeiro de 2020.

Notas de uso¶

A latência da visualização pode ser de até 45 minutos.
Os valores para as colunas EXTERNAL_FUNCTION_TOTAL_INVOCATIONS, EXTERNAL_FUNCTION_TOTAL_SENT_ROWS, EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS, EXTERNAL_FUNCTION_TOTAL_SENT_BYTES e EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES são afetados por muitos fatores, inclusive:
- O número de funções externas na instrução SQL.
- O número de linhas por lote enviadas para cada serviço remoto.
- O número de tentativas devido a erros transitórios (por exemplo, porque uma resposta não foi recebida dentro do tempo esperado).
Por padrão, a coluna CHILD_QUERIES_WAIT_TIME não está incluída na saída.

Para incluir a coluna, você deve habilitar o pacote 2023_01 de versão de alteração de comportamento.

Para obter mais informações sobre como habilitar pacotes de versão de alteração de comportamento, consulte Gerenciamento de mudanças de comportamento.