Faça a gestão de um repositório

Este documento mostra como fazer o seguinte no Dataform:

• Configure as definições do fluxo de trabalho do Dataform.
• Faça a gestão do pacote principal do Dataform.
• Controle as versões do seu código.

Antes de começar

1. Crie um repositório.
2. Opcional: associe o seu repositório a um repositório Git de terceiros.
3. Crie e inicialize um espaço de trabalho de desenvolvimento no seu repositório.

Funções necessárias

Para receber as autorizações de que precisa para concluir as tarefas neste documento, peça ao seu administrador que lhe conceda as seguintes funções da IAM:

• Configure as definições do Dataform e faça a gestão da localização do pacote principal do Dataform: Administração do Dataform (roles/dataform.admin) em repositórios.
• Atualize o pacote principal do Dataform e use o controlo de versões no Dataform: Editor do Dataform (roles/dataform.editor) em espaços de trabalho.

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Configure as definições do fluxo de trabalho do Dataform

Esta secção mostra como editar as definições de processamento do fluxo de trabalho do Dataform para um repositório específico.

Pode querer editar o ficheiro de definições para mudar o nome dos esquemas ou adicionar variáveis de compilação personalizadas ao seu repositório.

Acerca das definições do repositório

Cada repositório do Dataform contém um ficheiro de definições de fluxo de trabalho exclusivo. O ficheiro contém o ID do projeto Google Cloud e o esquema no qual o Dataform publica recursos no BigQuery. O Dataform usa predefinições que pode substituir para melhor satisfazer as suas necessidades editando o ficheiro de definições.

A partir do Dataform core 3.0.0, as definições do fluxo de trabalho são armazenadas no ficheiro workflow_settings.yaml por predefinição. Nas versões anteriores do Dataform core, as definições do fluxo de trabalho são armazenadas no ficheiro dataform.json. O ficheiro Dataform core 3.0 workflow_settings.yaml é retrocompatível com o ficheiro dataform.json. Pode continuar a usar o ficheiro dataform.json para armazenar as definições do fluxo de trabalho. Como prática recomendada, deve migrar as definições do fluxo de trabalho do repositório para o formato workflow_settings.yaml para compatibilidade futura.

Acerca de workflow_settings.yaml

O ficheiro workflow_settings.yaml, introduzido no Dataform core 3.0, armazena as definições do fluxo de trabalho do Dataform no formato YAML.

O seguinte exemplo de código mostra um ficheiro workflow_settings.yaml de exemplo:

  defaultProject: my-gcp-project-id
  defaultDataset: dataform
  defaultLocation: australia-southeast2
  defaultAssertionDataset: dataform_assertions

No exemplo de código anterior, os pares de chave-valor são descritos da seguinte forma:

• defaultProject: o ID do projeto do BigQuery Google Cloud .
• defaultDataset: o conjunto de dados do BigQuery no qual o Dataform cria recursos, denominado dataform por predefinição.
• defaultLocation: a região do seu conjunto de dados predefinido do BigQuery. Nesta localização, o Dataform processa o seu código e armazena os dados executados. Esta região de processamento tem de corresponder à localização dos seus conjuntos de dados do BigQuery, mas não tem de corresponder à região do repositório do Dataform. Para mais informações sobre as localizações dos conjuntos de dados do BigQuery, consulte o artigo Localizações dos conjuntos de dados.
• defaultAssertionDataset: o conjunto de dados do BigQuery no qual o Dataform cria vistas com resultados de validação, denominado dataform_assertions por predefinição.

Para mais informações sobre as propriedades workflow_settings.yaml, consulte WorkflowSettings no GitHub.

Pode aceder às propriedades definidas em workflow_settings.yaml no seu código do Dataform como propriedades do objeto dataform.projectConfig.

Aplicam-se os seguintes mapeamentos das opções workflow_settings.yaml para as opções dataform.projectConfig acessíveis por código:

• defaultProject => defaultDatabase
• defaultDataset => defaultSchema
• defaultAssertionDataset => assertionSchema
• projectSuffix => databaseSuffix
• datasetSuffix => schemaSuffix
• namePrefix => tablePrefix

O seguinte exemplo de código mostra o objeto dataform.projectConfig referenciado numa declaração SELECT numa vista:

  config { type: "view" }
  SELECT ${when(
    !dataform.projectConfig.tablePrefix,
    "table prefix is set!",
    "table prefix is not set!"
  )}

Acerca de dataform.json

O ficheiro dataform.json armazena as definições do fluxo de trabalho do Dataform no formato JSON.

O seguinte exemplo de código mostra um ficheiro dataform.json de exemplo:

  {
    "warehouse": "bigquery",
    "defaultDatabase": "my-gcp-project-id",
    "defaultSchema": "dataform",
    "defaultLocation": "australia-southeast2",
    "assertionSchema": "dataform_assertions"
  }

No exemplo de código anterior, os pares de chave-valor são descritos da seguinte forma:

• warehouse: ponteiro para o BigQuery, onde o Dataform cria recursos.
• defaultDatabase: o ID do projeto do BigQuery Google Cloud .
• defaultSchema: o conjunto de dados do BigQuery no qual o Dataform cria recursos.
• defaultLocation: a região do seu conjunto de dados predefinido do BigQuery. Nesta localização, o Dataform processa o seu código e armazena os dados executados. Esta região de processamento tem de corresponder à localização dos seus conjuntos de dados do BigQuery, mas não tem de corresponder à região do repositório do Dataform. Para mais informações sobre as localizações dos conjuntos de dados do BigQuery, consulte o artigo Localizações dos conjuntos de dados.
• assertionSchema: o conjunto de dados do BigQuery no qual o Dataform cria vistas com resultados de validação, denominado dataform_assertions por predefinição.

Pode aceder às propriedades definidas no ficheiro dataform.json no código do projeto como propriedades do objeto dataform.projectConfig.

Configure os nomes dos esquemas

Para configurar os nomes dos esquemas, tem de editar as propriedades defaultDataset e defaultAssertionSchema no ficheiro workflow_settings.yaml ou as propriedades defaultSchema e assertionSchema no ficheiro dataform.json.

Para configurar o nome de um esquema, siga estes passos:

workflow_settings.yaml

1. No espaço de trabalho de desenvolvimento, no painel Ficheiros, clique no ficheiro workflow_settings.yaml.

2. Edite o valor de defaultDataset, defaultAssertionSchema ou ambos.

O seguinte exemplo de código mostra um nome defaultDataset personalizado definido no ficheiro workflow_settings.yaml:

  ...
  defaultDataset: mytables
  ...

dataform.json

1. No espaço de trabalho de desenvolvimento, no painel Ficheiros, clique no ficheiro dataform.json.

2. Edite o valor de defaultSchema, assertionSchema ou ambos.

O seguinte exemplo de código mostra um nome defaultSchema personalizado definido no ficheiro dataform.json:

{
  ...
  "defaultSchema": "mytables",
  ...
}

Crie variáveis de compilação personalizadas

As variáveis de compilação contêm valores que pode modificar com substituições de compilação numa configuração de lançamento ou num pedido da API Dataform.

Depois de definir uma variável de compilação em workflow_settings.yaml e adicioná-la às tabelas selecionadas, pode modificar o respetivo valor numa configuração de lançamento ou nas substituições de compilação da API Dataform para executar tabelas condicionalmente.

Para mais informações sobre a execução condicional de tabelas através de variáveis de compilação, consulte o artigo Introdução ao ciclo de vida do código no Dataform.

Para criar uma variável de compilação que pode usar num repositório, siga estes passos:

workflow_settings.yaml

1. Aceda ao espaço de trabalho de desenvolvimento do Dataform.
2. No painel Ficheiros, selecione o ficheiro workflow_settings.yaml.

3. Introduza o seguinte fragmento do código:

   "vars": {
     "VARIABLE":"VALUE"
   }
   

   Substitua o seguinte:

   • VARIABLE: um nome para a variável
   • VALUE: o valor predefinido da variável de compilação

O seguinte exemplo de código mostra a variável de compilação myVariableName definida como myVariableValue no ficheiro workflow_settings.yaml:

...
vars:
  myVariableName: myVariableValue
...

O seguinte exemplo de código mostra o ficheiro workflow_settings.yaml com a variável de compilação executionSetting definida como dev:

defaultProject: default_bigquery_database
defaultLocation: us-west1
defaultDataset: dataform_data,
vars:
executionSetting: dev

dataform.json

1. Aceda ao espaço de trabalho de desenvolvimento do Dataform.
2. No painel Ficheiros, selecione o ficheiro dataform.json.

3. Introduza o seguinte fragmento do código:

   "vars": {
     "VARIABLE":"VALUE"
   }
   

   Substitua o seguinte:

   • VARIABLE: um nome para a variável
   • VALUE: com o valor predefinido da variável de compilação

O seguinte exemplo de código mostra a variável de compilação myVariableName definida como myVariableValue no ficheiro dataform.json:

{
  ...
  "vars": {
    "myVariableName": "myVariableValue"
  },
  ...
}

O seguinte exemplo de código mostra o ficheiro dataform.json com a variável de compilação executionSetting definida como dev:

{
"warehouse": "bigquery",
"defaultSchema": "dataform_data",
"defaultDatabase": "default_bigquery_database".
"defaultLocation":"us-west-1",
"vars": {
"executionSetting":"dev"
}
}

Adicione uma variável de compilação a uma tabela

Para adicionar uma variável de compilação a um ficheiro de definição de tabela SQLX, siga estes passos:

1. Aceda ao espaço de trabalho de desenvolvimento do Dataform.
2. No painel Ficheiros, selecione um ficheiro de definição de tabela SQLX.

3. No ficheiro, introduza uma cláusula when no seguinte formato:

   ${when(dataform.projectConfig.vars.VARIABLE === "SET_VALUE", "CONDITION")}
   

   Substitua o seguinte:

   • VARIABLE: o nome da sua variável, por exemplo, executionSetting
   • SET_VALUE: um valor para a variável, por exemplo, staging
   • CONDITION: uma condição para a execução da tabela

O seguinte exemplo de código mostra um ficheiro SQLX de definição de tabela com uma cláusula when e a variável executionSetting que executa 10% dos dados na definição de execução de preparação:

  select
    *
  from ${ref("data")}
  ${when(
    dataform.projectConfig.vars.executionSetting === "staging",
    "where mod(farm_fingerprint(id) / 10) = 0",
  )}

O seguinte exemplo de código mostra um ficheiro SQLX de definição de visualização com uma cláusula when e a variável myVariableName:

  config { type: "view" }
  SELECT ${when(
    dataform.projectConfig.vars.myVariableName === "myVariableValue",
    "myVariableName is set to myVariableValue!",
    "myVariableName is not set to myVariableValue!"
  )}

Migre as definições do fluxo de trabalho para workflow_settings.yaml

Para garantir que o ficheiro de definições do fluxo de trabalho é compatível com versões futuras da estrutura principal do Dataform, deve migrar as definições do fluxo de trabalho do ficheiro dataform.json para o ficheiro workflow_settings.yaml.

O ficheiro workflow_settings.yaml substitui o ficheiro dataform.json.

Se o Dataform core for o único pacote de dependências no seu repositório, o ficheiro workflow_settings.yaml também substitui o ficheiro package.json. Para mais informações sobre como substituir o ficheiro package.json pelo ficheiro workflow_settings.yaml, consulte o artigo Faça a gestão do pacote principal do Dataform.

A tabela seguinte mostra o mapeamento das propriedades das definições do fluxo de trabalho do ficheiro dataform.json para o ficheiro workflow_settings.yaml:

Propriedade em dataform.json	Propriedade em workflow_settings.yaml	Descrição
assertionSchema	defaultAssertionDataset	Obrigatório. O conjunto de dados predefinido para afirmações.
defaultDatabase	defaultProject	Obrigatório. O Google Cloud nome do projeto predefinido.
defaultLocation	defaultLocation	Obrigatório. A localização predefinida do BigQuery onde o Dataform cria tabelas. Para mais informações sobre as localizações do BigQuery, consulte o artigo Localizações de conjuntos de dados.
defaultSchema	defaultDataset	Obrigatório. O conjunto de dados predefinido.
databaseSuffix	projectSuffix	Opcional. O sufixo a anexar a todas as referências de Google Cloud projetos.
schemaSuffix	datasetSuffix	Opcional. O sufixo a anexar a todos os conjuntos de dados de ações.
tablePrefix	namePrefix	Opcional. O prefixo a adicionar a todos os nomes de ações.
vars	vars	Opcional. Variáveis definidas pelo utilizador que são disponibilizadas ao código do projeto durante a compilação. Um objeto que contém uma lista de pares key: value.
warehouse	-	Obrigatório em dataform.json. Tem de ser definido como bigquery. Não disponível em workflow_settings.yaml.
-	dataformCoreVersion	Não disponível em dataform.json. Instalado em workflow_settings.yaml por predefinição para novos repositórios. Para mais informações, consulte o artigo Faça a gestão do pacote principal do Dataform.

Para migrar as definições do fluxo de trabalho para o workflow_settings.yaml, siga estes passos:

1. Na Google Cloud consola, aceda à página Dataform.

   Aceder ao Dataform

2. Selecione um repositório e, de seguida, selecione um espaço de trabalho.

3. No painel Ficheiros, clique em adicionarAdicionar e, de seguida, em Criar ficheiro.

4. No campo Adicionar um caminho de ficheiro, introduza workflow_settings.yaml.

5. Clique em Criar ficheiro.

6. No ficheiro workflow_settings.yaml, adicione as definições do ficheiro dataform.json mapeadas para o formato YAML.

7. No painel Ficheiros, clique no menu Mais junto a dataform.json e, de seguida, clique em Eliminar.

8. Para confirmar a eliminação de dataform.json, clique em Eliminar.

O seguinte exemplo de código mostra as definições do fluxo de trabalho definidas num ficheiro dataform.json:

{
  "warehouse": "bigquery",
  "defaultDatabase": "dataform-demos",
  "defaultLocation": "US",
  "defaultSchema": "dataform",
  "assertionSchema": "dataform_assertions"
  "vars": {
    "environmentName": "development"
  }
}

O seguinte exemplo de código mostra o ficheiro dataform.json anterior convertido em workflow_settings.yaml:

defaultProject: dataform-demos
defaultLocation: US
defaultDataset: dataform
defaultAssertionDataset: dataform_assertions
vars:
    environmentName: "development"

Faça a gestão do pacote principal do Dataform

Esta secção mostra como gerir o pacote de dependências da framework principal do Dataform e atualizá-lo para a versão mais recente.

O Dataform core é a framework Dataform de código aberto para desenvolver fluxos de trabalho com SQL, SQLX e JavaScript. Como prática recomendada, use sempre a versão mais recente disponível da estrutura principal do Dataform. Para obter informações sobre os lançamentos da framework Dataform core, consulte os lançamentos do Dataform no GitHub.

Faça a gestão da localização do pacote principal do Dataform

Quando inicializa o primeiro espaço de trabalho num repositório, o Dataform define automaticamente o Dataform core como um pacote de dependências. A partir do Dataform core 3.0.0, o Dataform instala o pacote Dataform core no ficheiro workflow_settings.yaml por predefinição. Nas versões anteriores do Dataform core, o Dataform core era definido no ficheiro package.json.

No Dataform core 3.0.0 e posterior, se o Dataform core for o único pacote no seu repositório, deve defini-lo no ficheiro workflow_settings.yaml. Para repositórios criados com versões anteriores do Dataform core, mova o pacote Dataform core para workflow_settings.yaml.

O ficheiro package.json é necessário para instalar pacotes adicionais no Dataform. Se o seu repositório usar pacotes adicionais, defina o pacote principal do Dataform em package.json para que todos os pacotes sejam definidos num único local. Se o seu repositório não tiver o ficheiro package.json, crie o ficheiro package.json e mova o pacote principal do Dataform para instalar pacotes adicionais.

Mova o Dataform core para workflow_settings.yaml

Para repositórios criados com versões do Dataform core anteriores a 3.0.0, se não tiver pacotes de dependências além do Dataform core, deve mover o pacote Dataform core do ficheiro package.json para o ficheiro workflow_settings.yaml e eliminar o ficheiro package.json redundante.

Para migrar o pacote principal do Dataform do ficheiro package.json para o ficheiro workflow_settings.yaml, faça o seguinte:

1. Na Google Cloud consola, aceda à página Dataform.

   Aceder ao Dataform

2. Selecione um repositório e, de seguida, selecione um espaço de trabalho.

3. No painel Ficheiros, selecione o ficheiro workflow_settings.yaml.

4. No ficheiro workflow_settings.yaml, adicione o pacote principal do Dataform no seguinte formato:

   dataformCoreVersion: "VERSION"
   
   

   Substitua VERSION pela versão mais recente do Dataform, por exemplo, 3.0.0.

5. No painel Ficheiros, clique no menu Mais junto ao ficheiro e, de seguida, clique em Eliminar.package.json

6. Para confirmar a eliminação do ficheiro dataform.json, clique em Eliminar.

7. Clique em Instalar pacotes.

Mova o Dataform core para package.json

O ficheiro package.json é necessário para instalar pacotes adicionais num repositório. Se o seu repositório usar pacotes adicionais, deve armazenar todos os pacotes, incluindo o pacote principal do Dataform, no ficheiro package.json.

Se o seu repositório não contiver o ficheiro package.json porque o pacote principal do Dataform está definido no ficheiro workflow_settings.yaml, tem de criar o ficheiro package.json para instalar pacotes adicionais e, em seguida, mover o pacote principal do Dataform do ficheiro workflow_settings.yaml para o ficheiro package.json recém-criado.

Para criar o ficheiro package.json e mover o pacote principal do Dataform, siga estes passos:

1. Na Google Cloud consola, aceda à página Dataform.

   Aceder ao Dataform

2. Selecione um repositório e, de seguida, selecione um espaço de trabalho.

3. No painel Ficheiros, clique em adicionarAdicionar e, de seguida, clique em Criar ficheiro.

4. No campo Adicionar um caminho de ficheiro, introduza package.json.

5. Clique em Criar ficheiro.

6. No ficheiro package.json, adicione o pacote principal do Dataform no seguinte formato:

   {
       "dependencies": {
           "@dataform/core": "VERSION"
       }
   }
   

   Substitua VERSION pela versão mais recente do Dataform, por exemplo, 3.0.0.

7. Clique em Instalar pacotes.

8. No painel Ficheiros, selecione workflow_settings.yaml.

9. No ficheiro workflow_settings.yaml, elimine a dataformCoreVersion propriedade.

Atualize o Dataform Core

Teste sempre as novas versões de pacotes num ambiente de não produção antes de as implementar no seu ambiente de produção.

Para atualizar o pacote de dependência principal do Dataform, siga estes passos:

1. Procure a versão mais recente do @dataform/core na página de lançamentos do Dataform no GitHub.

2. Na Google Cloud consola, aceda à página Dataform.

   Aceder ao Dataform

3. Selecione um repositório e, de seguida, selecione um espaço de trabalho.

4. No painel Ficheiros, selecione o ficheiro package.json ou o ficheiro workflow_settings.yaml.

   A localização onde o pacote de dependência do Dataform core está definido depende da sua versão do Dataform core e da sua utilização de pacotes. Para mais informações, consulte o artigo Faça a gestão da localização do pacote principal do Dataform.

5. Atualize o pacote de dependência principal do Dataform com a versão mais recente:

   package.json

   {
       "dependencies": {
           "@dataform/core": "VERSION"
       }
   }
   

   Substitua VERSION pela versão mais recente do Dataform, por exemplo, 3.0.0. Para evitar problemas com a instalação de pacotes, especifique explicitamente a versão do pacote Dataform core. Não use outras dependencies opções do ficheiro package.json, por exemplo, >version.

   workflow_settings.yaml

   dataformCoreVersion: "VERSION"
   

   Substitua VERSION pela versão mais recente do Dataform, por exemplo, 3.0.0.

6. Clique em Instalar pacotes.

7. Aplique as alterações.

8. Envie as alterações para o seu repositório.

O seguinte exemplo de código mostra a dependência @dataform/core atualizada para a versão 3.0.0 no ficheiro package.json:

{
    "dependencies": {
        "@dataform/core": "3.0.0"
    }
}

Use o controlo de versões do seu código

Esta secção mostra-lhe como usar o controlo de versões no Dataform para acompanhar o desenvolvimento.

O Dataform usa o Git para acompanhar todas as alterações feitas aos ficheiros num repositório.

Num repositório do Dataform, interage diretamente com o repositório do Git.

Num repositório associado, interage com o ramo de acompanhamento do repositório remoto que configurou ao associar o repositório.

O Dataform apresenta opções de controlo de versões com base no estado das alterações no seu espaço de trabalho de desenvolvimento. Por exemplo, o Dataform apresenta a opção de confirmação apenas quando existem alterações locais não confirmadas no seu espaço de trabalho. Quando os ficheiros no seu espaço de trabalho são uma cópia exata do ramo de acompanhamento ou predefinição, o Dataform apresenta o estado O espaço de trabalho está atualizado.

O Dataform apresenta as seguintes opções de controlo de versões:

Aplique X alteração(ões)

Confirme o número de alterações locais X no seu espaço de trabalho ou nos ficheiros alterados selecionados. O Dataform apresenta as alterações não confirmadas.

Enviar para o ramo predefinido

Envie as alterações comprometidas para o ramo predefinido. Esta opção está disponível num repositório do Dataform se não tiver alterações não comprometidas no seu espaço de trabalho.

Enviar para your-branch-name

Envie as alterações confirmadas para your-branch-name. Esta opção está disponível num repositório associado a um repositório Git de terceiros se não tiver alterações não comprometidas no seu espaço de trabalho.

Retirar do ramo predefinido

Atualize os seus espaços de trabalho com as alterações recentes da ramificação predefinida. Esta opção está disponível num repositório do Dataform se não tiver alterações comprometidas ou enviadas não comprometidas no seu espaço de trabalho.

Retirar de your-branch-name

Atualize o seu espaço de trabalho com as alterações recentes de your-branch-name. Esta opção está disponível num repositório associado a um repositório Git de terceiros se não tiver alterações confirmadas ou enviadas no seu espaço de trabalho.

Reverter para a última confirmação

Restaure os ficheiros no seu espaço de trabalho para o estado do último commit.

Extraia alterações

Se o seu espaço de trabalho de desenvolvimento estiver dessincronizado com o repositório, o Dataform apresenta a opção Extrair. Para obter alterações do seu repositório para o seu espaço de trabalho de desenvolvimento, siga estes passos:

1. Na página Dataform, selecione um repositório.
2. No separador Espaços de trabalho de desenvolvimento, selecione um espaço de trabalho de desenvolvimento.
3. Na página do espaço de trabalho de desenvolvimento, faça o seguinte:
   1. Se estiver num repositório do Dataform, clique em Extrair do ramo predefinido.
   2. Se estiver num repositório associado a um repositório Git de terceiros, clique em Extrair de your-branch-name.

Confirme as alterações

Depois de fazer uma alteração num espaço de trabalho de desenvolvimento, o Dataform apresenta a opção Commit. Pode confirmar todas as alterações locais ou ficheiros selecionados.

Na caixa de diálogo Novo commit, o Dataform apresenta as alterações não confirmadas.

Para confirmar as alterações do seu espaço de trabalho de desenvolvimento no repositório, siga estes passos:

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

4. No painel Novo compromisso, faça o seguinte:

   1. No campo Adicione uma mensagem de confirmação, introduza uma descrição para a confirmação.

   2. Selecione os ficheiros alterados que quer confirmar.

      Se não selecionar nenhum ficheiro, o Dataform confirma todas as alterações locais. Pode filtrar os ficheiros alterados por estado do ficheiro, nome do ficheiro e caminho.

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

      O nome do botão depende da sua seleção de ficheiros para confirmar.

Enviar alterações

O Dataform apresenta a opção Enviar depois de confirmar as alterações. Para enviar alterações do seu espaço de trabalho de desenvolvimento para o repositório, siga estes passos:

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. Aplique as alterações.
4. Na página do espaço de trabalho de desenvolvimento, faça o seguinte:
   1. Se estiver num repositório do Dataform, clique em Enviar para o ramo predefinido.
   2. Se estiver num repositório associado a um repositório Git de terceiros, clique em Enviar para your-branch-name.

Reverter alterações não consolidadas

Para reverter alterações não consolidadas, siga estes passos:

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 Ficheiros, clique no menu Mais e, de seguida, selecione Reverter para a última confirmação.

Resolva conflitos de união

Pode ocorrer um conflito de intercalação quando uma alteração local no seu espaço de trabalho de desenvolvimento é incompatível com uma alteração feita ao ramo de controlo predefinido do seu repositório. Normalmente, os conflitos de união ocorrem quando vários utilizadores editam o mesmo ficheiro em simultâneo.

Normalmente, ocorre um conflito de união quando extrai de um ramo depois de um utilizador diferente ter enviado uma alteração em conflito para o mesmo ramo. Tem de resolver manualmente um conflito de união editando o ficheiro afetado.

O seguinte exemplo de código mostra um conflito de união apresentado num ficheiro SQLX:

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

Para resolver um conflito de união, siga estes passos:

1. No espaço de trabalho de desenvolvimento, no painel Ficheiros, selecione um ficheiro afetado.
2. Edite o ficheiro com as alterações escolhidas.
3. Aplique as alterações.
4. Opcional: envie as alterações.

O que se segue?

• Para saber mais sobre as definições do projeto do Dataform, consulte a IProjectConfig referência.
• Para saber como instalar pacotes adicionais, consulte o artigo Instale um pacote no Dataform.
• Para saber como criar uma tabela, consulte o artigo Criar uma tabela.