Todos os produtos
Search
Central de documentação

DataWorks:Create and manage custom rule templates

Última atualização: Jun 27, 2026

Ao gerenciar a qualidade de dados em grande escala, reescrever a mesma lógica de regra para cada tabela gera erros e dificulta a manutenção. Os modelos de regras permitem definir uma lógica de monitoramento SQL personalizada uma única vez e reutilizá-la em quantas tabelas forem necessárias. Ao atualizar um modelo, apenas as regras que o referenciam ativamente são afetadas; as regras de monitoramento criadas com versões anteriores permanecem inalteradas.

Pré-requisitos

Antes de começar, verifique se você possui:

  • DataWorks Enterprise Edition ou edição superior ativada

Por que usar modelos de regras

Recomendação

Benefício

Definir a lógica SQL uma única vez no modelo

Aplicação da mesma regra de monitoramento a várias tabelas sem reescrita repetida do SQL

Organizar modelos em pastas

Agrupamento de modelos relacionados por domínio ou equipe para facilitar a localização e a reutilização

Atualizar modelos centralizadamente

Alteração da lógica do modelo em um único local, afetando somente as regras que o referenciam

Criar um modelo de regra

  1. Faça logon no console do DataWorks. Na barra de navegação superior, selecione a região de destino. No painel de navegação à esquerda, escolha Data Governance > Data Quality, selecione um workspace na lista suspensa e clique em Go to Data Quality.

  2. No painel de navegação à esquerda, escolha Assets > Rule Template Library.

  3. Clique no ícone 新建 e selecione Create Folder.

  4. Na caixa de diálogo Create Folder, defina os parâmetros Name e Location e clique em OK.

  5. Na árvore de diretórios, clique com o botão direito do mouse na pasta e selecione Create Rule Template.

    Nota: Também é possível rename ou exclua a pasta pelo menu de contexto.
  6. Na caixa de diálogo Create Rule Template, configure os parâmetros.

    image.png

    Parâmetro

    Descrição

    Template Name

    Nome do modelo de regra.

    Field

    Campos a monitorar. Fixo como Custom SQL.

    Sampling Method

    Método de amostragem. Fixo como Custom SQL.

    Set Flag

    Cláusula SET da instrução SQL usada para consultar os campos monitorados. Separe várias instruções com vírgulas (,). Não adicione ponto e vírgula (;) ao final de cada instrução.

    Check type

    Tipo de limiar. Valores válidos: Numeric type e Fluctuation.

    Verification Method

    Método de comparação para o resultado da verificação. As opções dependem do valor de Check type; consulte a tabela abaixo.

    Custom SQL

    Instrução SQL para consultar os campos a monitorar. Use ${tableName} como espaço reservado para o nome da tabela. A consulta deve retornar um único valor comparável a um limiar.

    Location

    Pasta onde armazenar o modelo.

    Métodos de verificação e limiares obrigatórios por tipo de verificação

    As opções de Verification Method e os limiares necessários ao aplicar o modelo dependem do Check type selecionado.

    Check type

    Opções de método de verificação

    Limiares obrigatórios na aplicação

    Numeric type

    Compare with a specified value: a consulta deve retornar um único valor COUNT ou SUM para comparação com um número fixo

    Limiar normal + limiar crítico

    Fluctuation

    Comparação do valor atual com a média dos últimos 7 dias

    Limiar normal + limiar de aviso + limiar crítico

    Fluctuation

    Comparação do valor atual com a média dos últimos 30 dias

    Limiar normal + limiar de aviso + limiar crítico

    Fluctuation

    Comparação do valor atual com o valor de 1 dia antes

    Limiar normal + limiar de aviso + limiar crítico

    Fluctuation

    Comparação do valor atual com o valor de 7 dias antes

    Limiar normal + limiar de aviso + limiar crítico

    Fluctuation

    Comparação do valor atual com o valor de 30 dias antes

    Limiar normal + limiar de aviso + limiar crítico

    Fluctuation

    Variância entre o valor atual e o valor de 7 dias antes

    Limiar normal + limiar de aviso + limiar crítico

    Fluctuation

    Variância entre o valor atual e o valor de 30 dias antes

    Limiar normal + limiar de aviso + limiar crítico

    Fluctuation

    Comparação com os valores de 1, 7 e 30 dias antes

    Limiar normal + limiar de aviso + limiar crítico

    Fluctuation

    Comparação com o valor do ciclo anterior

    Limiar normal + limiar de aviso + limiar crítico

    SQL personalizado e o espaço reservado ${tableName}

    Use ${tableName} no SQL para tornar o modelo reutilizável em diferentes tabelas. O DataWorks substitui o nome real da tabela durante a execução. A consulta deve retornar um único valor em uma única linha. Para verificações do tipo Numeric type, esse valor deve ser o resultado de COUNT ou SUM.

  7. Clique em OK.

Gerenciar um modelo de regra

Clique no nome de um modelo na Rule Template Library para abrir a página de detalhes. Nela, visualize, edite, exclua ou copie o modelo.

Ação

Etapas

View

Revisão das configurações de parâmetros do modelo, das regras que o referenciam (aba Application List) e do histórico de operações (aba View Log). A aba View Log registra o usuário, o carimbo de data/hora e os detalhes de cada operação.

Edit

Clique em Edit no canto superior direito, atualize os parâmetros na caixa de diálogo Edit Rule Template e clique em OK.

Delete

Clique em Delete no canto superior direito e confirme na mensagem Delete Template.

Copy

Clique em Copy no canto superior direito. Na caixa de diálogo Clone Rule Template, defina um novo Template Name e Location e clique em OK.

Nota: As alterações em uma regra personalizada entram em vigor apenas para tarefas que referenciam a regra modificada. Tarefas existentes que utilizam a regra personalizada original não são afetadas.

Aplicar um modelo de regra a uma regra de monitoramento

  1. Na página Data Quality, escolha Configure Rules > Configure by Table no painel de navegação à esquerda.

  2. Na seção Connection, selecione o banco de dados da tabela que receberá as regras. Localize a tabela de destino filtrando por tipo de banco de dados, banco de dados e nome da tabela. Clique no nome da tabela ou em Rule Management na coluna Actions para abrir a página Table Quality Details. Essa página lista todas as regras configuradas para a tabela. Para regras não associadas a um monitor, defina o modo de execução diretamente nesta página.

    image

  3. Na aba Rule Management, selecione um monitor e clique em Create Rule. O painel Create Rule será aberto.

  4. Selecione o modelo de regra personalizado. Os campos FLAG parameter e SQL são preenchidos automaticamente a partir do modelo. Defina o Rule Name e configure os limiares conforme o tipo de verificação do modelo:

    Check type

    Limiares a configurar

    Numeric type

    Limiar normal e limiar crítico

    Fluctuation

    Limiar normal, limiar de aviso e limiar crítico

    image

  5. Clique em Determine.

Próximos passos