Criar um espaço de trabalho de desenvolvimento do Dataform

Esta página mostra como fazer o seguinte:

Quando você cria um espaço de trabalho de desenvolvimento em um novo repositório pela primeira vez, o Dataform solicita que você inicialize o espaço de trabalho de desenvolvimento com um conjunto de arquivos de configuração necessários para que o Dataform funcione.

Um espaço de trabalho de desenvolvimento inicializado contém os seguintes diretórios e arquivos:

  • definitions/: um diretório para definições de recursos, no núcleo do Dataform ou JavaScript.

  • includes/: um diretório vazio para scripts e variáveis que podem ser reutilizados no repositório.

  • workflow_settings.yaml: o arquivo de configuração padrão do Dataform que contém o ID do projeto do Google Cloud e o esquema do BigQuery para publicar ativos. É possível substituir as configurações padrão para personalizá-las de acordo com suas necessidades, mas isso não é um requisito para começar a usar o Dataform.

  • package.json: o arquivo de configuração padrão de dependências do Dataform com a versão mais recente de @dataform/core. É possível usar esse arquivo para importar pacotes.

  • definitions/sample.sqlx: um arquivo SQLX de exemplo para ajudar você a começar.

Antes de começar

Se ainda não tiver feito isso, crie um repositório do Dataform.

Funções exigidas

Para receber as permissões necessárias para criar, inicializar e excluir um espaço de trabalho de desenvolvimento, peça ao administrador que conceda a você o papel do IAM Editor de formulário de dados (roles/dataform.editor) nos 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 por meio de papéis personalizados ou de outros papéis predefinidos.

Criar um espaço de trabalho de desenvolvimento do Dataform

Para criar um novo espaço de trabalho de desenvolvimento do Dataform, siga estas etapas:

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

    Acessar o Dataform

  2. Selecione o repositório em que você quer criar o novo espaço de trabalho de desenvolvimento.

  3. Na página do repositório, clique em Criar espaço de trabalho de desenvolvimento.

  4. Na janela Criar espaço de trabalho de desenvolvimento, faça o seguinte:

    1. No campo ID do espaço de trabalho, insira um ID exclusivo para o espaço de trabalho de desenvolvimento.

      Os IDs só podem incluir números, letras, hifens e sublinhados.

    2. Clique em Criar.

Inicializar o primeiro espaço de trabalho de desenvolvimento em um repositório do Dataform

Para inicializar um espaço de trabalho de desenvolvimento do Dataform, siga estas etapas:

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

    Acessar o Dataform

  2. Selecione o repositório em que você quer inicializar o espaço de trabalho vazio.

  3. Na guia Espaços de trabalho de desenvolvimento, clique no nome do espaço de trabalho vazio que você quer inicializar.

  4. Na página do espaço de trabalho de desenvolvimento, clique em Inicializar espaço de trabalho.

Excluir um espaço de trabalho de desenvolvimento do Dataform

Não há custos associados à criação de espaços de trabalho de desenvolvimento do Dataform. No entanto, se você quiser excluir um espaço de trabalho de desenvolvimento, siga estas etapas:

  1. Na página Dataform, clique no repositório que contém o espaço que você quer excluir.

  2. Para evitar a exclusão de alterações não confirmadas, confirme e envie as mudanças para o repositório do Git.

  3. Na guia Espaços de trabalho de desenvolvimento, selecione o espaço de trabalho de desenvolvimento que você quer excluir e clique em Excluir espaços de trabalho selecionados.

    É possível excluir vários espaços de trabalho de uma só vez.

  4. Para confirmar, clique em Excluir.

A seguir