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:

  1. Faça login no 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 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:

  1. Faça login no 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.

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 mais ações para planilha. Para acessar o Worksheets explorer, passe o mouse sobre o nome da planilha e selecione Mais opções.

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.

Compartilhar planilhas e pastas

Compartilhar uma planilha ou pasta de planilha permite que você colabore com colegas. Os destinatários de uma planilha compartilhada podem editar ou exibir seu conteúdo, executar consultas, exibir resultados ou duplicar a planilha compartilhada.

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. Para compartilhar com alguém que ainda não entrou na Snowsight, compartilhe um link (certifique-se de que o compartilhamento de link esteja habilitado).

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.

Nota

Usuários com permissões de Executar também podem alterar a função da planilha usando USE ROLE.

Para visualizar os resultados de uma versão anterior da planilha, você precisa ter a função primária 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, inclusive usando uma função diferente.

  • Visualizar e gerenciar versões anteriores da planilha.

  • Visualizar e gerenciar resultados de versões anteriores da planilha, desde que tenha a função usada para gerar os resultados.

  • Compartilhar a planilha com outras pessoas.

  • Adicionar a planilha a uma pasta diferente.

Ver + Executar

  • Herda todos os privilégios de Exibir resultados (veja abaixo).

  • Executar a planilha, desde que tenha a função da planilha.

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

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

Ver resultados

  • Herda todos os privilégios de Link com Ver resultados (veja abaixo).

  • Visualizar os resultados da versão mais recente da planilha, desde que tenha a função da planilha.

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

Link com Ver + Executar

  • Herda todos os privilégios de Link com Ver resultados (veja abaixo).

  • Executar a planilha, desde que tenha a função da planilha.

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

  • Visualizar o conteúdo da planilha (mas não pode duplicar ou executar a planilha).

Link com Ver resultados

  • Visualizar os resultados da versão mais recente da planilha, desde que tenha a função da planilha.

  • Visualizar o conteúdo da planilha (mas não pode duplicar ou 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 a planilha for adicionada a uma pasta de propriedade de outro usuário.

Importante

Se o proprietário de uma planilha for removido do Snowflake, o usuário removido permanecerá como proprietário da planilha; no entanto, usuários com quaisquer permissões de compartilhamento poderão continuar a acessar e usar a planilha. Qualquer usuário com o link da planilha ainda poderá acessá-la se o compartilhamento de link estiver habilitado. Para manter o acesso à planilha, a Snowflake recomenda que o usuário compartilhe suas planilhas com permissões de Editar (em vez de Ver ou Ver + Executar) antes de remover o usuário para que outros possam continuar a modificar ou excluir a planilha. Para recuperar as planilhas de propriedade de um usuário excluído, incluindo aquelas que não são compartilhadas, consulte Recuperação de planilhas de propriedade de um usuário descartado.

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

Quando você executa uma ou todas as consultas em uma planilha, os resultados da consulta são exibidos como uma tabela. Você pode navegar pelos resultados da consulta com as teclas de seta, como faria em uma planilha. Você pode selecionar colunas, células, linhas ou intervalos na tabela de resultados. Você pode copiar e colar qualquer seleção.

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

A Snowsight permite que você revise as estatísticas geradas para até 1 milhão de linhas de resultados. Essas estatísticas fornecem informações contextuais para qualquer seleção, bem como estatísticas gerais. Consulte Estatísticas contextuais automáticas para obter mais detalhes.

Você também pode:

Cuidado

Quando você executa uma planilha, os resultados são armazenados em cache. Qualquer pessoa com acesso à planilha pode ver esses resultados se tiver a mesma função principal que foi usada para gerá-los. Entretanto, se as consultas da planilha forem dados protegidos por mascaramento ou políticas de acesso a linhas, ou se funções secundárias estiverem ativas quando você executar a consulta, os resultados armazenados em cache poderão incluir dados que outros usuários com acesso à planilha talvez não consigam gerar.

Compartilhamento de uma planilha

Para compartilhar uma planilha, faça o seguinte:

  1. Faça login no 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. Insira os nomes dos usuários do Snowflake que você deseja convidar para usar sua planilha. A lista mostra apenas usuários que já entraram na Snowsight. Para compartilhar com alguém que ainda não entrou na Snowsight, selecione Get Link para gerar um link para compartilhar.

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

Um destinatário que não executou a planilha só pode ver até 10.000 linhas de resultados. Para exibir mais de 10.000 linhas de resultados, ele mesmo deve executar a planilha.

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.

Qualquer planilha que você compartilhar (diretamente ou por meio de um link) com um colaborador pode aparecer nos resultados da pesquisa ou na lista de planilhas dele. As planilhas compartilhadas diretamente aparecem imediatamente, enquanto aquelas compartilhadas por meio de um link aparecem assim que são acessadas. Essas planilhas continuarão aparecendo nos resultados de pesquisa ou nas listas do colaborador, a menos que sejam excluídas por um usuário com acesso de edição ou se as permissões de acesso do colaborador às planilhas forem removidas.

Compartilhamento de uma pasta de planilhas

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

  1. Faça login no Snowsight.

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

  3. Abra uma pasta.

  4. Selecione Share.

  5. Insira os nomes dos usuários do Snowflake para convidá-los 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 proprietário da pasta se tornará o proprietário da planilha, 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.

Qualquer pasta compartilhada (diretamente ou por meio de um link) com um colaborador pode aparecer nos resultados da pesquisa ou na lista de pastas. As pastas compartilhadas diretamente aparecem imediatamente, enquanto aquelas compartilhadas por meio de um link aparecem assim que são acessadas. Essas pastas continuarão aparecendo nos resultados de pesquisa ou nas listas do colaborador, a menos que sejam excluídas por um usuário com acesso de edição ou se as permissões de acesso do colaborador às planilhas forem removidas.

Compartilhar planilhas entre contas

As planilhas não podem ser replicadas ou compartilhadas entre contas. Para compartilhar o conteúdo de uma planilha com usuários em outra conta Snowflake, copie o conteúdo e compartilhe-o com usuários na conta fora do Snowflake.

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:

  1. Faça login no 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.

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:

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

  1. Faça login no 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

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