Controle de versões do código

Neste documento, mostramos como usar o controle de versões no Dataform para acompanhar o desenvolvimento.

O Dataform usa o Git para monitorar cada mudança feita nos arquivos de um repositório.

Em um repositório do Dataform, você interage diretamente com o repositório Git.

Em um repositório conectado, você interage com a ramificação de rastreamento do repositório remoto que você configurou durante a conexão do repositório.

O Dataform mostra opções de controle de versão com base no status das mudanças no espaço de trabalho de desenvolvimento. Por exemplo, o Dataform mostra a opção de confirmação somente quando há mudanças locais não confirmadas no seu espaço de trabalho. Quando os arquivos no seu espaço de trabalho são uma cópia exata da sua ramificação padrão ou de rastreamento, o Dataform mostra o status O espaço de trabalho está atualizado.

O Dataform mostra as seguintes opções de controle de versão:

Confirmar as alterações X
Confirme o número X de alterações locais no seu espaço de trabalho ou arquivos alterados selecionados. O Dataform mostra as mudanças não confirmadas.
Enviar para ramificação padrão
Envie as alterações confirmadas para a ramificação padrão. Essa opção está disponível em um repositório do Dataform se você não tiver mudanças não confirmadas no seu espaço de trabalho.
Enviar para your-branch-name
Envie as alterações confirmadas para your-branch-name. Essa opção está disponível em um repositório conectado a um repositório Git de terceiros se você não tiver mudanças não confirmadas no seu espaço de trabalho.
Extrair da ramificação padrão
Atualize seus espaços de trabalho com as mudanças recentes da sua ramificação padrão. Essa opção está disponível em um repositório do Dataform se você não tiver mudanças não confirmadas ou não enviadas no seu espaço de trabalho.
Extrair de your-branch-name
Atualize seu espaço de trabalho com as mudanças recentes de your-branch-name. Essa opção está disponível em um repositório conectado a um repositório Git de terceiros se você não tiver mudanças não confirmadas ou não enviadas no seu espaço de trabalho.
Reverter para a última confirmação
Restaure os arquivos no seu espaço de trabalho para o estado do último commit.

Antes de começar

  1. Selecione ou Crie um repositório.
  2. Opcional: conecte seu repositório a um repositório Git de terceiros.
  3. Selecione ou Crie um espaço de trabalho de desenvolvimento.

Funções exigidas

Para receber as permissões necessárias para usar o controle de versão no Dataform, peça ao administrador para conceder a você o Papel do IAM de editor do Dataform (roles/dataform.editor) nos espaços de trabalho. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Extrair mudanças

Se o espaço de trabalho de desenvolvimento estiver fora de sincronia com o repositório, o Dataform vai mostrar a opção Pull. Para extrair mudanças do repositório para o espaço de trabalho de desenvolvimento, siga estas etapas:

  1. Na página Dataform, selecione um repositório.
  2. Na guia Espaços de trabalho de desenvolvimento, selecione um espaço de trabalho.
  3. Na página do espaço de trabalho de desenvolvimento, faça o seguinte:
    1. Se você estiver em um repositório do Dataform, clique em Extrair da ramificação padrão.
    2. Se você estiver em um repositório conectado a um repositório Git de terceiros, clique em Pull from your-branch-name.

Fazer commit

Depois que você faz uma mudança em um espaço de trabalho de desenvolvimento, o Dataform mostra a opção Commit. Você pode confirmar todas as mudanças locais ou arquivos selecionados.

Na caixa de diálogo New commit, o Dataform mostra as mudanças não confirmadas.

Para confirmar as mudanças do espaço de trabalho de desenvolvimento no repositório, siga estas etapas:

  1. Na página Dataform, selecione um repositório.
  2. Na página do repositório, selecione um espaço de trabalho de desenvolvimento.
  3. Na página do espaço de trabalho de desenvolvimento, clique em Commit.

  4. No painel New commit, faça o seguinte:

    1. No campo Adicionar uma mensagem de confirmação, insira uma descrição para a confirmação.

    2. Selecione os arquivos alterados que você quer confirmar.

      Se você não selecionar nenhum arquivo, o Dataform vai confirmar todas as mudanças locais. É possível filtrar arquivos alterados por estado, nome e caminho.

    3. Clique em Confirmar todas as alterações ou Confirmar alterações de X.

      O nome do botão depende da seleção de arquivos a serem confirmados.

Enviar mudanças

O Dataform mostra a opção Push depois que você confirma as mudanças. Para enviar as mudanças do espaço de trabalho de desenvolvimento para o repositório, siga estas etapas:

  1. Na página Dataform, selecione um repositório.
  2. Na página do repositório, selecione um espaço de trabalho de desenvolvimento.
  3. Confirmar as mudanças.
  4. Na página do espaço de trabalho de desenvolvimento, faça o seguinte:
    1. Se você estiver em um repositório do Dataform, clique em Enviar para a ramificação padrão.
    2. Se você estiver em um repositório conectado a um repositório Git de terceiros, clique em Enviar para your-branch-name.

Reverter alterações não confirmadas

Para reverter as mudanças não confirmadas, siga estas etapas:

  1. Na página Dataform, selecione um repositório.
  2. Na página do repositório, selecione um espaço de trabalho de desenvolvimento.
  3. Acima do painel Files, clique no menu More e selecione Revert to last commit.

Resolver conflitos de mesclagem

Um conflito de integração pode acontecer quando uma mudança local no espaço de trabalho de desenvolvimento é incompatível com uma mudança feita na ramificação de rastreamento padrão do repositório. Conflitos de mesclagem geralmente ocorrem quando vários usuários editam o mesmo arquivo simultaneamente.

Você encontra um conflito de mesclagem normalmente quando extrai de uma ramificação depois que outro usuário fez uma alteração conflitante na mesma ramificação. Para resolver um conflito de mesclagem, edite o arquivo afetado.

O exemplo de código a seguir mostra um conflito de mesclagem exibido em um arquivo SQLX:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

Para resolver um conflito de mesclagem, siga estas etapas:

  1. No espaço de trabalho de desenvolvimento, no painel Files, selecione um arquivo afetado.
  2. Edite o arquivo com as mudanças escolhidas.
  3. Confirmar as mudanças.
  4. Opcional: alterações de push.

A seguir