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 alteração 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 alterações no seu 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 Workspace is atualizado.

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

Confirmar X alteração

Confirme o número de X de alterações locais no espaço de trabalho ou nos arquivos alterados selecionados.

Enviar para ramificação padrão

Envie as alterações confirmadas para a ramificação padrão. Essa opção estará 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 estará 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 estará disponível em um repositório do Dataform se você não tiver alterações confirmadas não confirmadas ou não enviadas em 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 estará 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 no seu espaço de trabalho.

Reverter para a última confirmação

Restaure os arquivos no espaço de trabalho para o estado da sua ú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.

Também é possível conseguir as permissões necessárias usando 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 seu 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 deles.
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 os arquivos selecionados.

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 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 confirmará todas as alterações locais. Os arquivos alterados podem ser filtrados por estado, nome de arquivo e caminho do arquivo.

   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 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 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 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 mesclagem pode ocorrer 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.

Você encontra um conflito de mesclagem geralmente ao extrair de uma ramificação depois que outro usuário enviou uma alteração conflitante para a mesma ramificação. Você precisa resolver um conflito de mesclagem manualmente editando 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 Arquivos, selecione um arquivo afetado.
2. Edite o arquivo com as mudanças.
3. Confirmar alterações.
4. Opcional: Enviar alterações.

A seguir

• Para saber como criar uma tabela, consulte Criar uma tabela.
• Para saber mais sobre o Dataform, consulte Visão geral do Dataform.