Uso de planilhas para consultas / DML / DDL

A página Worksheets Guia Planilha da Classic Console fornece uma interface poderosa e versátil para criar e enviar consultas de SQL, bem como realizar a maioria das outras operações DML e todas as operações DDL, e visualizar os resultados assim que suas instruções forem concluídas.

Nota

Este tópico fornece detalhes sobre Classic Console. Se você estiver usando Snowsight, consulte Gerenciamento e uso de planilhas no Snowsight.

Neste tópico:

Visão geral dos recursos

Página da planilha no Console clássico
  1. Navegador de objetos.

  2. Adicione uma planilha.

  3. Menu suspenso:

    • Gerenciar planilhas (procurar, abrir ou excluir, renomear).

    • Abrir um tutorial.

    • Carregar um script.

  4. Menu suspenso:

    • Alterar o banco de dados, esquema ou warehouse atual para a planilha atual sem perder seu trabalho.

    • Retomar/suspender ou redimensionar seu warehouse atual.

  5. Menu suspenso:

    • Carregar um script.

    • Habilitar/desabilitar destaque de texto.

    • Mostrar/ocultar confirmação de execução.

    • Excluir a planilha atual.

  6. Editor de SQL.

  7. Baixar resultados.

  8. Copiar os resultados para a área de transferência.

  9. Maximizar/restaurar resultados.

  10. Ocultar ou exibir colunas.

As planilhas são projetadas para atender a todas as suas necessidades comerciais e de fluxo de trabalho, inclusive:

  • Realizar consultas ad hoc e realizar outras operações SQL.

  • Abertura de múltiplas planilhas simultâneas, cada uma com sua própria sessão separada, permitindo executar consultas em planilhas diferentes com contextos diferentes sem qualquer degradação no desempenho da UI.

  • Salvar uma planilha para uso posterior.

  • Abrir uma planilha de sua biblioteca de planilhas salvas.

    Nota

    • Planilhas salvas não ficam acessíveis fora do Classic Console.

    • Atualmente, planilhas salvas não podem ser compartilhadas com outros usuários.

  • Carregar arquivos de script SQL de sua estação de trabalho ou rede para uma planilha. Após carregar um arquivo de script, você pode opcionalmente editá-lo e salvá-lo em sua biblioteca de planilhas salvas.

  • Sair sem perder seu trabalho. Snowflake retém o conteúdo estático de cada planilha, para que você possa fazer login mais tarde e retomar o trabalho de onde parou. O Snowflake exibe as planilhas que estavam abertas quando você saiu da sessão.

    Observe que painéis redimensionados/recolhidos, alterações de largura nas colunas de resultados/previsão de dados e até mesmo a posição do cursor no editor de SQL persistem:

    • Ao alternar entre planilhas abertas.

    • Ao fechar e reabrir a mesma planilha.

    • Entre sessões de usuários.

  • Especifique uma função diferente para cada planilha e troque de função sem perder seu trabalho. Você pode executar instruções específicas em uma planilha e, em seguida, trocar de função antes de continuar seu trabalho na mesma planilha.

    Nota

    Sua função atual na interface determina a função padrão para as planilhas que você abre, mas as planilhas não estão vinculadas à função na interface. Cada planilha tem sua própria função que pode ser definida de forma independente.

  • Faça login no Snowflake em outro navegador ou aba. Qualquer mudança na planilha feita em uma instância do Snowflake persiste para a outra instância após um ou dois minutos. Você pode continuar trabalhando no outro navegador (ou aba) sem reentrar no seu trabalho.

  • Atualize seu navegador, se necessário. Se você estiver no meio de consultas em andamento, elas voltarão a funcionar quando a atualização for concluída. Observe que se você sair do Snowflake, quaisquer consultas ativas param de funcionar.

Você também pode realizar outras tarefas nessa página, inclusive:

  • Redimensionar o warehouse atual para aumentar ou diminuir dinamicamente os recursos computacionais usados para executar suas consultas e outras instruções DML.

  • Exportar o resultado para uma consulta/instrução selecionada (se o resultado ainda estiver disponível). Para obter mais informações, consulte Exportação de resultados de consulta.

Como salvar e gerenciar planilhas

O Snowflake salva automaticamente as planilhas enquanto você digita e persiste o estado atual de uma planilha entre as sessões do usuário. Para organizar suas planilhas, clique duas vezes na etiqueta da planilha na aba (por exemplo, Worksheet 2) e digite um nome novo e mais significativo para a planilha (por exemplo, Sales Analysis).

Para abrir uma planilha fechada, clique na seta para baixo à direita das abas da planilha aberta e clique em Open Worksheet. A caixa de diálogo Open Worksheet é aberta.

Caixa de diálogo Abrir planilha na página da planilha
  1. Busca de planilhas por etiqueta.

  2. Como excluir planilhas selecionadas.

  3. Clique em uma linha para selecionar uma única planilha.

    Clique uma vez na tecla CMD (Mac) ou CTRL (Windows) e depois clique em várias linhas para selecionar várias planilhas.

  4. Clique duas vezes em uma etiqueta para editá-la.

  5. Abrir planilhas selecionadas.

O diálogo Open Worksheet oferece suporte para as seguintes ações:

Ação

Etapas

Busca de planilhas individuais por etiqueta.

Digite o texto no campo Search. A lista de planilhas existentes é filtrada automaticamente.

Editar etiquetas de planilhas.

Clique duas vezes em uma etiqueta da planilha e edite o texto. As etiquetas da planilha são limitadas a 255 caracteres.

Abrir ou excluir uma ou mais planilhas.

  1. Selecione uma única planilha clicando na linha da tabela da planilha.

    Para selecionar várias planilhas, clique uma vez na tecla CMD (Mac) ou CTRL (Windows) e depois clique em várias linhas da tabela.

  2. Clique no botão Open para abrir as planilhas em abas separadas, ou clique no botão Delete para excluir as planilhas.

Como usar o navegador de objetos

Navegador de objetos na página da planilha
  1. Pré-visualizar dados da tabela.

  2. Clique duas vezes para inserir o nome no editor de SQL.

O navegador de objetos permite que usuários explorem todos os bancos de dados, esquemas, tabelas e exibições acessíveis pela função selecionada para uma planilha.

A lista de bancos de dados e outros objetos é atualizada automaticamente quando o contexto da planilha é alterado. Usuários também podem clicar no botão de atualizar na parte superior do navegador de objetos para ver imediatamente as mudanças nos objetos.

O navegador de objetos pode ser recolhido a qualquer momento para dar mais espaço para o editor de SQL e painéis de resultados/histórico.

Exploração de objetos de banco de dados

Clique em um banco de dados ou esquema para explorar os objetos de banco de dados contidos nele. Você pode então descer para o nível da tabela e da exibição.

Ação

Opções

Notas

Pré-visualizar tabela/visualizar dados no painel de pré-visualização de dados

  • Clique na tabela/exibição desejada ou

  • Passe o mouse sobre a tabela/visualização desejada e clique em:

    » Preview Data

  • Pré-visualizações de dados são limitadas às primeiras 100 linhas.

  • Um warehouse ativo é necessário para pré-visualizar os dados.

  • Quando os dados de uma exibição são pré-visualizados, um botão SQL Text aparece no painel de pré-visualização de dados. Clique neste botão para ver a instrução SQL na descrição da exibição atual.

Defina um banco de dados ou esquema no navegador de objetos como contexto para a planilha

  • Passe o mouse sobre o banco de dados/esquema desejado e clique em:

    » Set as Context

  • Esse é um atalho para clicar na barra Context no canto superior direito e selecionar o banco de dados/esquema a partir dos menus suspensos.

Insira o nome totalmente qualificado de um banco de dados ou objeto no editor de SQL na posição do cursor

  • Clique duas vezes no banco de dados ou objeto ou

  • Passe o mouse sobre o banco de dados/objeto e clique em:

    » Place Name in SQL

Busca de objetos de banco de dados

Procure por bancos de dados, esquemas, tabelas e exibições usando o campo Find database objects. Observe que as buscas são do tipo “começa com” e não diferenciam entre maiúsculas e minúsculas, a menos que a cadeia de cadeia de caracteres de busca esteja entre aspas duplas.

Você também pode pesquisar dentro de um banco de dados ou esquema usando o ícone de pesquisa que aparece para o item quando você passa o mouse sobre ele no navegador de objetos.

Gestão de warehouses

Clique no menu de contexto para selecionar um warehouse ativo diferente para a planilha. Você pode retomar ou suspender o warehouse selecionado, ou redimensionar o warehouse.

Controles de warehouse no menu de contexto

Gerenciamento de consultas

Importante

Os detalhes da consulta e os resultados exibidos na planilha são mantidos apenas para sua sessão atual do usuário. Se você sair da interface da web e voltar a entrar, os resultados de sua sessão anterior não serão mais exibidos na planilha; no entanto, você pode usar a página History Guia Histórico para ver as consultas executadas em sessões anteriores.

Execução de consultas

Execute consultas no editor de SQL usando qualquer uma das opções a seguir:

Ação

Etapas

Atalhos do teclado

Executar uma única consulta

  1. Coloque seu cursor em qualquer lugar dentro de uma consulta (sem selecioná-la).

  2. Clique no botão Run.

Com seu cursor em qualquer parte da consulta, digite a seguinte combinação de teclas:

Mac:

[CMD]+[RETURN]

Windows:

[CTRL]+[ENTER]

Executar todas as consultas

  1. Marque a caixa de seleção All Queries.

  2. Clique no botão Run.

N/A (nenhum)

Executar consultas simples/múltiplas (com confirmação)

  1. Selecione uma ou mais consultas contíguas.

  2. Clique no botão Run. O Snowflake exibe um diálogo de confirmação perguntando se você deseja executar as consultas selecionadas.

N/A (nenhum)

Executar todas as consultas (com confirmação)

  1. Selecione todas as consultas.

  2. Clique no botão Run. O Snowflake exibe um diálogo de confirmação perguntando se você deseja executar as consultas selecionadas.

Sem consultas selecionadas, digite a seguinte combinação de teclas:

Mac:

[SHIFT]+[CMD]+[RETURN]

Windows:

[SHIFT]+[CTRL]+[ENTER]

Anular consultas em execução

Enquanto as consultas são executadas, o botão Run muda para um botão Abort. Clique neste botão para anular as consultas em andamento.

Visualização de informações e detalhes da consulta

Quando uma consulta é executada, uma barra de status exibe a duração total atual da consulta. Passe o mouse sobre a barra para ver uma discriminação da duração.

Pop-up de duração no painel de resultados
  1. Passe o mouse sobre a tela para visualizar as métricas da consulta.

Clique no link Query ID para explorar os detalhes da consulta. Um pop-over fornece links para copiar a ID da consulta para a memória temporária do seu sistema operacional ou para navegar para o histórico da consulta.

Pop-up de duração no painel de resultados
  1. Clique para copiar a ID da consulta.

  2. Clique para navegar para o histórico de consultas.

Como formatar consultas usando atalhos do teclado

O editor de SQL em uma planilha oferece suporte para as seguintes teclas e combinações de teclas para formatar suas consultas e outras instruções SQL:

Paradas de tabulação:

Para inserir uma parada de tabulação em uma linha (em intervalos de 4 caracteres), use a tecla [TAB]:

  • Se o cursor estiver no início da linha, 4 espaços em branco são inseridos.

  • Se o cursor estiver na linha, são acrescentados espaços em branco suficientes para chegar à próxima parada de tabulação.

Recuos à direita/à esquerda:

Para recuar uma linha (ou várias linhas) à direita/esquerda por 2 espaços em branco, coloque o cursor em qualquer lugar da linha (ou destaque as linhas desejadas), mantenha pressionada a tecla [CMD] (Mac) ou [CTRL] (Windows) e digite um ou mais:

  • Colchetes de fechamento ] para recuar a(s) linha(s) à direita com o número de colchetes digitados.

  • Colchetes de abertura [ para recuar a(s) linha(s) à esquerda com o número de colchetes digitados.

Se uma linha for recuada, todas as novas linhas após a linha recuada serão automaticamente recuadas com o mesmo número de espaços em branco.

Comentários:

Para comentar uma linha (ou várias linhas), coloque o cursor em qualquer lugar da linha (ou destaque as linhas desejadas), mantenha pressionada a tecla [CMD] (Mac) ou [CTRL] (Windows) e digite uma barra, /.

Destaque de texto:

Para ativar ou desativar o destaque de texto em todas as planilhas abertas, coloque o cursor em qualquer lugar em uma planilha, mantenha pressionado o botão [SHIFT] [CMD] (Mac) ou [SHIFT] [CTRL] (Windows) e digite a letra K.

Adicionar vários cursores:

Para adicionar vários cursores na mesma planilha, mantenha pressionada a tecla [CMD] (Mac) ou [CTRL] (Windows) e clique em cada novo local usando o botão esquerdo do mouse ou o touchpad.

Selecionar área de texto:

Para selecionar uma área de texto, mantenha pressionada a tecla [OPTION] (Mac) ou [ALT] (Windows). O cursor se transforma em uma cruz. Clique e arraste usando o botão esquerdo do mouse ou o touchpad.

Encontrar e substituir cadeias de caracteres:

Para procurar e substituir uma cadeia de caracteres em uma planilha:

  1. Segure as teclas [CMD] [OPT] [F] (Mac) ou [SHIFT] [CTRL] [F] (Windows). Um campo Replace é exibido.

    Para substituir todas as instâncias de uma cadeia de caracteres, mantenha pressionadas as teclas [CMD] [OPT] [SHIFT] [F] (Mac) ou [ALT] [CTRL] [SHIFT] [F] (Windows). Um campo Replace All é exibido.

  2. Insira a cadeia de caracteres a substituir e pressione a tecla Enter. Um campo With é exibido.

  3. Digite a cadeia de caracteres de substituição e pressione a tecla Enter. Um conjunto de opções é exibido.

  4. Clique na opção desejada:

    Sim:

    Substituir a instância atual da cadeia de caracteres pelo substituto especificado e avançar para a instância seguinte.

    Não:

    Reter a instância atual da cadeia de caracteres e avançar para a instância seguinte.

    Todos:

    Substituir todas as instâncias da cadeia de caracteres pelo substituto especificado.

    Parada:

    Parar de procurar por instâncias da cadeia de caracteres.

Nota

Estes atalhos de teclado são específicos para o Classic Console. Para atalhos em Snowsight, consulte Atualização de planilhas com atalhos de teclado.

Como fazer backup de suas próprias planilhas

Recomendamos que os usuários façam backup de planilhas complexas ou cruciais que seriam difíceis de recriar. Copie e cole o conteúdo das planilhas individuais em arquivos que você possa proteger. O backup de suas planilhas evita que elas sejam apagadas acidentalmente.

Os metadados da planilha são armazenados no estágio do usuário do Snowflake, no diretório worksheet_data. Executar o comando REMOVE e remover o diretório worksheet_data exclui suas próprias planilhas, que não podem ser restauradas.

Nota

Esta precaução se aplica somente às planilhas na aba Worksheets Guia Planilha na Classic Console. As planilhas em Snowsight são armazenadas em outro lugar e não são susceptíveis a exclusão acidental.