Espaços de trabalho¶

Visão geral¶

O Espaços de Trabalho oferece um editor unificado para criar, organizar e gerenciar códigos em vários tipos de arquivos que você pode usar para analisar dados, desenvolver modelos e criar pipelines.

Um espaço de trabalho é privado para você e oferece um ambiente de desenvolvimento onde é possível criar, experimentar e testar seu trabalho. Todo o conteúdo do Workspaces é baseado em arquivos, o que lhe permite trabalhar em projetos mais complexos e integrar-se facilmente ao Git para controle de versão, colaboração e alinhamento com os fluxos de trabalho existentes.

O ambiente do Espaços de Trabalho¶

Espaços de Trabalho é um novo editor composto de seis seções ou painéis:

Espaços de Trabalho: uma área para todos os seus arquivos e pastas. Arraste os arquivos para movê-los entre as pastas. Use pastas aninhadas para agrupar planilhas relacionadas em categorias lógicas, de modo que você possa encontrar rapidamente planilhas específicas sem precisar procurar em uma lista fixa. Cada usuário tem um espaço de trabalho padrão chamado “My Workspace” (Meu espaço de trabalho) que é provisionado automaticamente pelo Snowflake. Você também pode criar um novo espaço de trabalho selecionando + Add New no menu do Workspaces. O espaço de trabalho padrão não pode ser excluído ou renomeado.
Planilhas: abra e edite as planilhas que você possui ou às quais tem permissões. Observe que as edições não serão salvas se você tiver apenas permissões de edição na planilha. Para converter uma planilha em um arquivo em um espaço de trabalho, arraste-a para uma pasta dentro do espaço de trabalho. As consultas do espaço de trabalho são executadas de forma semelhante às planilhas, com algumas pequenas diferenças, incluindo o desempenho aprimorado da UI e a capacidade de executar duas consultas simultaneamente a partir do mesmo arquivo SQL.
Explorador de objetos: uma visualização hierárquica de todos os bancos de dados em sua conta, os esquemas de cada banco de dados e outros objetos, organizados por tipo. Use o filtro para pesquisar objetos. Você também pode filtrar objetos inutilizáveis para simplificar a visualização, selecionando Show databases I can query. As opções disponíveis no botão de reticências verticais (mais ações) variam de acordo com o tipo de objeto, mas incluem recursos como colocar nomes no editor, copiar nomes e visualizar definições.
Editor: edite consultas e divida-as lado a lado para visualizar vários arquivos simultaneamente. Use o Copilot inline para obter sugestões e conclusões diretamente no espaço de trabalho do editor.
Resultados: divida os resultados lado a lado ou fixe-os para facilitar a comparação.
Histórico de consultas: visualize o histórico de todas as consultas que você executou. Current File mostra o histórico de consultas do arquivo aberto no momento e selecionado no editor. Filtre pelo arquivo atual ou por todos os arquivos. All Files exibe todas as consultas históricas que você executou em todos os arquivos.

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 no 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 fazer upload de 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:

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.

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 do Espaços de Trabalho, selecione as reticências verticais (mais ações) no painel do Workspaces e escolha a opção apropriada:

Dividir à direita
Dividir para baixo
Fechar outros

Integrar com um repositório Git¶

Os espaços de trabalho podem ser locais do Snowflake ou você pode sincronizar os espaços de trabalho em desenvolvimento com uma ramificação em um repositório Git. No Espaços de Trabalho, você pode:

Criar um espaço de trabalho que esteja conectado a um repositório Git.
Criar uma nova ramificação, trocar de ramificação ou buscar uma ramificação remota.
Obter as alterações mais recentes do seu repositório Git para o seu espaço de trabalho.
Acompanhar todos os arquivos adicionados, atualizados ou excluídos.
Confirmar e enviar arquivos atualizados de volta ao seu repositório Git.
Visualizar e resolver conflitos diretamente no Espaços de Trabalho.

Criar um espaço de trabalho Git¶

Você pode criar um espaço de trabalho conectado a um repositório Git para desenvolver e gerenciar arquivos diretamente na Snowsight.

Para criar um novo espaço de trabalho sincronizado com o Git:

Faça login no Snowsight.
No menu de navegação, selecione Projects » Workspaces.
No menu Workspaces, selecione From Git repository.
Copie o URL do seu repositório Git (por exemplo, https://www.github.com/my-user/my-repo-name) e cole-o no campo Repository URL.
Opcional: renomeie o novo espaço de trabalho sincronizado com o Git.
No menu API Integration, selecione uma integração de API.

Integrações de API são criadas pelo administrador de conta e devem permitir o acesso ao URL do repositório Git que você usar na etapa 4. Para obter detalhes, consulte Criar uma integração de API para interagir com a API do repositório.

Além disso, se você estiver usando o GitHub como provedor do Git e preferir OAuth para autenticação, o administrador da conta deverá criar uma integração de API compatível com OAuth. Por exemplo:
```
CREATE OR REPLACE API INTEGRATION api_integration_name
   API_PROVIDER = git_https_api
   API_ALLOWED_PREFIXES = ('https://github.com/')
   API_USER_AUTHENTICATION = (
      TYPE = snowflake_github_app
   )
   ENABLED = TRUE;
```
Copy
Na integração de API, selecione um método de autenticação:
- OAuth2 - Selecione Sign in para se autenticar com o repositório GitHub. Depois de fazer login, você não precisará fornecer credenciais em sessões futuras. Observe que OAuth2 não está disponível para ambientes PrivateLink.
- Personal access token - Selecione o banco de dados e o esquema em que o objeto que contém seu token está armazenado. Para criar um novo segredo, selecione + Secret e digite os detalhes necessários. A integração de API deve ser configurada para permitir o acesso a esse segredo ou a todos os segredos.
- Public repository - Selecione essa opção se estiver usando um repositório público que não exija autenticação. Observe que não é possível confirmar e enviar nenhuma alteração do seu espaço de trabalho para esse repositório público.
Selecione Create.

Atualizar os detalhes e as credenciais do autor para uma ramificação¶

Por padrão, seu e-mail e nome de usuário do Snowflake são usados para confirmar alterações no seu repositório Git. Você pode atualizá-los a qualquer momento.

Faça login no Snowsight.
No menu de navegação, selecione Projects » Workspaces.
Selecione a guia Changes.
Selecione as reticências e, em seguida, selecione Edit credentials.
Especifique o nome e o e-mail de um autor.
Selecione Update.

Criar uma nova ramificação¶

Você pode criar uma nova ramificação a partir da ramificação atual para trabalhar nas alterações de forma independente.

Faça login no Snowsight.
No menu de navegação, selecione Projects » Workspaces.
Selecione a guia Changes.
Selecione o menu suspenso do repositório.
Selecione + New.
Especifique um novo nome da ramificação e, em seguida, selecione Create.

Mudar para uma ramificação diferente¶

Se tiver alterações salvas, mas não confirmadas, você precisará escolher como lidar com elas antes de mudar de ramificação.

Faça login no Snowsight.
No menu de navegação, selecione Projects » Workspaces.
Na visualização do espaço de trabalho do Git, selecione Changes.
No menu de ramificações, selecione a ramificação para a qual você deseja mudar.

Dica: para filtrar a lista, comece a digitar o nome de uma ramificação.

Buscar ramificações remotas¶

Se uma nova ramificação foi criada fora do Snowsight (por exemplo, uma ramificação criada no seu provedor Git), você pode buscá-la no seu espaço de trabalho sincronizado com o Git usando a opção Fetch All. Isso atualiza sua lista de ramificações remotas disponíveis.

Faça login no Snowsight.
No menu de navegação, selecione Projects » Workspaces.
Na visualização do espaço de trabalho do Git, selecione Changes.
Selecione a seta para baixo ao lado do menu Pull e, em seguida, selecione Fetch All. Quando a busca é concluída, as ramificações remotas recém-criadas aparecem na lista de ramificações e estão disponíveis para check-out.

Exibir arquivos atualizados¶

Para visualizar todos os arquivos que foram adicionados, excluídos ou modificados desde a última confirmação e envio bem-sucedidos:

Faça login no Snowsight.
No menu de navegação, selecione Projects » Workspaces.
Na parte superior da visualização da pasta, selecione Changes. Os arquivos modificados são indicados com um M, os arquivos adicionados são indicados com um A e os arquivos excluídos são indicados com um D.
Para ver uma diferença visual das alterações no editor, selecione um arquivo.

Confirmar e enviar atualizações¶

Depois de revisar as alterações, você pode confirmá-las e enviá-las para o repositório Git remoto a partir do espaço de trabalho.

Para confirmar e enviar seus arquivos atualizados para o repositório Git remoto:

Faça login no Snowsight.
No menu de navegação, selecione Projects » Workspaces.
Selecione Changes na parte superior da exibição da pasta.
Escreva uma mensagem de confirmação no campo Commit message.
Selecione Push.
Escreva uma mensagem de confirmação e selecione Push para enviar suas atualizações para o repositório Git.

Nota

Se forem detectados conflitos, você será solicitado a retroceder primeiro. Selecione Pull para revisar uma lista de arquivos com conflitos.

Visualizar e resolver conflitos¶

Se ocorrer um conflito durante um envio, você poderá visualizá-lo e resolvê-lo diretamente no espaço de trabalho antes de confirmá-lo novamente.

No Espaços de Trabalho, na parte superior da visualização da pasta, selecione Changes. Se um ou mais arquivos tiverem um conflito, uma mensagem será exibida na parte superior da visualização. Os arquivos com conflito são indicados com um M vermelho.
Para visualizar uma diferença visual do conflito no editor, selecione um arquivo. Em File with conflicts, as diferenças são destacadas inline.
Aceite a alteração atual, uma alteração de entrada ou ambas as alterações. O resultado da mesclagem é mostrado.
Em Diff View, você pode visualizar as versões atual e remota lado a lado.
Selecione Accept all current ou Accept all remote.
Depois de resolver os conflitos, selecione Push.
Escreva uma mensagem de confirmação.
Selecione Push.

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	`CMD` + `Return`	`CTRL` + `Enter`
Executar tudo	`CMD` + `Shift` + `Return`	`CTRL` + `Alt` + `Enter`
Dividir o painel horizontalmente	`CTRL` + `\`	`CTRL` + `\`
Dividir o painel verticalmente	`CTRL` + `Shift` + `\`	`CTRL` + `Shift` + `\`

Gerenciar o Espaços de Trabalho¶

Para desativar o Espaços de Trabalho, defina o parâmetro ENABLE_PERSONAL_DATABASE no nível da conta como FALSE:

ALTER ACCOUNT SET ENABLE_PERSONAL_DATABASE = FALSE;

Copy

Esse parâmetro requer privilégios ACCOUNTADMIN. Depois que você definir como FALSE, o Espaços de Trabalho não funcionará; no entanto, o Espaços de Trabalho ainda estará listado no menu de navegação da Snowsight.

As funções secundárias não precisam ser ativadas para o Espaços de Trabalho, mas se você tiver políticas de sessão que bloqueiem explicitamente as funções secundárias, uma limitação atual impedirá que o Espaços de Trabalho funcione até que a política de sessão seja removida.

Considerações¶

Quando um usuário acessa o Espaços de Trabalho pela primeira vez, o Snowflake cria automaticamente um banco de dados interno específico do usuário (anteriormente chamado de Banco de dados pessoal). Esse banco de dados é usado exclusivamente para armazenar espaços de trabalho e não pode conter objetos padrão, como tabelas ou exibições. Ele não concede ao usuário nenhum recurso ou privilégio adicional além da habilitação da funcionalidade do Workspace.

Os administradores podem notar que os usuários parecem ter privilégios OWNERSHIP, USAGE e CREATE SCHEMA nesse banco de dados. Esses privilégios são necessários para interagir com o Espaços de Trabalho e não afetam o acesso a outros recursos.

Limitações¶

O Espaços de Trabalho não é compatível com o compartilhamento.
Não há suporte para filtros de consulta. Qualquer consulta que contenha filtros apresentará falha.
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.