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:

As seguintes colunas estão disponíveis apenas na exibição da conta de leitor:
- READER_ACCOUNT_NAME
- READER_ACCOUNT_DELETED_ON

Como alternativa, você pode chamar a função de tabela Information Schema, também chamada de QUERY_HISTORY; no entanto, observe que a função de tabela restringe os resultados à atividade dos últimos 7 dias, em vez de 365 dias para a exibição Account Usage. Veja a descrição da função QUERY_HISTORY.

Consulte também:

QUERY_HISTORY , QUERY_HISTORY_BY_* (função de tabela Information Schema), Monitoramento da atividade de consulta com o Histórico de consultas (painel de controle do Snowsight), Como usar a exibição Histórico de consultas agrupadas no Snowsight

Colunas¶

A coluna Disponível somente em exibições Account Usage de leitor na tabela a seguir indica se a coluna QUERY_HISTORY está disponível no esquema READER_ACCOUNT_USAGE.

Nome da coluna	Tipo de dados	Descrição	Disponível apenas em exibições Account Usage de leitor
`reader_account_name`	VARCHAR	Nome da conta do leitor na qual a instrução SQL foi executada.	✔
`query_id`	VARCHAR	Identificador interno/gerado pelo sistema para a instrução SQL.	✔
`query_text`	VARCHAR	Texto da instrução SQL. O limite é de 100 mil caracteres. As instruções SQL contendo mais de 100 mil caracteres serão truncadas.
`database_id`	NUMBER	Identificador interno/gerado pelo sistema para o banco de dados que estava em uso.	✔
`database_name`	VARCHAR	Banco de dados especificado no contexto da consulta na compilação.	✔
`schema_id`	NUMBER	Identificador interno/gerado pelo sistema para o esquema que estava em uso.	✔
`schema_name`	VARCHAR	Esquema especificado no contexto da consulta na compilação.	✔
`query_type`	VARCHAR	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`	VARCHAR	Usuário que emitiu a consulta.
`role_name`	VARCHAR	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`	VARCHAR	Warehouse em que a consulta foi executada, se houver.	✔
`warehouse_size`	VARCHAR	Tamanho do warehouse quando esta instrução foi executada.	✔
`warehouse_type`	VARCHAR	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`	VARCHAR	Tag de consulta definida para esta instrução pelo parâmetro de sessão QUERY_TAG.	✔
`execution_status`	VARCHAR	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`	VARCHAR	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 local)	✔
`end_time`	TIMESTAMP_LTZ	Hora de término da instrução (no fuso horário local).	✔
`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	O número de linhas produzidas por esta instrução. A coluna ROWS_PRODUCED será descontinuada em uma versão futura. O valor na coluna ROWS_PRODUCED nem sempre reflete o número lógico de linhas afetadas por uma consulta. Snowflake recomenda usar as colunas ROWS_INSERTED, ROWS_UPDATED, ROWS_WRITTEN_TO RESULTS ou ROWS_DELETED.	✔
`rows_inserted`	NUMBER	Número de linhas inseridas pela consulta.
`rows_updated`	NUMBER	Número de linhas atualizadas pela consulta.
`rows_deleted`	NUMBER	Número de linhas excluídas pela consulta.
`rows_unloaded`	NUMBER	Número de linhas descarregadas durante a exportação de dados.
`bytes_deleted`	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`	VARCHAR	Provedor de nuvem de destino para instruções que descarregam dados para outra região e/ou nuvem.	✔
`outbound_data_transfer_region`	VARCHAR	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 de tabelas do Snowflake.	✔
`inbound_data_transfer_cloud`	VARCHAR	Provedor de nuvem de origem para instruções que carregam dados de outra região e/ou nuvem.	✔
`inbound_data_transfer_region`	VARCHAR	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 uma operação de replicação de outra conta. A conta de origem pode estar na mesma região ou em uma região diferente da conta atual.	✔
`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. Este valor não leva em conta o ajuste para serviços de nuvem e, por isso, pode ser maior do que os créditos que são faturados. Para determinar quantos créditos foram realmente cobrados, execute consultas na exibição METERING_DAILY_HISTORY.	✔
`reader_account_deleted_on`	TIMESTAMP_LTZ	Hora e data (no fuso horário UTC) quando a conta do leitor é excluída.	✔
`release_version`	VARCHAR	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.
`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.
`child_queries_wait_time`	NUMBER	Tempo (em milissegundos) para completar a pesquisa em cache ao chamar uma função memoizável.
`role_type`	VARCHAR	Especifica um APPLICATION, DATABASE_ROLE ou ROLE que executou a consulta.
`query_hash`	VARCHAR	O valor de hash calculado com base no texto canônico SQL.
`query_hash_version`	NUMBER	A versão da lógica usada para calcular `QUERY_HASH`.
`query_parameterized_hash`	VARCHAR	O valor de hash calculado com base na consulta parametrizada.
`query_parameterized_hash_version`	NUMBER	A versão da lógica usada para calcular `QUERY_PARAMETERIZED_HASH`.
`secondary_role_stats`	VARCHAR	Uma cadeia de caracteres formatada em JSON que contém três campos relacionados às funções secundárias que foram avaliadas na consulta: uma lista de funções secundárias ou `ALL` dependendo da sessão, uma contagem do número de funções secundárias e o ID interno/gerado pelo sistema para cada função secundária. A contagem e o número de IDs têm no máximo 50.
`rows_written_to_result`	NUMBER	Número de linhas gravadas em um objeto de resultado. Para CREATE TABLE AS SELECT (CTAS) e todas as operações DML, esse resultado é `1`.
`query_retry_time`	NUMBER	Tempo total de execução (em milissegundos) para novas tentativas de consulta causadas por erros acionáveis. Para obter mais informações, consulte Colunas de nova tentativa de consulta.
`query_retry_cause`	VARCHAR	Erro que causou a nova tentativa de consulta. Se não houver nova tentativa de consulta, o campo será NULL. Para obter mais informações, consulte Colunas de nova tentativa de consulta.
`fault_handling_time`	NUMBER	Tempo total de execução (em milissegundos) para novas tentativas de consulta causadas por erros que não são acionáveis. Para obter mais informações, consulte Colunas de nova tentativa de consulta.

Notas de uso¶

Geral¶

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).

Colunas de nova tentativa de consulta¶

Uma consulta pode precisar ser repetida uma ou mais vezes para ser concluída com êxito. Pode haver diversas causas que resultam em uma nova tentativa de consulta. Algumas dessas causas são acionáveis, ou seja, um usuário pode fazer alterações para reduzir ou eliminar novas tentativas de consulta para uma consulta específica. Por exemplo, se uma consulta for repetida devido a um erro de falta de memória, a modificação das configurações do warehouse poderá resolver o problema.

Algumas novas tentativas de consulta são causadas por uma falha que não é acionável. Ou seja, não há nenhuma alteração que um usuário possa fazer para impedir a repetição da consulta. Por exemplo, uma interrupção na rede pode resultar em uma nova tentativa de consulta. Neste caso, não há nenhuma alteração na consulta ou no warehouse que a executa que possa impedir a nova tentativa da consulta.

As colunas QUERY_RETRY_TIME, QUERY_RETRY_CAUSE e FAULT_HANDLING_TIME podem ajudar você a otimizar as consultas que são repetidas e a entender melhor as flutuações no desempenho da consulta.

Histórico de consultas para tabelas híbridas¶

As observações a seguir explicam quando os registros são catalogados na exibição QUERY_HISTORY para consultas em tabelas híbridas:

As consultas de curta duração que operam exclusivamente com tabelas híbridas não geram um registro nessa exibição ou em QUERY_HISTORY (função de tabela Information Schema). Para monitorar essas consultas, use a exibição AGGREGATE_QUERY_HISTORY. Essa exibição permite monitorar mais facilmente cargas de trabalho operacionais de alto rendimento em busca de tendências e problemas.
As consultas de curta duração que operam exclusivamente em tabelas híbridas não fornecem um perfil de consulta que você possa inspecionar no Snowsight.
As consultas em tabelas híbridas geram um registro na exibição QUERY_HISTORY e um perfil de consulta se alguma das condições a seguir for atendida:
- Uma consulta é executada em qualquer tipo de tabela diferente do tipo de tabela híbrida. Essa condição garante que não haja alteração de comportamento para cargas de trabalho não Unistore existentes.
- Uma consulta falha com um EXECUTION_STATUS de failed_with_incident (consulte QUERY_HISTORY). Essa condição garante que você possa investigar e relatar a consulta específica com falha para receber assistência.
- Uma consulta está sendo executada por mais de aproximadamente 500 milissegundos. Essa condição garante que você possa investigar problemas de desempenho em consultas lentas.
- O tamanho do resultado da consulta é muito grande.
- Uma consulta está associada a uma transação Snowflake.
- Uma consulta contém uma função do sistema com efeitos colaterais.
- Uma consulta não é um dos seguintes tipos de instrução: SELECT, INSERT, DELETE, UPDATE, MERGE.
- Uma consulta é executada a partir de SnowSQL, Snowsight ou console clássico. Essa condição garante que você possa gerar manualmente um perfil de consulta completo para investigar problemas de desempenho de qualquer consulta específica, mesmo que ela não seja categorizada como de longa execução.
- Mesmo que uma consulta não atenda a nenhum desses critérios, as consultas podem ser amostradas periodicamente para gerar um registro na exibição QUERY_HISTORY e um perfil de consulta para ajudar em sua investigação.

Comandos PUT e GET¶

Para os comandos PUT e GET, um EXECUTION_STATUS de success em QUERY_HISTORY não significa que os arquivos de dados foram carregados ou baixados com sucesso. Em vez disso, o status indica que o Snowflake recebeu autorização para prosseguir com a transferência do arquivo.