Uso de planilhas para consultas / DML / DDL¶

Visão geral dos recursos¶

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.

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:

Como usar o navegador de objetos¶

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.

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.

Gerenciamento de consultas¶

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.

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.

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.

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.