Adicionar tags de execução

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

Para organizar componentes do fluxo de trabalho do SQL em coleções, é possível adicionar 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 os Fluxos de trabalho com o Cloud Scheduler, é possível criar uma programação para executar 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 do 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 conseguir as permissões necessárias para adicionar uma tag a uma tabela, peça ao administrador que conceda a você o papel de Editor do Dataform (roles/dataform.editor) nos espaços de trabalho. Para obter mais informações sobre como conceder papéis, consulte Gerenciar o acesso.

Também é possível conseguir as permissões necessárias com papéis personalizados ou 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, 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 uma vírgula ,.

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