Integração de espaços de trabalho com um repositório Git¶

Criar um espaço de trabalho Git¶

Para desenvolver e manter arquivos diretamente em Snowsight, você pode criar um espaço de trabalho conectado a um repositório Git.

Para criar um novo espaço de trabalho sincronizado com o Git, siga estas etapas:

1. Faça login na Snowsight.

2. No menu de navegação, selecione Projects » Workspaces.

3. No menu Workspaces, selecione From Git repository.

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

5. Opcional: renomeie o novo espaço de trabalho sincronizado com o Git.

6. No menu API Integration, selecione uma integração de API.

   As integrações de API são criadas pelo administrador da conta e devem permitir o acesso ao URL do repositório Git que você usou na etapa 4. Para obter mais detalhes, consulte Configuração do Snowflake para usar o Git.

   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

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

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

1. Faça login na Snowsight.

2. No menu de navegação, selecione Projects » Workspaces.

3. Selecione a guia Changes.

4. Selecione as reticências e, em seguida, selecione Edit credentials.

5. Especifique o nome e o e-mail de um autor.

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

1. Faça login na Snowsight.

2. No menu de navegação, selecione Projects » Workspaces.

3. Selecione a guia Changes.

4. Selecione o menu suspenso do repositório.

5. Selecione + New.

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

1. Faça login na Snowsight.

2. No menu de navegação, selecione Projects » Workspaces.

3. Na visualização do espaço de trabalho do Git, selecione Changes.

4. No menu de ramificações, selecione a ramificação para a qual você deseja mudar.

   Dica

   Para filtrar a lista, comece a digitar um nome de 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.

1. Faça login na Snowsight.

2. No menu de navegação, selecione Projects » Workspaces.

3. Na visualização do espaço de trabalho do Git, selecione Changes.

4. 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 sua última confirmação e push, siga estas etapas:

1. Faça login na Snowsight.

2. No menu de navegação, selecione Projects » Workspaces.

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

4. 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, siga estas etapas:

1. Faça login na Snowsight.

2. No menu de navegação, selecione Projects » Workspaces.

3. Selecione Changes na parte superior da exibição da pasta.

4. Escreva uma mensagem de confirmação no campo Commit message.

5. Selecione Push.

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

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

2. Para visualizar uma diferença visual do conflito no editor, selecione um arquivo. Em File with conflicts, as diferenças são destacadas inline.

3. Aceite a alteração atual, uma alteração de entrada ou ambas as alterações. O resultado da mesclagem é mostrado.

4. Em Diff View, você pode visualizar as versões atual e remota lado a lado.

5. Selecione Accept all current ou Accept all remote.

6. Depois de resolver os conflitos, selecione Push.

7. Escreva uma mensagem de confirmação.

8. Selecione Push.