Trabalhar com planilhas no Snowsight¶
As planilhas fornecem um método poderoso e versátil para executar consultas SQL ou código Python na plataforma Snowflake, bem como executar outras tarefas de carregamento, definição e manipulação de dados do Snowflake.
Depois de abrir uma planilha na Snowsight, você pode fazer qualquer uma das seguintes ações:
Procurar e abrir planilhas¶
Ao abrir uma planilha, você pode exibir e gerenciar outras planilhas no Worksheets explorer. O Worksheets explorer também permite que você pesquise planilhas específicas.
Visualizar conteúdo da planilha¶
Para visualizar o conteúdo de uma planilha, você pode passar o mouse sobre o nome da planilha no Worksheets explorer. A visualização também mostra a função usada para executar a planilha.
A partir da versão preliminar, você também pode copiar o conteúdo da planilha. Passe o mouse sobre a visualização do conteúdo da planilha e selecione o botão Copy que é mostrado.
Executar tarefas com atalhos de teclado¶
Snowsight fornece atalhos de teclado para ajudar você a navegar e editar rapidamente as consultas em planilhas. Por exemplo, você pode mover seu cursor dentro de uma planilha, localizar e substituir, copiar linhas, formatar consultas e muito mais usando as teclas de atalho.
Para ver todos os atalhos de teclado disponíveis, abra uma planilha e pressione CMD + SHIFT + :kbd: /
em um teclado Mac ou CTRL + SHIFT + :kbd: /
em um teclado Windows.
Alterar o contexto de uma planilha¶
Ao criar uma planilha, você especifica a função e o warehouse usados para executar o conteúdo da planilha. Essas informações são chamadas de contexto da planilha e são preservadas para sessões futuras e compartilhadas com todos os usuários da mesma planilha.
Nota
O seletor de função permite que você escolha sua função principal. Para ativar funções secundárias em uma planilha SQL, execute USE SECONDARY ROLES. Para determinar se funções secundárias estão ativas na sua sessão atual, chame a função CURRENT_SECONDARY_ROLES CURRENT_SECONDARY_ROLES.
O contexto da função de uma planilha determina quais operações podem ser realizadas nos objetos Snowflake com base nos privilégios de controle de acesso concedidos a essa função.
Para definir o contexto de uma planilha, faça o seguinte:
Faça login no Snowsight.
Selecione Projects » Worksheets para abrir a lista de planilhas.
Abra uma planilha.
Abra o seletor de contexto.
Selecione uma função para executar a planilha.
Selecione um warehouse que a função tenha privilégios para usar.
Selecione em qualquer lugar fora do menu suspenso para fechar o seletor de contexto.
Nota
Cada planilha tem uma sessão exclusiva e pode usar funções diferentes função selecionada no menu do usuário (sua função ativa). Alterar sua função ativa não altera a função atribuída à planilha com o seletor de contexto.
Retomar ou redimensionar um warehouse¶
Antes ou depois de executar sua planilha, talvez você precise retomar ou redimensionar seu warehouse.
Nota
Você deve ter privilégios MODIFY ou OWNERSHIP no warehouse para alterar os detalhes dele.
Para exibir ou ajustar os detalhes do warehouse usando o seletor de contexto, faça o seguinte:
Faça login no Snowsight.
Selecione Projects » Worksheets para abrir a lista de planilhas.
Abra uma planilha.
Abra o seletor de contexto.
Selecione o ícone Show warehouse details.
Para a opção Status, selecione o status e escolha Resume se o warehouse estiver suspenso.
Para a opção Size, selecione o tamanho e escolha um tamanho diferente.
Selecione em qualquer lugar fora do menu suspenso para fechar o seletor de contexto.
Gerenciar planilhas¶
Você pode gerenciar planilhas na Snowsight na guia da planilha ou no Worksheets explorer. Para acessar o menu da guia da planilha, abra uma planilha, passe o mouse sobre a guia e selecione . Para acessar o Worksheets explorer, passe o mouse sobre o nome da planilha e selecione
.
As ações disponíveis em cada menu são baseadas na sua função atual. Dependendo de suas permissões, você pode fazer o seguinte:
Renomear, excluir ou mover uma planilha (requer permissões de Edição ou Propriedade).
Organizar planilhas movendo-as para pastas ou um painel.
Importar SQL de um arquivo externo.
Formatar suas consultas.
Busca de outras planilhas.
Duplicar uma planilha (qualquer função).
Dica
Você pode passar o mouse sobre uma planilha para visualizar seu conteúdo.
Você pode identificar quais planilhas estão abertas em guias consultando o ícone da planilha. Um ícone sólido indica que a planilha está aberta no momento. Para acessar as opções do menu, passe o mouse sobre o nome de uma planilha e selecione as reticências visíveis.
Gerenciar histórico e versões da planilha¶
Todas as edições locais feitas em uma planilha são salvas automaticamente a cada três segundos, mas permanecem visíveis somente para você. Quando você executa uma consulta SQL ou executa um código em uma planilha, a versão mais recente é atualizada e compartilhada com todos os colaboradores. Você também pode exibir versões anteriores de uma planilha e, opcionalmente, copiar detalhes de qualquer versão. Para obter mais informações, consulte Alternar versões da planilha.
Ao fazer alterações em planilhas e gerenciar versões de planilhas, considere o seguinte:
Quando você compartilha uma planilha com outros usuários, os usuários com permissões de edição podem visualizar versões anteriores da planilha. Todos os usuários com quem você compartilha uma planilha podem visualizar até 10.000 linhas de resultados da versão mais recente da planilha.
Sempre que alguém com permissões executa uma planilha, uma nova versão da planilha é salva.
Se você fizer alterações na planilha e elas parecerem desaparecer, use o histórico de versões para abrir o rascunho salvo com suas alterações.
A versão da planilha executada mais recentemente é a versão visível para os colaboradores.
Se você fizer alterações na planilha que deseja que fiquem visíveis para os usuários com quem compartilhou a planilha, você deverá executá-la.
Se vários usuários editarem e executarem uma planilha compartilhada ao mesmo tempo, cada execução da planilha criará uma nova versão. A versão da planilha executada mais recentemente é aquela que está visível quando você abre ou atualiza a planilha.
Alternar versões da planilha¶
Para exibir versões anteriores de uma planilha, faça o seguinte:
Faça login no Snowsight.
Selecione Projects » Worksheets para abrir a lista de planilhas.
Abra a planilha.
Selecione Code Versions para a planilha.
Na lista de versões de planilhas, selecione o carimbo de data/hora da versão que você deseja visualizar.
Revise e, opcionalmente, copie os detalhes da planilha dessa versão.
Selecione Close para retornar à versão atual da planilha.
Para exibir os resultados de uma execução anterior da planilha, visualize o Query History da planilha. Consulte Visualização do histórico de consultas.
Resultados armazenados para versões anteriores da planilha¶
Nota
Disponível para a maioria das contas. Contas em regiões do governo dos EUA, contas usando o Virtual Private Snowflake (VPS) e contas que usam conectividade privada para acessar o Snowflake continuam vendo resultados de consulta limitados a 10 mil linhas.
Todos os resultados das consultas executadas em planilhas ficam disponíveis por até 24 horas. Após 24 horas, você deve executar sua consulta novamente para visualizar os resultados.
Para oferecer suporte a estatísticas contextuais e compartilhar resultados de planilha, os 25 resultados de consulta mais recentes são armazenados em cache por até 90 dias. Este cache está incluído no uso do armazenamento de dados para sua conta.
Recuperação de planilhas de propriedade de um usuário descartado¶
Se você descartar um usuário, poderá recuperar até 500 planilhas pertencentes a esse usuário. Para recuperar as planilhas, faça o seguinte:
Baixe as planilhas recuperadas de propriedade de um usuário descartado.
Crie planilhas a partir de um arquivo SQL para adicionar as planilhas recuperadas de volta ao Snowflake.
Se você quiser alterar a propriedade ou manter o acesso às planilhas antes de descartar um usuário, peça a esse usuário para compartilhar as planilhas. Consulte Compartilhar planilhas e pastas.
Como baixar as planilhas recuperadas de propriedade de um usuário descartado¶
Para recuperar planilhas pertencentes a um usuário descartado, baixe um arquivo .tar.gz
de até 500 planilhas pertencentes a esse usuário.
Nota
Você deve receber a função ACCOUNTADMIN para recuperar planilhas de usuários descartados.
Faça login no Snowsight.
Selecione Projects » Worksheets.
Na caixa de diálogo, insira o nome de usuário de um usuário descartado em sua conta.
Importante
A caixa e a ortografia do nome de usuário devem corresponder exatamente ao nome de usuário armazenado no Snowflake.
Selecione Recover.
Seu navegador baixa um arquivo
.tar
contendo até 500 planilhas. Se o usuário descartado tiver mais de 500 planilhas, somente as 500 planilhas modificadas mais recentemente serão baixadas.
Depois de baixar planilhas pertencentes a um usuário descartado, adicione as planilhas recuperadas a Snowsight criando planilhas a partir dos arquivos SQL.
Você deve expandir o arquivo .tar
baixado em uma pasta de arquivos .sql
antes de poder adicionar planilhas recuperadas a Snowsight. Você só pode adicionar uma planilha por vez a Snowsight, e o usuário que adicionar as planilhas recuperadas a Snowsight se tornará o novo proprietário das planilhas.
Consulte Criação de planilhas a partir de um arquivo SQL para obter mais detalhes.
Considerações para recuperar planilhas de propriedade de usuários descartados¶
Somente o título e o conteúdo da versão de uma planilha executada mais recentemente são recuperados. O histórico de versões da planilha, os destinatários e as permissões de compartilhamento, os resultados da consulta e os metadados da planilha não são recuperados.
No máximo 500 planilhas são recuperadas. Para usuários descartados com mais de 500 planilhas, somente as 500 planilhas modificadas mais recentemente serão recuperadas.
Somente planilhas em Snowsight são recuperadas. As planilhas em Classic Console pertencentes a usuários descartados não podem ser recuperadas com este método.
Se vários usuários descartados tiverem o mesmo nome de usuário, as planilhas pertencentes a todos os usuários descartados com esse nome de usuário serão recuperadas.
Se a recuperação da planilha falhar por motivos inesperados, entre em contato com o suporte Snowflake.
Objetos internos do Snowflake para planilhas¶
O Snowflake cria os seguintes objetos internos para oferecer suporte para o uso de planilhas na Snowsight:
Tipo de objeto |
Nome |
---|---|
Integração de segurança |
WORKSHEETS |
Blobs |
WORKSHEETS_APP |
Banco de dados |
WORKSHEETS_APP |
Usuário |
WORKSHEETS_APP_USER |
Funções |
APPADMIN, WORKSHEETS_APP_RL |
Essas objetos internos são usados para fazer o cache dos resultados de consultas em um estágio interno de sua conta. Esses dados em cache são criptografados e protegidos pela hierarquia chave para a conta.
Os privilégios limitados concedidos a essas funções internas só permitem que a Snowsight tenha acesso ao estágio interno para armazenar esses resultados. A função não pode listar objetos em sua conta ou dados de acesso em suas tabelas.
O usuário e a função da Snowsight são retornados quando você consulta as exibições USERS e ROLES, respectivamente, no esquema ACCOUNT_USAGE no banco de dados compartilhado SNOWFLAKE. Instruções SHOW <objetos> não retornam esses objetos internos.