Adicionar tags de execução

Este documento mostra como adicionar tags a arquivos SQLX do núcleo do Dataform para categorizar seu fluxo de trabalho SQL.

Para organizar os componentes do fluxo de trabalho do SQL em coleções, adicione tags personalizadas a arquivos SQLX dos seguintes tipos:

  • table
  • view
  • incremental
  • assertion
  • operations

Durante a execução do fluxo de trabalho, é possível executar apenas arquivos com uma tag selecionada.

Com o Cloud Composer ou o Workflows com o Cloud Scheduler, é possível criar uma programação que execute um fluxo de trabalho do Dataform com uma tag selecionada em um intervalo específico.

Antes de começar

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

    Acesse a página do Dataform

  2. Selecione ou crie um repositório.

  3. Selecione ou crie um espaço de trabalho de desenvolvimento.

  4. Defina um arquivo SQLX de qualquer um dos seguintes tipos:

Funções exigidas

Para receber as permissões necessárias para adicionar uma tag a uma tabela, 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.

Adicionar uma tag

É possível adicionar várias tags a um arquivo SQLX.

Para adicionar uma tag a um arquivo SQLX, siga estas etapas:

  1. Acesse seu espaço de trabalho de desenvolvimento.
  2. No painel Files, abra definitions/.
  3. Selecione um arquivo SQLX.
  4. No bloco config, adicione uma tag no seguinte formato:

    tags: ["CUSTOM_TAG"]
    

    Substitua CUSTOM_TAG pela sua tag.

  5. Opcional: para adicionar várias tags, separe-as com uma vírgula ,.

  6. Opcional: clique em Formato.

O exemplo de código abaixo mostra a visualização user_counts com as tags daily e hourly:

config {
  type: "view",
  name: "user_counts",
  tags: ["daily", "hourly"]
}

A seguir