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 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 selecionado no user menu (sua função ativa). Alterar sua função ativa não altera a função atribuída à planilha com o context selector.
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 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.
Compartilhamento de planilhas e pastas¶
Você pode compartilhar planilhas e pastas de planilhas com outros usuários do Snowflake em sua conta. Você só pode compartilhar planilhas diretamente com usuários que já fizeram login na Snowsight. Se você quiser compartilhar com alguém que ainda não tenha entrado na Snowsight, compartilhe um link em vez disso.
Compartilhar uma planilha ou pasta de planilha permite que você colabore com seus colegas nessa planilha e permite que os destinatários de uma planilha compartilhada editem ou visualizem o conteúdo da planilha, visualizem os resultados, executem a planilha ou dupliquem a planilha compartilhada. Consulte Permissões para planilhas compartilhadas.
Compartilhamento de planilhas entre contas¶
As planilhas não são objetos Snowflake, portanto não podem ser replicadas ou compartilhadas entre contas. Se você deseja compartilhar o conteúdo de uma planilha com usuários em outra conta Snowflake, copie o conteúdo e compartilhe-o com usuários da conta fora do Snowflake.
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. Os usuários com permissões de visualização e execução da planilha também 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 e seus resultados, faça o seguinte:
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Abra a planilha.
Selecione Latest Code Version para a planilha.
Na lista suspensa de versões de planilhas, selecione o carimbo de data/hora da versão que você deseja abrir.
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.
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.