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 more actions for worksheet 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:

  1. Entre em Snowsight.

  2. Selecione Worksheets para abrir a lista de planilhas.

  3. Abra uma planilha.

  4. Abra o seletor de contexto.

  5. Selecione uma função para executar a planilha.

  6. Selecione um warehouse que a função tenha privilégios para usar.

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

  1. Entre em Snowsight.

  2. Selecione Worksheets para abrir a lista de planilhas.

  3. Abra uma planilha.

  4. Abra o seletor de contexto.

  5. Selecione o ícone Show warehouse details.

  6. Para a opção Status, selecione o status e escolha Resume se o warehouse estiver suspenso.

  7. Para a opção Size, selecione o tamanho e escolha um tamanho diferente.

  8. 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 more actions for worksheet, visível quando você passa o mouse sobre a guia de uma planilha, para gerenciar a planilha aberta das seguintes maneiras:

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 More options 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.

  1. Entre em Snowsight.

  2. Selecione Worksheets.

  3. Selecione uma planilha para abri-la.

  4. Passe o mouse sobre a guia da planilha e selecione more actions for worksheet.

  5. Na lista suspensa, selecione Move e depois selecione uma pasta ou painel para mover a planilha ou crie uma.

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.

Permissões para planilhas compartilhadas

Ao compartilhar uma planilha com alguém, você pode gerenciar o acesso à planilha e seu conteúdo escolhendo quais permissões conceder ao outro usuário. Essas permissões também são usadas para compartilhar painéis. Os proprietários de planilhas têm as mesmas permissões que os editores de planilhas.

Cada planilha na Snowsight usa uma sessão exclusiva com uma função e um warehouse específicos atribuídos no contexto da planilha. A função da planilha é a função principal usada pela última vez para executar a planilha e é necessária para executá-la. A função da planilha poderá mudar se o proprietário ou editor da planilha executar a planilha usando uma função diferente.

Para visualizar os resultados de uma versão anterior da planilha, você precisa ter a função de planilha usada para executar essa versão da planilha e gerar os resultados. Consulte Visualização de resultados para versões de planilhas.

Permissões concedidas

O destinatário pode:

Editar

  • Editar o conteúdo da planilha.

  • Executar a planilha, incluindo a execução da planilha como uma função diferente.

  • Ver versões anteriores da planilha.

  • Ver os resultados de versões anteriores da planilha, se elas tiverem a função usada para gerar os resultados.

  • Compartilhar a planilha com outras pessoas.

  • Ver versões anteriores da planilha.

  • Adicionar a planilha a uma pasta diferente.

Ver + Executar

  • Se eles tiverem a função de planilha:

    • Executar a planilha.

    • Ver os resultados da versão mais recente da planilha.

  • Ver o conteúdo da planilha.

  • Duplicar e executar a planilha usando sua própria função.

Ver resultados

  • Ver os resultados da versão mais recente da planilha, caso ela tenha a função de planilha.

  • Ver o conteúdo da planilha.

  • Duplicar e executar a planilha usando sua própria função.

Link com Ver + Executar

  • Se eles tiverem a função de planilha:

    • Executar a planilha.

    • Ver os resultados da versão mais recente da planilha.

  • Ver o conteúdo da planilha. Os usuários com o link não podem duplicar e executar a planilha.

Link com Ver resultados

  • Ver os resultados da versão mais recente da planilha, caso ela tenha a função de planilha.

  • Ver o conteúdo da planilha. Os usuários com o link não podem duplicar e executar a planilha.

O proprietário da planilha é o usuário que criou a planilha e tem as mesmas permissões de um editor de planilha. O proprietário da planilha muda se um proprietário ou editor da planilha adicionar a planilha a uma pasta de propriedade de outro usuário.

Se o proprietário da planilha for descartado do Snowflake, o usuário descartado continuará a ser o proprietário da planilha, mas os usuários com permissões de edição poderão continuar a usar a planilha.

Visualização de resultados para versões de planilhas

Proprietários de planilhas e usuários com permissões de edição em uma planilha podem visualizar versões anteriores da planilha e, em alguns casos, os resultados dessas versões da planilha. Os usuários com permissões de visualização e execução e visualização de resultados podem visualizar os resultados da versão mais recente da planilha.

Para visualizar os resultados de versões anteriores de uma planilha, o seguinte deve ser verdadeiro:

Cuidado

Se você tiver funções secundárias habilitadas para seu usuário, os resultados da planilha gerados quando você executa uma planilha poderão conter resultados disponíveis devido a privilégios concedidos a uma função secundária, em vez da função principal usada para executar a planilha. Qualquer pessoa que tenha a função de planilha para essa versão da planilha poderá visualizar todos os resultados, incluindo aqueles visíveis apenas devido ao privilégio de funções secundárias associadas.

Compartilhamento de uma planilha

Para compartilhar uma planilha, faça o seguinte:

  1. Entre em Snowsight.

  2. Selecione Worksheets para abrir a lista de planilhas.

  3. Abra uma planilha.

  4. No canto superior direito da planilha, selecione Share.

  5. Digite os nomes ou nomes de usuário dos usuários do Snowflake que você deseja convidar para usar sua planilha. A lista mostra apenas usuários que já entraram na Snowsight. Se você quiser compartilhar com alguém que ainda não tenha entrado na Snowsight, compartilhe um link em vez disso.

  6. Escolha as permissões a serem concedidas aos usuários com quem você compartilha a planilha.

  7. Opcionalmente, defina permissões para o que as pessoas com o link para a planilha podem acessar.

  8. Opcionalmente, selecione Get Link para obter um link para a planilha que você pode compartilhar com os outros.

  9. Selecione Done.

Nota

A versão de uma planilha executada mais recentemente é a versão da planilha compartilhada. Se você ainda não tiver executado a planilha, uma planilha vazia será compartilhada.

Quaisquer edições feitas em sua versão da planilha, seja você um editor ou proprietário da planilha, não aparecerão para os colaboradores, a menos e até que você execute parte ou todo o código da planilha.

Compartilhamento de uma pasta de planilhas

Para compartilhar uma pasta, incluindo todas as planilhas da pasta, faça o seguinte:

  1. Entre em Snowsight.

  2. Selecione Worksheets para abrir a lista de planilhas.

  3. Abra uma pasta.

  4. No canto superior direito da Worksheets page, selecione Share.

  5. Digite os nomes ou nomes de usuário dos usuários do Snowflake que você deseja convidar para sua pasta. A lista mostra apenas usuários que já entraram na Snowsight. Se você quiser compartilhar com alguém que ainda não tenha entrado na Snowsight, compartilhe um link em vez disso.

  6. Escolha as permissões a serem concedidas aos usuários com quem você compartilha a pasta.

  7. Opcionalmente, defina permissões para o que as pessoas com o link para a pasta podem acessar.

  8. Opcionalmente, selecione Get Link para obter um link para a pasta que você pode compartilhar com os outros.

  9. Selecione Done.

Se você adicionar uma planilha a uma pasta compartilhada, a planilha herdará as configurações de compartilhamento da pasta. Se a pasta pertencer a alguém que não seja o proprietário da planilha, o usuário proprietário da planilha será alterado para o proprietário da pasta e o proprietário original da planilha herdará as permissões de compartilhamento da pasta.

Por exemplo, se um proprietário de planilha adicionar uma planilha a uma pasta na qual ele tenha permissões de edição, a planilha será atualizada para pertencer ao proprietário da pasta e o proprietário original da planilha terá permissões de edição na planilha.

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:

  1. Entre em Snowsight.

  2. Selecione Worksheets para abrir a lista de planilhas.

  3. Abra a planilha.

  4. Selecione Latest Code Version para a planilha.

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