Consulta de dados usando planilhas¶
Depois de criar ou abrir uma planilha, você pode gerenciar a planilha, escrever e executar consultas, explorar resultados e histórico de consultas, e configurar filtros usando Snowsight.
Neste tópico:
Como escrever consultas em planilhas¶
Após abrir uma planilha, você pode escrever consultas e instruções SQL.
Como definir o contexto da planilha¶
Ao definir um banco de dados e, opcionalmente, um esquema de banco e dados, como o contexto da planilha, você pode fazer referência a objetos no esquema sem qualificar totalmente os nomes dos objetos em sua consulta.
Como escrever consultas com preenchimento automático¶
Ao inserir seu script no editor de consultas, o recurso de autopreenchimento sugere:
Consultar palavras-chave de sintaxe tais como funções SQL ou aliases.
Valores que correspondem a nomes de tabelas ou colunas dentro de um esquema.
Selecione uma função para visualizar sua sintaxe e uma breve descrição.
O Snowflake rastreia aliases de tabela e os sugere como opções de autopreenchimento. Por exemplo, se você executar uma consulta usando posts as p
ou posts p
como um alias, na próxima vez que você digitar p
, o recurso de autopreenchimento sugere o alias como uma opção.
Anexação de um script SQL a uma planilha existente¶
Se você tiver um script SQL em um arquivo, você pode anexá-lo a uma planilha existente, fazendo o seguinte:
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Abra uma planilha.
Na planilha que você deseja atualizar, selecione o nome da planilha e escolha Import SQL from File.
Navegue até o arquivo SQL em seu computador.
O conteúdo do arquivo é anexado à sua planilha.
Como consultar os nomes dos objetos de banco de dados nas planilhas¶
Enquanto você escreve as consultas em sua planilha, consulte os objetos de banco de dados relevantes para as consultas no explorador de Databases. Você pode explorar até objetos específicos de banco de dados, ou usar a busca para localizar um banco de dados, esquema ou objeto ao qual você tem acesso.
Usando o explorador de Databases, você pode localizar os bancos de dados e os objetos de banco de dados para referência rápida. Quando você passar o mouse sobre um objeto de banco de dados, selecione o ícone Pin para fixá-lo. Objetos fixados com alfinetes aparecem no topo do explorador de Databases na seção Pinned. Talvez seja necessário expandir a seção para visualizar todos os seus objetos fixados.
Após localizar um objeto de banco de dados, você pode colocar o nome do objeto na planilha que está editando:
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Abra uma planilha.
Localize o objeto de banco de dados no explorador de Databases.
Passe o mouse sobre o nome do objeto e selecione o menu mais … » Place Name in Editor.
O nome do objeto totalmente qualificado aparece após a localização de seu cursor na planilha.
Para tabelas e exibições do bancos de dados, você também pode adicionar os nomes das colunas à planilha que você está editando:
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Abra uma planilha.
Localize o objeto de banco de dados no explorador de Databases.
Passe o mouse sobre o nome do objeto e selecione o menu mais … » Add Columns in Editor.
Os nomes das colunas separadas por vírgulas aparecem após a localização de seu cursor na planilha.
Formatação de suas consultas¶
Quando uma planilha está aberta, você pode selecionar o nome da planilha para formatar as consultas em sua planilha, e visualizar os atalhos do teclado.
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Abra uma planilha.
Selecione o nome da planilha para abrir o menu More.
Na lista suspensa, selecione Format query para formatar o texto da consulta para facilitar a leitura.
Como executar consultas¶
Você pode executar uma única consulta ou múltiplas consultas sequencialmente na mesma planilha.
Para executar uma única consulta, no link do editor de consulta, coloque seu cursor na consulta e então selecione o botão Run.
Para executar a planilha inteira, a partir do menu suspenso More options próximo ao botão Run, selecione Run All.
Como explorar os resultados da planilha¶
Quando você executa uma consulta ou todas as consultas em uma planilha, você vê os resultados da consulta.
Os resultados da consulta são exibidos como uma tabela de até 10.000 linhas. Se sua consulta retornar mais de 10.000 linhas, use a opção Download results para visualizar todos os resultados.
Você pode navegar pelos resultados da consulta com as teclas de seta em seu teclado, como se fosse com uma planilha eletrônica. Você pode selecionar colunas, células, linhas ou intervalos na tabela de resultados. Qualquer seleção pode ser copiada e colada.
Se você quiser ver seus resultados como um gráfico, selecione Chart. Para obter mais informações sobre os gráficos, consulte Como visualizar dados de planilhas.
Os resultados também incluem estatísticas geradas que exibem informações contextuais para qualquer seleção, bem como estatísticas gerais para todos os resultados. Mesmo se sua consulta retornar mais de 10.000 linhas, as estatísticas ainda refletem todo o conjunto de resultados.
Estatísticas contextuais automáticas¶
Selecione colunas, células, linhas ou intervalos na tabela de resultados para visualizar as informações relevantes sobre os dados selecionados no painel de inspeção (à direita da tabela de resultados). Estatísticas contextuais são geradas automaticamente para todos os tipos de colunas. As estatísticas têm o objetivo de ajudar você a entender seus dados rapidamente.
A visão geral da coluna mostra uma prévia das estatísticas para cada coluna. Selecione uma coluna do inspetor ou o cabeçalho da coluna para ver as estatísticas detalhadas da coluna.
O painel de estatística gera diferentes métricas para diferentes tipos de colunas. Você pode interagir e filtrar usando os itens do painel de estatísticas.
- Medidores preenchidos/vazios
Todas as colunas mostram quantas linhas estão cheias e vazias. As colunas que exibem alguns tipos de dados, como e-mail e JSON, também indicam o número de linhas inválidas.
- Histogramas
Exibido para todas as colunas de data, hora e números.
O histograma indica as linhas que se enquadram em um intervalo específico. Clique em uma barra ou arraste sobre o histograma para selecionar um intervalo. Você pode refinar sua seleção clicando nos rótulos de valores acima do histograma para inserir valores específicos.
- Distribuições de frequência
Exibido para todas as colunas categóricas. As colunas categóricas são colunas de texto onde os mesmos valores são usados mais de uma vez.
- Distribuições de domínio de e-mail
Exibido para colunas de e-mail. A distribuição de domínios de e-mail mostra a distribuição de frequência das ocorrências de nomes de domínio.
- Principais distribuições
Exibido para colunas JSON. A distribuição das chaves mostra a frequência das chaves superiores presentes no resultado definido se todas as linhas contiverem objetos JSON. Se a coluna incluir arrays JSON, a distribuição de chaves mostra os tipos relativos de valores JSON na coluna.
Visualização de detalhes da consulta¶
O Query Details inclui informações sobre a execução da consulta, inclusive:
A duração da execução da consulta.
O número de linhas nos resultados.
Quando a execução foi concluída.
A quantidade de dados verificados pela consulta.
A função usada para executar a consulta.
O warehouse utilizado para executar a consulta.
Alguns detalhes da consulta estão disponíveis somente por 14 dias.
Visualização do perfil da consulta¶
Para acessar um perfil detalhado de sua consulta, no painel Query Details selecione o menu mais … » View Query Profile.
O perfil da consulta se abre em uma nova guia do navegador.
Como baixar os resultados de sua consulta¶
Para baixar os resultados de sua consulta em formato CSV ou TSV, selecione Download results.
O tamanho de seu arquivo dependerá da quantidade de dados retornados por sua consulta. Snowflake não limita o tamanho dos arquivos exportados para resultados de consulta.
Resultados armazenados para versões de planilha anteriores¶
Os resultados das consultas executadas nas planilhas são armazenados em cache por até 1 ano. Este cache está incluído no uso do armazenamento de dados para sua conta.
Utilização de filtros em planilhas¶
Os seguintes filtros de sistema estão disponíveis para todas as funções:
:daterange
Permite que você aplique um intervalo de datas às colunas.
:datebucket
Permite agrupar dados agregados por uma unidade de tempo (por exemplo, por dia).
Além disso, os administradores podem criar filtros personalizados para uso em sua conta. Para saber mais, consulte Filtros personalizados.
Considere o seguinte exemplo:
SELECT
COUNT(O_ORDERDATE) as orders, O_ORDERDATE as date
FROM
SNOWFLAKE_SAMPLE_DATA.TPCH_SF1.ORDERS
WHERE
O_ORDERDATE = :daterange
GROUP BY
:datebucket(O_ORDERDATE), O_ORDERDATE
ORDER BY
O_ORDERDATE
Neste exemplo, você:
Inclui o filtro do sistema :daterange em sua cláusula WHERE.
Incluir o filtro do sistema :datebucket em sua cláusula GROUP BY.
Quando você inclui os filtros em sua consulta, botões de filtro correspondentes aparecem na parte superior de sua planilha.

Neste exemplo, suponha que você defina o filtro Date bucket para day
e Date range para All time
.
Quando você executa a consulta, os resultados são agrupados por dia. Você pode selecionar um novo intervalo de datas para filtrar ainda mais os resultados.

Filtros personalizados¶
Os filtros personalizados permitem alterar os resultados de uma consulta ou visualização sem editar diretamente a consulta. Os filtros são implementados como palavras-chave especiais resolvidas como uma subconsulta ou lista de valores, que são usados na execução de sua consulta.
O botão Show or Hide Filter, localizado no canto superior esquerdo da página, permite que você mostre, oculte e gerencie seus filtros personalizados.
Concessão de permissão para criar filtros personalizados¶
Um administrador de conta (um usuário com a função ACCOUNTADMIN) deve conceder a cada função, incluindo a própria função ACCOUNTADMIN, a permissão para criar filtros personalizados.
Para conceder uma permissão de função para criar filtros personalizados:
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Abra uma planilha.
Selecione o botão Show or Hide Filter e selecione Manage Filters.
Na caixa de diálogo que aparece, selecione Edit Permission.
Na caixa de diálogo Filter Permissions, selecione as funções às quais você deseja conceder permissão para criar filtros.
Selecione Save.
Criação de filtros personalizados¶
Para criar um filtro personalizado:
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Abra uma planilha.
Selecione o botão Show or Hide Filter e selecione Manage Filters.
Na caixa de diálogo que aparece, selecione + Filter.
Para adicionar um filtro, preencha o seguinte:
- Display Name
Nome do filtro que outros usuários veem exibido internamente.
- SQL Keyword
Palavra-chave exclusiva a ser inserida nas consultas. Use o formato
:<cadeia de caracteres>
, sem espaços. Por exemplo::myfilter
.- Description
Descrição do filtro.
- Role
Função usada quando se atualiza os valores do filtro derivados de uma consulta.
- Warehouse
Warehouse utilizado para atualizar valores de filtros derivados de uma consulta.
- Options via
Especifica se os valores do filtro são derivados de uma consulta ou de uma lista de itens.
Adicione opções ao filtro.
Selecione Save.