Adicionar tags de execução

Neste documento, mostramos como adicionar tags aos arquivos SQLX do Dataform Core para categorizar o fluxo de trabalho SQL.

Para organizar os componentes do seu fluxo de trabalho SQL em coleções, é possível adicionar tags personalizadas aos 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 Workflows com o Cloud Scheduler, é possível criar uma programação que executa 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.

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

Adicionar uma tag

Você pode 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, expanda 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 vírgulas ,.

  6. Opcional: clique em Formatar.

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

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

A seguir