Atualizar o pacote principal do Dataform

Neste documento, mostramos como atualizar o Dataform Core para a versão mais recente.

O Dataform Core é o framework de código aberto para desenvolver fluxos de trabalho SQL com SQLX e JavaScript.

Quando você inicializa o primeiro espaço de trabalho em um repositório, o Dataform instala automaticamente o Dataform Core como um pacote de dependência no arquivo package.json.

Recomendamos que você 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.

Para evitar problemas com a instalação do pacote no ambiente de produção, recomendamos que você faça o seguinte:

  • Especifique explicitamente a versão do pacote principal do Dataform em package.json, por exemplo, 3.0.0. Não use outras opções dependencies de package.json, como >version.

  • Testar novas versões de pacote em um ambiente de não produção. Para mais informações sobre como configurar diferentes ambientes de ciclo de vida do código, consulte Como gerenciar o ciclo de vida do código.

Antes de começar

  1. Crie um repositório.
  2. Crie e inicialize um espaço de trabalho de desenvolvimento.

Funções exigidas

Para ter as permissões necessárias para atualizar o 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 receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Atualizar o Dataform Core

  1. Procure a versão mais recente do @dataform/core na página de versões do Dataform no GitHub (link em inglês).

  2. No Console do Google Cloud, acesse a página Dataform.

    Acessar a página do Dataform

  3. Selecione um repositório e depois um espaço de trabalho.

  4. No painel Arquivos, abra o arquivo package.json.

  5. Atualize a dependência @dataform/core com a versão mais recente do Dataform neste formato:

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

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

  6. Clique em Install packages.

  7. Confirmar alterações.

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

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

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

A seguir