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 (pesquisar, 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 ou desabilitar o 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 ou 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.

• 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. Depois de carregar um arquivo de script, você pode editá-lo e salvá-lo na sua biblioteca de planilha 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.

  Painéis redimensionados ou recolhidos, alterações de largura nas colunas result e data preview, bem como a posição do cursor no editor 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. Todas as alterações feitas na planilha em uma instância do Snowflake persistem na outra instância após alguns 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. Se você sair do Snowflake, qualquer consulta ativa é interrompida.

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.

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 no rótulo da planilha na guia (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.

1. Busca de planilhas por etiqueta.

2. Como excluir planilhas selecionadas.

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

   Pressione a tecla CMD (Mac) ou CTRL (Windows) uma vez e 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:

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. Você também pode selecionar Refresh na parte superior do navegador de objetos para exibir as alterações do objeto imediatamente.

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.

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

Gerenciar consultas¶

Visualização de 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-up fornece links para copiar o ID da consulta para a memória temporária do seu sistema operacional ou para navegar para o histórico da consulta.

   

2. Clique para copiar a ID da consulta.

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

Usar atalhos de teclado para formatar consultas¶

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 dois 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 as teclas 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 :kbd: (Mac) ou :kbd: 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. Mantenha pressionadas as teclas CMD + option + F (Mac) ou SHIFT + CTRL + F (Windows). Um campo Replace é exibido.

   Para substituir todas as instâncias de uma cadeia de caracteres de texto, mantenha pressionadas as teclas CMD + option + SHIFT + F (Mac) ou ALT + CTRL + SHIFT + :kbd: 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. Insira 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.

Fazer backup das suas planilhas¶

A Snowflake recomenda que você faça 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. Planilhas excluídas não podem ser restauradas.