Como trabalhar com espaços de trabalho¶

Importante

A partir de setembro de 2025, Snowflake está atualizando gradualmente as contas de planilhas para espaços de trabalho. Os espaços de trabalho se tornarão o editor SQL padrão. Para obter mais informações, consulte Contas padrão de Planilhas para Workspaces.

Criar e trabalhar com arquivos e pastas¶

Em um espaço de trabalho, é possível usar um IDE familiar e obter convenções de controle para criar, organizar e executar o código.

Faça login na Snowsight.
No menu de navegação, selecione Projects » Workspaces.
Selecione + ao lado da pasta apropriada. Se estiver usando o Espaços de Trabalho pela primeira vez, selecione + Add New.
Selecione uma das seguintes opções para criar um novo arquivo ou pasta ou para carregar um arquivo ou pasta existente:
- SQL File: cria um arquivo SQL novo e em branco no editor como uma guia no editor. Por padrão, .sql é anexado a arquivos sem nome. O editor o reconhece como um arquivo SQL e ativa o realce de sintaxe e o preenchimento automático.
- File: cria um novo arquivo. Dê um nome ao arquivo e à sua extensão. Se a extensão for reconhecida pelo editor (por exemplo, Java, JavaScript ou Scala), o realce do código e o preenchimento automático serão ativados.
- Folder: cria uma pasta nova e vazia dentro do espaço de trabalho.
- Upload Files: carregue um ou mais arquivos em qualquer local no seu espaço de trabalho. O editor usa a extensão do arquivo e aplica o ícone, o comportamento e o realce de sintaxe apropriados ao arquivo quando ele é aberto. Por exemplo, os arquivos .sql mostram recursos específicos do SQL.
- Upload Folder: selecione um ou mais arquivos ou pastas para adicionar ao espaço de trabalho selecionado.

Gerenciar arquivos¶

Você pode renomear, excluir, mover e organizar seus espaços de trabalho, arquivos e pastas.

Para renomear ou excluir um espaço de trabalho, arquivo ou pasta, siga estas etapas:

Passe o mouse sobre o destino e selecione as reticências verticais (mais ações).
Selecione Rename ou Delete. Se você optar por excluir, receberá uma solicitação para confirmar.

Para criar uma pasta em um espaço de trabalho, selecione + ao lado do espaço de trabalho ou de uma pasta existente.
Para organizar arquivos e pastas, arraste qualquer arquivo ou pasta para um local diferente no mesmo espaço de trabalho. Você também pode arrastar uma planilha para um espaço de trabalho.

Formatar código SQL¶

Os espaços de trabalho incluem uma funcionalidade integrada para formatar e padronizar o código SQL para melhor legibilidade e manutenção.

No Workspaces editor, selecione as reticências horizontais.
Selecione Format SQL ou use o atalho de teclado command + shift + O (Windows: CTRL + Alt + O).

Organização de seções de código¶

Use a junção de código para recolher e expandir grandes blocos de código, permitindo que você se concentre em seções específicas e melhore a navegação geral do código.

No Workspaces editor, localize a seção de código a ser recolhida.
Passe o mouse para a direita dos números da linha. Um ícone de abertura de código () aparece na linha de dobra.
Alterne o ícone para abrir ou abrir a seção de código.

Visualizar vários arquivos ou resultados em um único layout¶

O gerenciamento de vários arquivos com guias e painéis divididos oferece várias vantagens:

Comparar códigos ou resultados lado a lado: consulte rapidamente uma consulta de planilha enquanto trabalha em outra.
Realização de várias tarefas com mais eficiência: visualize diferentes células, saídas ou arquivos ao mesmo tempo sem precisar alternar com frequência.

Para ajustar o layout dos espaços de trabalho, selecione as reticências verticais () no painel do Workspaces e escolha a opção apropriada:

Dividir à direita
Dividir para baixo
Fechar outros

Atalhos do teclado¶

As planilhas oferecem atalhos de teclado para ajudar você a navegar rapidamente, personalizar a visualização e editar consultas. A tabela a seguir identifica os atalhos de teclado comumente usados:

Tarefa	Atalho do MacOS	Atalho do Windows
Executar selecionado	`command` + `return`	`CTRL` + `Enter`
Executar tudo	`command` + `shift` + `return`	`CTRL` + `Shift` + `Enter`
Formatar arquivo SQL	`command` + `shift` + `O`	`CTRL` + `Alt` + `O`
Dividir o painel horizontalmente	`control` + `\`	`CTRL` + `\`
Dividir o painel verticalmente	`control` + `shift` + `\`	`CTRL` + `Shift` + `\`
Fechar guia em foco	`control` + `W`	`CTRL` + `Q`
Copiar arquivo selecionado	`command` + `C`	`CTRL` + `C`
Recortar arquivo selecionado	`command` + `X`	`CTRL` + `X`
Colar arquivo na localização selecionada	`command` + `V`	`CTRL` + `V`
Abrir painel de resultados da consulta	`control` + `option` + `↑`	`CTRL` + `Alt` + `↑`
Fechar painel de resultados da consulta	`control` + `option` + `↓`	`CTRL` + `Alt` + `↓`
Abrir Copilot em linha	`command` + `I`	`CTRL` + `I`
Inserir comentário no código	`command` + `/`	`CTRL` + `/`
Ir para o início do arquivo	`command` + `home` ou `command` + `↑`	`CTRL` + `home` ou `CTRL` + `↑`
Ir para o fim do arquivo	`command` + `end` ou `command` + `↓`	`CTRL` + `end` ou `CTRL` + `↓`

Recuperação de um espaço de trabalho de um usuário descartado¶

Mesmo quando um usuário é descartado, seu banco de dados pessoal (PDB) e todos os arquivos dentro de seus espaços de trabalho são mantidos. O PDB é então renomeado para DROPPED_USER$<dropped_user_name>_<timestamp>.

Nota

A recuperação de um espaço de trabalho não se limita à pessoa que executou o comando DROP. Qualquer usuário com a mesma função pode recuperar o espaço de trabalho, pois o PDB mantém sua propriedade sob a função que iniciou o comando.

Para recuperar um espaço de trabalho do PDB de um usuário descartado, siga estes passos:

Encontre o PDB do usuário descartado. Use o comando SHOW DATABASES com uma função LIKE para localizar o banco de dados específico:
```
SHOW DATABASES LIKE 'dropped_user%';
```
Copy
Visualize os espaços de trabalho no PDB. Use o comando SHOW WORKSPACES IN DATABASE para listar os espaços de trabalho disponíveis:
```
SHOW WORKSPACES IN DATABASE DROPPED_USER$dropped_user_1754344912;
```
Copy
Crie um novo espaço de trabalho a partir do recuperado. Use o comando CREATE WORKSPACE … FROM para criar um espaço de trabalho a partir do recuperado.

Isso copia o conteúdo para um novo local, tornando-o acessível.

Nota

Você deve usar o qualificador USER$ para colocar o espaço de trabalho em seu próprio banco de dados pessoal. Caso contrário, ocorrerá um erro. O carimbo de data/hora no final do nome do banco de dados varia.
```
FROM 'snow://workspace/DROPPED_USER$dropped_user_1754344912.PUBLIC."to_be_recovered"/versions/head';
```
Copy

Limitações¶

O Espaços de Trabalho não é compatível com o compartilhamento.
Snowflake Copilot is not available in Workspaces.
Não há suporte para filtros de consulta. Qualquer consulta que contenha filtros falhará.
Os arquivos do Espaços de Trabalho não são incluídos nos resultados da Universal Search.
Abrir e editar a mesma planilha na nova UI do Espaços de Trabalho e na antiga UI do Planilhas de Trabalho simultaneamente pode resultar na perda de alterações.
Para planilhas, as configurações do contexto de execução (função, warehouse e namespace) não são sincronizadas entre a nova UI do Espaços de Trabalho e a antiga UI do Planilhas de Trabalho.