Esta página foi traduzida pela API Cloud Translation.

Gerenciar um repositório

Este documento mostra como fazer o seguinte no Dataform:

Configure as configurações do fluxo de trabalho do Dataform.
Gerenciar o pacote principal do Dataform.
Controle de versões do código.

Antes de começar

Funções exigidas

Para receber as permissões necessárias para concluir as tarefas neste documento, peça ao administrador para conceder a você os seguintes papéis do IAM:

Configure as configurações do Dataform e gerencie o local do pacote principal do Dataform: Administrador do Dataform (roles/dataform.admin) em repositórios.
Atualize o pacote principal do Dataform e use o controle de versões no Dataform: Editor do Dataform (roles/dataform.editor) em 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 usando papéis personalizados ou outros papéis predefinidos.

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

Nesta seção, mostramos como editar as configurações de processamento do fluxo de trabalho do Dataform para um repositório específico.

É possível editar o arquivo de configurações para renomear os esquemas ou adicionar variáveis de compilação personalizadas ao seu repositório.

Sobre as configurações do repositório

Cada repositório do Dataform contém um arquivo exclusivo de configurações de fluxo de trabalho. O arquivo contém o ID do projeto Google Cloud e o esquema em que o Dataform publica recursos no BigQuery. O Dataform usa configurações padrão que podem ser substituídas para atender melhor às suas necessidades editando o arquivo de configurações.

Desde o Dataform Core 3.0.0, as configurações de fluxo de trabalho são armazenadas por padrão no arquivo workflow_settings.yaml. Em versões anteriores do Dataform Core, as configurações de fluxo de trabalho eram armazenadas no arquivo dataform.json. O arquivo workflow_settings.yaml do Dataform Core 3.0 é compatível com versões anteriores do arquivo dataform.json. Você pode continuar usando o arquivo dataform.json para armazenar as configurações do fluxo de trabalho. Como prática recomendada, migre as configurações do fluxo de trabalho do repositório para o formato workflow_settings.yaml para compatibilidade futura.

Sobre `workflow_settings.yaml`

O arquivo workflow_settings.yaml, introduzido no Dataform Core 3.0, armazena as configurações do fluxo de trabalho do Dataform no formato YAML.

O exemplo de código a seguir mostra um arquivo workflow_settings.yaml de amostra:

  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 em que o Dataform cria recursos, chamado dataform por padrão.
defaultLocation (opcional): o local padrão do conjunto de dados do BigQuery. O Dataform usa esse local para processar seu código e armazenar os resultados. Esse local de processamento precisa corresponder ao local dos seus conjuntos de dados do BigQuery. No entanto, não precisa corresponder ao local do repositório do Dataform.

Se você não definir o parâmetro defaultLocation, o Dataform vai determinar o local com base nos conjuntos de dados referenciados pela consulta SQL. Isso funciona da seguinte maneira:
- Se a consulta fizer referência a conjuntos de dados do mesmo local, o Dataform usará esse local.
- Se a consulta fizer referência a conjuntos de dados de dois ou mais locais diferentes, um erro vai ocorrer. Para mais detalhes sobre essa limitação, consulte Replicação de conjuntos de dados entre regiões.
- Se a consulta não fizer referência a nenhum conjunto de dados, o local padrão do Dataform será a multirregião US. Para escolher um local diferente, defina o local padrão. Como alternativa, use a variável de sistema @@location na sua consulta. Para mais informações, consulte Especificar locais.
defaultAssertionDataset: o conjunto de dados do BigQuery em que o Dataform cria visualizações com resultados de declaração, chamado dataform_assertions por padrão.

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

É possível acessar as propriedades definidas em workflow_settings.yaml no código do Dataform como propriedades do objeto dataform.projectConfig.

Os seguintes mapeamentos das opções de workflow_settings.yaml para as opções de dataform.projectConfig acessíveis por código são válidos:

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

O exemplo de código a seguir mostra o objeto dataform.projectConfig referenciado em uma instrução SELECT em uma visualização:

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

Sobre `dataform.json`

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

O exemplo de código a seguir mostra um arquivo dataform.json de amostra:

  {
    "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: um 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 em que o Dataform cria recursos.
defaultLocation (opcional): o local padrão do conjunto de dados do BigQuery. O Dataform usa esse local para processar seu código e armazenar os resultados. Esse local de processamento precisa corresponder ao local dos seus conjuntos de dados do BigQuery. No entanto, não precisa corresponder ao local do repositório do Dataform.

Se você não definir o parâmetro defaultLocation, o Dataform vai determinar o local com base nos conjuntos de dados referenciados pela consulta SQL. Isso funciona da seguinte maneira:
- Se a consulta fizer referência a conjuntos de dados do mesmo local, o Dataform usará esse local.
- Se a consulta fizer referência a conjuntos de dados de dois ou mais locais diferentes, um erro vai ocorrer. Para mais detalhes sobre essa limitação, consulte Replicação de conjuntos de dados entre regiões.
- Se a consulta não fizer referência a nenhum conjunto de dados, o local padrão do Dataform será a multirregião US. Para escolher um local diferente, defina o local padrão. Como alternativa, use a variável de sistema @@location na sua consulta. Para mais informações, consulte Especificar locais.
assertionSchema: o conjunto de dados do BigQuery em que o Dataform cria visualizações com resultados de declaração, chamado dataform_assertions por padrão.

Você pode acessar as propriedades definidas no arquivo dataform.json no código do projeto como propriedades do objeto dataform.projectConfig.

Configurar nomes de esquema

Para configurar nomes de esquema, edite as propriedades defaultDataset e defaultAssertionSchema no arquivo workflow_settings.yaml ou as propriedades defaultSchema e assertionSchema no arquivo dataform.json.

Para configurar o nome de um esquema, siga estas etapas:

`workflow_settings.yaml`

No espaço de trabalho de desenvolvimento, no painel Arquivos, clique no arquivo workflow_settings.yaml.
Edite o valor de defaultDataset, defaultAssertionSchema ou ambos.

O exemplo de código a seguir mostra um nome defaultDataset personalizado definido no arquivo workflow_settings.yaml:

  ...
  defaultDataset: mytables
  ...

`dataform.json`

No espaço de trabalho de desenvolvimento, no painel Arquivos, clique no arquivo dataform.json.
Edite o valor de defaultSchema, assertionSchema ou ambos.

O exemplo de código a seguir mostra um nome defaultSchema personalizado definido no arquivo dataform.json:

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

Criar variáveis de compilação personalizadas

As variáveis de compilação contêm valores que podem ser modificados com substituições de compilação em uma configuração de lançamento ou em uma solicitação da API Dataform.

Depois de definir uma variável de compilação em workflow_settings.yaml e adicioná-la às tabelas selecionadas, é possível modificar o valor dela em uma configuração de lançamento ou substituições de compilação da API Dataform para executar tabelas de forma condicional.

Para mais informações sobre como executar tabelas condicionalmente usando variáveis de compilação, consulte Introdução ao ciclo de vida do código no Dataform.

Para criar uma variável de compilação que pode ser usada em um repositório, siga estas etapas:

`workflow_settings.yaml`

Acesse seu espaço de trabalho de desenvolvimento do Dataform.
No painel Arquivos, selecione o arquivo workflow_settings.yaml.
Insira o seguinte snippet de código:
```
"vars": {
  "VARIABLE":"VALUE"
}
```
Substitua:
- VARIABLE: um nome para a variável
- VALUE: o valor padrão da variável de compilação.

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

...
vars:
  myVariableName: myVariableValue
...

O exemplo de código a seguir mostra o arquivo 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`

Acesse seu espaço de trabalho de desenvolvimento do Dataform.
No painel Arquivos, selecione o arquivo dataform.json.
Insira o seguinte snippet de código:
```
"vars": {
  "VARIABLE":"VALUE"
}
```
Substitua:
- VARIABLE: um nome para a variável
- VALUE: o valor padrão da variável de compilação.

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

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

O exemplo de código a seguir mostra o arquivo 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"
}
}

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

Para adicionar uma variável de compilação a um arquivo de definição de tabela SQLX, siga estas etapas:

Acesse seu espaço de trabalho de desenvolvimento do Dataform.
No painel Arquivos, selecione um arquivo de definição de tabela SQLX.
No arquivo, insira uma cláusula when no seguinte formato:
```
${when(dataform.projectConfig.vars.VARIABLE === "SET_VALUE", "CONDITION")}
```
Substitua:
- VARIABLE: o nome da 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 exemplo de código a seguir mostra um arquivo SQLX de definição de tabela com uma cláusula when e a variável executionSetting, que executa 10% dos dados na configuração de execução de teste:

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

O exemplo de código a seguir mostra um arquivo 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!"
  )}

Migrar configurações de fluxo de trabalho para `workflow_settings.yaml`

Para garantir que o arquivo de configurações do fluxo de trabalho seja compatível com versões futuras do framework principal do Dataform, migre as configurações do fluxo de trabalho do arquivo dataform.json para o arquivo workflow_settings.yaml.

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

Se o Dataform Core for o único pacote de dependência no seu repositório, o arquivo workflow_settings.yaml também vai substituir o arquivo package.json. Para mais informações sobre como substituir o arquivo package.json pelo workflow_settings.yaml, consulte Gerenciar o pacote principal do Dataform.

A tabela a seguir mostra o mapeamento das propriedades de configurações do fluxo de trabalho do arquivo dataform.json para o arquivo workflow_settings.yaml:

Propriedade em `dataform.json`	Propriedade em `workflow_settings.yaml`	Descrição
`assertionSchema`	`defaultAssertionDataset`	Obrigatório. O conjunto de dados padrão para asserções.
`defaultDatabase`	`defaultProject`	Obrigatório. O nome padrão do projeto Google Cloud .
`defaultLocation`	`defaultLocation`	Opcional. O local padrão do BigQuery em que o Dataform cria tabelas. Se não estiver definido, o Dataform vai determinar o local com base nos conjuntos de dados referenciados pela sua consulta SQL. Para mais informações, consulte Especificar locais.
`defaultSchema`	`defaultDataset`	Obrigatório. O conjunto de dados padrão.
`databaseSuffix`	`projectSuffix`	Opcional. O sufixo a ser anexado a todas as referências de projeto Google Cloud .
`schemaSuffix`	`datasetSuffix`	Opcional. O sufixo a ser anexado a todos os conjuntos de dados de ação.
`tablePrefix`	`namePrefix`	Opcional. O prefixo a ser adicionado ao início de todos os nomes de ações.
`vars`	`vars`	Opcional. Variáveis definidas pelo usuário que são disponibilizadas ao código do projeto durante a compilação. Um objeto com uma lista de pares `key: value`.
`warehouse`	-	Obrigatório em `dataform.json`. Precisa 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 padrão para novos repositórios. Para mais informações, consulte Gerenciar o pacote principal do Dataform.

Para migrar as configurações de fluxo de trabalho para o workflow_settings.yaml, siga estas etapas:

No Google Cloud console, acesse a página Dataform.

Acesse o Dataform
Selecione um repositório e um espaço de trabalho.
No painel Arquivos, clique em addAdicionar e em Criar arquivo.
No campo Adicionar um caminho de arquivo, insira workflow_settings.yaml.
Selecione Criar arquivo.
No arquivo workflow_settings.yaml, adicione as configurações do arquivo dataform.json, mapeadas para o formato YAML.
No painel Arquivos, clique no menu Mais ao lado de dataform.json e clique em Excluir.
Para confirmar a exclusão de dataform.json, clique em Excluir.

O exemplo de código a seguir mostra as configurações de fluxo de trabalho definidas em um arquivo dataform.json:

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

O exemplo de código a seguir mostra o arquivo dataform.json anterior convertido para workflow_settings.yaml:

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

Gerenciar o pacote principal do Dataform

Nesta seção, mostramos como gerenciar o pacote de dependência do framework principal do Dataform e atualizá-lo para a versão mais recente.

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

Gerenciar o local do pacote principal do Dataform

Quando você inicializa o primeiro espaço de trabalho em um repositório, o Dataform define automaticamente o Dataform Core como um pacote de dependência. A partir do Dataform Core 3.0.0, o Dataform instala o pacote do Dataform Core no arquivo workflow_settings.yaml por padrão. Em versões anteriores do Dataform Core, ele era definido no arquivo package.json.

No Dataform Core 3.0.0 e versões mais recentes, se o Dataform Core for o único pacote no seu repositório, defina-o no arquivo workflow_settings.yaml. Para repositórios criados com versões anteriores do Dataform Core, mova o pacote do Dataform Core para workflow_settings.yaml.

O arquivo package.json é necessário para instalar pacotes adicionais no Dataform. Se o repositório usar outros pacotes, defina o pacote principal do Dataform em package.json para que todos os pacotes sejam definidos em um só lugar. Se o repositório não tiver o arquivo package.json, crie o arquivo package.json e mova o pacote principal do Dataform para instalar outros pacotes.

Mover o Dataform Core para `workflow_settings.yaml`

Para repositórios criados com versões do Dataform Core anteriores a 3.0.0, se você não tiver pacotes de dependência além do Dataform Core, mova o pacote do Dataform Core do arquivo package.json para o arquivo workflow_settings.yaml e exclua o arquivo package.json redundante.

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

No Google Cloud console, acesse a página Dataform.

Acesse o Dataform
Selecione um repositório e um espaço de trabalho.
No painel Arquivos, selecione o arquivo workflow_settings.yaml.
No arquivo 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.
No painel Arquivos, clique no menu Mais ao lado do arquivo package.json e clique em Excluir.
Para confirmar a exclusão do arquivo dataform.json, clique em Excluir.
Clique em Instalar pacotes.

Mover o Dataform Core para `package.json`

O arquivo package.json é necessário para instalar pacotes adicionais em um repositório. Se o repositório usar outros pacotes, armazene todos eles, incluindo o pacote principal do Dataform, no arquivo package.json.

Se o repositório não tiver o arquivo package.json porque o pacote principal do Dataform está definido no arquivo workflow_settings.yaml, crie o arquivo package.json para instalar outros pacotes e mova o pacote principal do Dataform do arquivo workflow_settings.yaml para o arquivo package.json recém-criado.

Para criar o arquivo package.json e mover o pacote principal do Dataform, siga estas etapas:

No Google Cloud console, acesse a página Dataform.

Acesse o Dataform
Selecione um repositório e um espaço de trabalho.
No painel Arquivos, clique em addAdicionar e em Criar arquivo.
No campo Adicionar um caminho de arquivo, insira package.json.
Selecione Criar arquivo.
No arquivo 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.
Clique em Instalar pacotes.
No painel Arquivos, selecione workflow_settings.yaml.
No arquivo workflow_settings.yaml, exclua a propriedade dataformCoreVersion.

Atualizar o Dataform Core

Sempre teste novas versões de pacotes em um ambiente que não seja de produção antes de implantar no ambiente de produção.

Para atualizar o pacote de dependência principal do Dataform, siga estas etapas:

Procure a versão mais recente do @dataform/core na página de versões do Dataform no GitHub.
No Google Cloud console, acesse a página Dataform.

Acesse o Dataform
Selecione um repositório e um espaço de trabalho.
No painel Arquivos, selecione o arquivo package.json ou workflow_settings.yaml.

O local em que o pacote de dependência principal do Dataform é definido depende da sua versão do Dataform Core e do uso de pacotes. Para mais informações, consulte Gerenciar o local do pacote principal do Dataform.
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 principal do Dataform. Não use outras opções de dependencies do arquivo package.json, por exemplo, >version.
workflow_settings.yaml
```
dataformCoreVersion: "VERSION"
```
Substitua VERSION pela versão mais recente do Dataform, por exemplo, 3.0.0.
Clique em Instalar pacotes.
Confirme as mudanças.
Envie as mudanças para o repositório.

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

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

Controle de versões do código

Nesta seção, 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 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 ao conectar o repositório.

O Dataform mostra opções de controle de versões com base no status das mudanças no seu espaço de trabalho de desenvolvimento. Por exemplo, o Dataform mostra a opção de commit apenas 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 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 X mudança(s): Confirme o número X de mudanças locais no seu espaço de trabalho ou nos arquivos alterados selecionados. O Dataform mostra as mudanças não confirmadas.
Enviar para ramificação padrão: Envie as mudanças confirmadas para a ramificação padrão. Essa opção fica 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 mudanças 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 ramificação padrão. Essa opção fica disponível em um repositório do Dataform se você não tiver mudanças confirmadas ou enviadas no seu espaço de trabalho.
Extrair de your-branch-name: Atualize seu espaço de trabalho com as mudanças recentes do your-branch-name. Essa opção está disponível em um repositório conectado a um repositório Git de terceiros
Reverter para a última confirmação: Restaure os arquivos no seu espaço de trabalho para o estado do último commit.

Extrair mudanças

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

Na página Dataform, selecione um repositório.
Na guia Espaços de trabalho de desenvolvimento, selecione um espaço.
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.

Fazer commit

Depois de fazer uma mudança em um espaço de trabalho de desenvolvimento, o Dataform mostra a opção Fazer commit. Você pode confirmar todas as mudanças locais ou os arquivos selecionados.

Na caixa de diálogo Novo 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:

Na página Dataform, selecione um repositório.
Na página do repositório, selecione um espaço de trabalho de desenvolvimento.
Na página do espaço de trabalho de desenvolvimento, clique em Commit.
No painel Novo commit, faça o seguinte:
1. No campo Adicionar uma mensagem de commit, insira uma descrição para o commit.
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 e caminho.
3. Clique em Confirmar todas as mudanças ou Confirmar X mudanças.
  
  O nome do botão depende da sua seleção de arquivos para confirmação.

Enviar mudanças

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

Na página Dataform, selecione um repositório.
Na página do repositório, selecione um espaço de trabalho de desenvolvimento.
Confirmar mudanças.
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 as mudanças não confirmadas, siga estas etapas:

Na página Dataform, selecione um repositório.
Na página do repositório, selecione um espaço de trabalho de desenvolvimento.
Acima do painel Arquivos, clique no menu Mais e selecione Reverter para o último commit.

Resolver conflitos de mesclagem

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

Um conflito de mesclagem geralmente ocorre quando você extrai de uma ramificação depois que um usuário diferente envia uma mudança conflitante para a mesma ramificação. É necessário 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:

No espaço de trabalho de desenvolvimento, no painel Arquivos, selecione um arquivo afetado.
Edite o arquivo com as mudanças escolhidas.
Confirmar mudanças.
Opcional: Enviar mudanças.

A seguir

Para saber mais sobre as configurações do projeto do Dataform, consulte a referência IProjectConfig.
Para saber como instalar mais pacotes, consulte Instalar um pacote no Dataform.
Para saber como criar uma tabela, consulte Criar uma tabela.

Gerenciar um repositório Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Funções exigidas

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

Sobre as configurações do repositório

Sobre workflow_settings.yaml

Sobre dataform.json

Configurar nomes de esquema

workflow_settings.yaml

dataform.json

Criar variáveis de compilação personalizadas

workflow_settings.yaml

dataform.json

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

Migrar configurações de fluxo de trabalho para workflow_settings.yaml

Gerenciar o pacote principal do Dataform

Gerenciar o local do pacote principal do Dataform

Mover o Dataform Core para workflow_settings.yaml

Mover o Dataform Core para package.json

Atualizar o Dataform Core

package.json

workflow_settings.yaml

Controle de versões do código

Extrair mudanças

Fazer commit

Enviar mudanças

Reverter alterações não confirmadas

Resolver conflitos de mesclagem

A seguir

Gerenciar um repositório

Sobre `workflow_settings.yaml`

Sobre `dataform.json`

`workflow_settings.yaml`

`dataform.json`

`workflow_settings.yaml`

`dataform.json`

Migrar configurações de fluxo de trabalho para `workflow_settings.yaml`

Mover o Dataform Core para `workflow_settings.yaml`

Mover o Dataform Core para `package.json`

`package.json`

`workflow_settings.yaml`