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 acompanhar cada mudança feita nos arquivos dentro 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 configurou durante a conexão do repositório.

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

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

Confirmar X mudança(ões)
Confirme o número de X das alterações locais no espaço de trabalho ou dos arquivos alterados selecionados. O Dataform exibe as alterações 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 alterações 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 alterações não confirmadas no seu espaço de trabalho.
Extrair da ramificação padrão
Atualize seus espaços de trabalho com alterações recentes da ramificação padrão. Essa opção está disponível em um repositório do Dataform se você não tiver alterações confirmadas não confirmadas ou não enviadas por push no seu espaço de trabalho.
Extrair de your-branch-name
Atualize seu espaço de trabalho com alterações 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 alterações confirmadas não confirmadas ou não enviadas por push no seu espaço de trabalho.
Reverter para a última confirmação
Restaure os arquivos no seu espaço de trabalho para o estado da última confirmação.

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 Criar um espaço de trabalho de desenvolvimento.

Funções exigidas

Para ter as permissões necessárias para usar o controle de versões 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 como conceder papéis, consulte Gerenciar acesso.

Talvez você também consiga receber as permissões necessárias por meio de papéis personalizados ou outros papéis predefinidos.

Extrair alterações

Se o espaço de trabalho de desenvolvimento não estiver sincronizado com o repositório, o Dataform exibirá a opção Pull. Para extrair alterações 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.
  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 Extrair de your-branch-name.

Confirmar alterações

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

Na caixa de diálogo Nova confirmação, o Dataform exibe as alterações não confirmadas.

Para confirmar alterações 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 Confirmar.

  4. No painel Nova confirmação, 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 os arquivos alterados por estado, nome de arquivo e caminho.

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

      O nome do botão depende da seleção de arquivos para confirmação.

Enviar alterações

O Dataform exibe a opção Push depois que você confirma as alterações. Para enviar alterações do espaço de trabalho de desenvolvimento para seu 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 alterações.
  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 alterações 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 combinação pode acontecer quando uma alteração local no espaço de trabalho de desenvolvimento é incompatível com uma alteração feita na ramificação de rastreamento padrão do repositório. Conflitos de mesclagem geralmente ocorrem quando vários usuários editam simultaneamente o mesmo arquivo.

Geralmente, há um conflito de mesclagem ao extrair de uma ramificação depois que outro usuário envia uma mudança conflitante para ela. Para resolver um conflito de mesclagem manualmente, 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 alterações.
  4. Opcional: Enviar alterações.

A seguir