- Esquemas:
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: |
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, |
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 |
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 |
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 |
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.