Introdução a planilhas¶
Visualizar, gerenciar e compartilhar planilhas na Snowsight. Você pode criar planilhas e importar as já existentes da Classic Console.
As planilhas SQL permitem escrever e executar instruções SQL, explorar e filtrar os resultados das consultas, e visualizar os resultados. Consulte Consulta de dados usando planilhas e Como visualizar dados de planilhas. Você também pode escrever o Snowpark Python em planilhas. Consulte Como escrever o código Snowpark nas planilhas Python.
Você pode rever o histórico da versão das planilhas e compartilhar planilhas com colegas que também usam o Snowflake. Consulte Como usar planilhas no Snowsight.
Neste tópico:
Como visualizar as planilhas na Snowsight¶
Depois de entrar na Snowsight, você verá as planilhas em sua conta. Se você não vir nenhuma planilha, poderá precisar importá-las da Classic Console. Consulte Importação de planilhas da Classic Console.
Usando as opções, você pode visualizar as planilhas recentes abertas por você, as planilhas que seus colegas compartilharam com você, as planilhas que você criou e possui, ou as pastas que você criou ou que seus colegas compartilharam com você.
Para qualquer planilha ou pasta de planilha, você pode rever o título, quando aproximadamente a planilha ou pasta foi vista ou atualizada pela última vez, e a função associada à planilha ou pasta. Em cada linha, você pode ver as iniciais do usuário que é proprietário da planilha ou pasta. Você pode ordenar por qualquer coluna da tabela.
Use a opção Search para pesquisar os títulos e conteúdos das planilhas e painéis de controle que você pode acessar.
Importação de planilhas da Classic Console¶
Você pode importar suas planilhas SQL da Classic Console para Snowsight de dentro da Snowsight.
Importe suas planilhas SQL para facilitar a referência a consultas e instruções SQL que você tenha escrito no passado, sem precisar mudar para uma interface da web e sessão diferentes.
Nota
Você pode importar suas planilhas para Snowsight mesmo que não consiga mais acessar a Classic Console.
Para importar suas planilhas SQL para Snowsight, faça o seguinte:
Entre em Snowsight.
Selecione Worksheets.
Selecione o menu mais … » Import Worksheets.
Na caixa de diálogo de confirmação, selecione Import.
Snowflake cria uma pasta chamada Import YYYY-MM-DD e coloca todas as planilhas da Classic Console nessa pasta.
Importante
Snowsight tem um tamanho máximo de planilha de 1MB. As planilhas maiores que 1MB não são importadas. Consulte Resolução de problemas com a atualização para Snowsight.
Após a importação das planilhas¶
As planilhas não são sincronizadas entre Snowsight e Classic Console. Se você fizer atualizações de uma planilha SQL na Snowsight, as mudanças não são refletidas na Classic Console, e vice-versa.
Como criar planilhas na Snowsight¶
Para criar uma planilha na Snowsight, faça o seguinte:
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Selecione + e selecione SQL Worksheet ou Python Worksheet para criar uma planilha.
A planilha se abre na mesma janela com a data e hora da criação como título padrão.
Você pode então começar a escrever em sua planilha. Para uma planilha SQL, comece a escrever as consultas. Para uma planilha Python, comece a escrever o código.
Para criar uma planilha SQL a partir de um arquivo SQL existente, faça o seguinte:
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Selecione o menu mais … » Create Worksheet from SQL File.
Navegue até o arquivo SQL para carregar.
Abre-se uma nova planilha com um título que corresponde ao nome do arquivo.
Você também pode adicionar um arquivo SQL a uma planilha SQL existente. Consulte Anexação de um script SQL a uma planilha existente.
Abertura de planilhas em guias¶
Você pode usar as guias para consultar várias planilhas ativas e explorar os bancos de dados e esquemas no Snowflake enquanto escreve instruções SQL ou código Python em Snowsight. Sua posição de rolagem é preservada em cada guia, facilitando as comparações entre planilhas. As guias da planilha são preservadas entre as sessões, para que você possa retomar o trabalho de onde parou.
Para abrir as planilhas da Snowsight em guias, faça o seguinte:
Entre em Snowsight.
Selecione Worksheets.
Selecione uma planilha existente ou selecione + Worksheet para abrir uma nova planilha. Uma planilha é aberta em uma guia.
Selecione uma função para executar a planilha e selecione um warehouse para alocar os recursos de computação para sua consulta.
No menu Worksheets, selecione uma planilha existente ou selecione + para abrir uma nova guia de planilha. Por padrão, a nova planilha usa o warehouse e função padrão.
(Opcional) Faça alterações na função ou no warehouse usado para executar a nova planilha.
Depois de abrir uma planilha, você pode atualizar o conteúdo, executar instruções SQL ou escrever o código Python e gerenciar a planilha.
Como gerenciar planilhas abertas¶
Depois de abrir uma planilha, selecione , visível quando você passa o mouse sobre a guia de uma planilha, para gerenciar a planilha aberta das seguintes maneiras:
Renomeie a planilha.
Mova a planilha para uma pasta ou um painel de controle.
Duplique a planilha.
Exclua a planilha.
Enquanto houver planilhas abertas, você também poderá visualizar e gerenciar outras planilhas no explorador Worksheets:
Como organizar planilhas em pastas¶
Você pode organizar e gerenciar planilhas em pastas usando a Snowsight.
Compartilhamento de planilhas e pastas¶
Snowsight permite compartilhar planilhas e pastas com outros usuários do Snowflake em sua conta para que eles possam visualizar ou executar as planilhas e pastas que você possui. Você só pode compartilhar diretamente com usuários que já tenham entrado na Snowsight antes.
Nota
As planilhas na Snowsight usam sessões exclusivas com funções específicas e warehouses designados no contexto da planilha. Se você compartilhar uma planilha com alguém que não tem a mesma função que você usou para executar a planilha, ele poderá duplicar a planilha e executá-la com uma de suas próprias funções.
Para compartilhar uma planilha, faça o seguinte:
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Abra uma planilha.
No canto superior direito da planilha, selecione Share.
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 os usuários que já se registraram na Snowsight antes. Se você quiser compartilhar com alguém que ainda não tenha entrado na Snowsight, compartilhe um link em vez disso.
Opcionalmente, defina como as pessoas com o link podem interagir com a planilha. Por padrão, as pessoas com o link não podem visualizar a planilha. Por exemplo, você pode optar por permitir que as pessoas vejam os resultados da planilha, mas não executar as consultas na planilha.
Opcionalmente, selecione Get Link para obter um link para a planilha que você pode compartilhar com os outros.
Selecione Done.
Nota
Se você compartilhar um rascunho da planilha, ou uma planilha com mudanças que ainda não tenham sido executadas, a versão da planilha compartilhada é a versão que foi executada pela última vez.
Para compartilhar uma pasta, incluindo todas as planilhas da pasta, faça o seguinte:
Entre em Snowsight.
Selecione Worksheets para abrir a lista de planilhas.
Abra uma pasta.
No canto superior direito da Worksheets page, selecione Share.
Digite os nomes ou nomes de usuário dos usuários do Snowflake que você deseja convidar para sua pasta. A lista mostra apenas os usuários que já se registraram na Snowsight antes. Se você quiser compartilhar com alguém que ainda não tenha entrado na Snowsight, compartilhe um link em vez disso.
Opcionalmente, defina como as pessoas com o link podem interagir com a pasta e as planilhas na pasta. Por padrão, as pessoas com o link não podem visualizar a pasta ou seu conteúdo. Por exemplo, você pode optar por permitir que as pessoas vejam os resultados de uma planilha, mas não executar as planilhas.
Opcionalmente, selecione Get Link para obter um link para a pasta que você pode compartilhar com os outros.
Selecione Done.
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 o 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 do 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.