Gerenciamento e uso de planilhas no Snowsight¶
Planilhas fornecem um método potente e versátil para executar consultas SQL ou código Pythin, 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:
Além disso, você pode escrever instruções SQL e visualizar os resultados. Você também pode escrever o código Python.
Como procurar outras planilhas a partir de uma planilha¶
Ao abrir uma planilha, você pode visualizar outras planilhas no explorador de Worksheets. Você pode procurar outras planilhas e gerenciar as planilhas a partir do explorador de Worksheets.
Visualização do conteúdo das planilhas¶
Para visualizar o conteúdo de uma planilha, você pode passar o mouse sobre o nome da planilha no explorador de Worksheets. 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.
Atualização de planilhas 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] [?] em um teclado Mac ou [CTRL] [SHIFT] [?] em um teclado Windows.
Você também pode passar o mouse sobre a guia da planilha e selecionar e, em seguida, Show Shortcuts para visualizar os atalhos.
Como alterar o contexto da sessão para uma planilha¶
Defina o contexto da sessão para uma planilha para definir a função e o warehouse a ser utilizado para executar os conteúdos de uma planilha. O contexto da planilha é preservado para sessões futuras.
Nota
Você não pode escolher várias funções. O seletor de contexto não oferece suporte a funções secundárias. Para ativar funções secundárias em uma planilha SQL, execute USE 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 da sessão para uma planilha, faça o seguinte:
Entre em 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 é uma sessão única e pode utilizar funções diferentes daquela selecionada no menu da conta (sua função ativa). Alterar sua função ativa não altera a função atribuída à planilha com o seletor de contexto.
Retomada e redimensionamento de warehouses¶
Antes ou depois de executar sua planilha, talvez você precise retomar ou redimensionar seu warehouse.
Você deve ter privilégios MODIFY ou OWNERSHIP no warehouse para alterar os detalhes dele.
Para visualizar e ajustar os detalhes do warehouse usando o seletor de contexto, faça o seguinte:
Entre em 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.
Como gerenciar planilhas abertas¶
Depois de abrir uma planilha, selecione a , visível quando você passa o mouse sobre a guia de uma planilha, para gerenciar a planilha aberta das seguintes maneiras:
Renomeie a planilha.
Duplique a planilha.
Exclua a planilha.
Enquanto você tiver uma planilha aberta, você também poderá visualizar e gerenciar outras planilhas no explorador Worksheets:
Busca de outras planilhas.
Renomeie, duplique, exclua ou mova a planilha usando o visível quando você passa o mouse sobre o nome de uma planilha.
Identifique quais planilhas estão abertas em uma guia usando o ícone da planilha. Um ícone preenchido indica uma planilha aberta em uma guia.
Como organizar planilhas em pastas¶
Você pode organizar e gerenciar planilhas em pastas usando a Snowsight.
Gerenciamento de histórico e versões de planilhas¶
Novas versões de uma planilha são salvas quando você faz alterações e executa uma consulta SQL ou o código na 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 os 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.
Troca de versões de planilha¶
Se você quiser ver versões anteriores de uma planilha, faça o seguinte:
Entre em 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.
Se você quiser visualizar os resultados de uma execução de planilha anterior, visualize o Histórico de consultas da planilha. Consulte Visualização do histórico de consultas.
Resultados armazenados para versões anteriores da planilha¶
Os resultados das consultas executadas nas planilhas são armazenados em cache por até 90 dias ou 25 versões da planilha, o que for maior. 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 Compartilhamento de 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.
Entre em 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¶
Considerações ao recuperar planilhas:
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.