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 a inicialização desse espaço com um conjunto de arquivos de configuração necessários para que ele 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 Dataform Core ou JavaScript.

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

  • dataform.json: o arquivo de configuração padrão do Dataform que contém o ID do projeto do Google Cloud e o esquema do BigQuery em que os recursos são publicados. É possível substituir as configurações padrão para personalizá-las de acordo com suas necessidades, mas 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 exemplo de arquivo SQLX para ajudar você a começar.

Antes de começar

Crie um repositório do Dataform, caso ainda não tenha feito isso.

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

Talvez você também consiga receber as permissões necessárias por meio de papéis personalizados ou 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.

    Acesse 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 Create Development workspace.

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

    Acesse 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 de trabalho que você quer excluir.

  2. Para evitar a exclusão das alterações não confirmadas, confirme e envie por push as alterações para seu repositório 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 vez.

  4. Para confirmar, clique em Excluir.

A seguir