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 mais ações para planilha 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 Projects » 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 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:

  1. Entre em Snowsight.

  2. Selecione Projects » 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 mais ações para planilha, 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 Mais opções 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 Projects » Worksheets.

  3. Selecione uma planilha para abri-la.

  4. Passe o mouse sobre a guia da planilha e selecione mais ações para planilha.

  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 a instrução SQL que gerou os resultados. Consulte Visualização dos resultados de execuções anteriores de uma planilha.

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. Se você quiser recuperar as planilhas pertencentes a um usuário descartado, consulte Recuperação de planilhas de propriedade de um usuário descartado.

Visualização dos resultados de execuções anteriores de uma planilha

Todos os usuários com acesso a uma planilha podem visualizar os resultados da execução mais recente da planilha.

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

Você pode visualizar os resultados de uma planilha executada anteriormente visualizando o Histórico de consultas de uma planilha. Consulte Visualização do histórico de consultas.

Cuidado

Ao compartilhar uma planilha, você também compartilha uma versão em cache dos resultados. Se sua planilha consultar dados protegidos por políticas de mascaramento ou acesso a linhas, ou se você tiver funções secundárias habilitadas para seu usuário, os resultados armazenados em cache poderão conter resultados visíveis apenas para seu usuário. Os destinatários da planilha compartilhada podem não ter permissão para gerar esses resultados, mas se tiverem a função de planilha, poderão visualizar todos os resultados armazenados em cache.

Compartilhamento de uma planilha

Para compartilhar uma planilha, faça o seguinte:

  1. Entre em Snowsight.

  2. Selecione Projects » 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 Projects » Worksheets para abrir a lista de planilhas.

  3. Abra uma pasta.

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

  1. Entre em Snowsight.

  2. Selecione Projects » Worksheets para abrir a lista de planilhas.

  3. Abra a planilha.

  4. Selecione Code Versions para a planilha.

  5. Na lista de versões de planilhas, selecione o carimbo de data/hora da versão que você deseja visualizar.

  6. Revise e, opcionalmente, copie os detalhes da planilha dessa versão.

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

  1. Baixe as planilhas recuperadas de propriedade de um usuário descartado.

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

  1. Entre em Snowsight.

  2. Selecione Projects » Worksheets.

  3. Selecione Mais opções » Recover Worksheets from Dropped User.

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

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