Uso da página History para monitorar consultas

A página History Guia Histórico permite visualizar e detalhar todas as consultas executadas nos últimos 14 dias. A página exibe uma listagem histórica de consultas, incluindo consultas executadas do SnowSQL ou outros clientes SQL.

Nota

Para obter detalhes sobre como revisar o histórico de consultas em Snowsight, consulte Monitoramento da atividade de consulta com o Histórico de consultas.

As informações padrão exibidas para cada consulta incluem:

  • Situação atual das consultas: espera na fila, em execução, sucesso, falha.

  • Texto SQL de sua consulta.

  • ID da consulta.

  • Informações sobre o warehouse utilizado para executar a consulta.

  • Hora de início e fim da consulta, assim como duração.

  • Informações sobre a consulta, incluindo número de bytes verificados e número de linhas retornadas.

Nota

As colunas Start Time e End Time exibem a hora no fuso horário do usuário que fez login. Não há opção para alterar esta configuração. Os parâmetros da sessão não afetam esta configuração.

Neste tópico:

Visão geral dos recursos

Página de histórico no Console clássico

Nota

As colunas de página History são derivadas da exibição QUERY_HISTORY. Consulte Exibição QUERY_HISTORY para obter mais informações, incluindo descrições de colunas.

Você pode realizar as seguintes tarefas na página History:

  • Use a caixa de seleção auto-refresh no canto superior direito para ativar/desativar a atualização automática para a sessão. Se marcada, a página é atualizada a cada 10 segundos. Você também pode clicar no ícone Refresh para atualizar a exibição a qualquer momento.

  • Use o botão Show/Hide Filters para abrir/fechar um painel onde você pode especificar um ou mais filtros que controlam as consultas exibidas na página. Os filtros que você especificar estão ativos para a sessão atual.

  • Use a caixa de seleção Include client-generated statements para mostrar ou ocultar instruções SQL executadas por sessões da interface da Web fora das planilhas SQL. Por exemplo, sempre que um usuário navega para Warehouses Guia Warehouses, o Snowflake executa uma instrução SHOW WAREHOUSES em segundo plano. Desmarque a caixa de seleção Include client-generated statements para ocultar este “ruído” na lista de consultas exibidas.

  • Use a caixa de seleção Include queries executed by user tasks para mostrar ou ocultar instruções SQL executadas ou procedimentos armazenados chamados por tarefas do usuário.

  • Rolar a lista de consultas exibidas. A lista inclui (até) 100 das primeiras consultas que correspondem a seus filtros, ou as últimas 100 consultas (quando não são aplicados filtros). No final da lista, se houver mais consultas disponíveis, você pode continuar pesquisando, o que soma (até) 100 das próximas consultas correspondentes à lista.

  • Clique em qualquer cabeçalho de coluna para ordenar a página pela coluna ou adicionar/remover colunas na exibição.

  • Clique no texto de uma consulta (ou selecione a consulta e clique em View SQL) para visualizar o SQL completo para a consulta.

  • Selecione uma consulta que ainda não tenha sido concluída e clique em Abort para anular a consulta.

  • Clique na ID para ver os detalhes da consulta, incluindo o resultado da consulta e seu perfil.

Nota

A página History exibe as consultas executadas nos últimos 14 dias, começando com as mais recentes. Você pode usar o filtro End Time para exibir consultas com base em uma data especificada; entretanto, se você especificar uma data antes dos últimos 14 dias, nenhum resultado será retornado.

Visualização de detalhes e resultados da consulta

O Snowflake persiste o resultado de uma consulta durante um período de tempo, após o qual o resultado é limpo. Este limite não é ajustável. Para obter mais informações, consulte Uso de resultados de consultas persistentes.

Para ver os detalhes e o resultado de uma determinada consulta, clique em Query ID na página History. A página Query Detail aparece (consulte abaixo), onde você pode ver os detalhes de execução da consulta, assim como o resultado da consulta (se ainda estiver disponível).

Página de detalhes da consulta do Console clássico

Você também pode usar o botão Export Result para exportar o resultado da consulta (se ainda estiver disponível) para um arquivo.

Nota

Você pode visualizar os resultados somente para consultas que tenha executado. Se você tiver privilégios para visualizar consultas executadas por outro usuário, a página Query Detail exibe os detalhes da consulta, mas, por razões de privacidade de dados, a página não exibe o resultado real da consulta.

Exportação de resultados de consulta

Em qualquer página da interface onde você possa visualizar o resultado de uma consulta (por exemplo, Worksheets, Query Detail), se o resultado da consulta ainda estiver disponível, você pode exportar o resultado para um arquivo.

Ao clicar no botão Export Result para uma consulta, você é solicitado a especificar o nome e o formato do arquivo. O Snowflake suporta os seguintes formatos de arquivo para exportação de consultas:

  • Valores separados por vírgula (CSV)

  • Valores separados por tabulações (TSV)

Nota

  • Você pode exportar resultados somente para consultas para as quais pode visualizar os resultados (ou seja, consultas que você executou). Se você não executou uma consulta ou o resultado da consulta não está mais disponível, o botão Export Result não é exibido para a consulta.

  • A interface da Web só suporta a exportação de resultados de até 100 MB. Se o resultado de uma consulta exceder este limite, você será informado se deve prosseguir com a exportação.

  • As instruções de exportação podem ser diferentes dependendo do seu navegador. Por exemplo, no Safari, você é solicitado a fornecer apenas um formato de exportação (CSV ou TSV). Após a conclusão da exportação, você é solicitado a baixar o resultado exportado para uma nova janela, na qual você pode usar a opção Save Page As… do navegador para salvar o resultado em um arquivo.

Visualização do perfil de consulta

Página de perfil de consulta do Console clássico

Além dos detalhes e resultados da consulta, o Snowflake fornece o Query Profile para análise das estatísticas e detalhes da consulta, incluindo os componentes individuais de execução que compõem a consulta. Para obter mais informações, consulte Análise de consultas usando o perfil de consulta.

Consulta de dados do histórico censurados de um Snowflake Native App

Para consultas relacionadas a Snowflake Native App, os campos query_text e error_message são censurados do histórico de consultas nos seguintes contextos:

  • As consultas são executadas quando o aplicativo é instalado ou atualizado.

  • Consultas originadas de um trabalho filho de um procedimento armazenado de propriedade do aplicativo.

Em cada uma dessas situações, a célula do histórico de consultas em Snowsight aparece em branco.