Configure validação e pontuação
Antes de começar
dq.validation-rule.create para acrescentar regras, e dq.score.read para ver as
pontuações resultantes. Os atributos precisam já estar definidos.
1. Comece com avisos
Uma nova regra de validação. A severidade assume error por padrão, o que recusa o registro — comece em warning.
Defina novas regras com severidade aviso primeiro. Você vai descobrir o que seus dados de fato violam, que quase nunca é o que você espera.
Começar com erros significa que a primeira carga em massa falha em volume, e a resposta usual é desativar a regra por completo — deixando cobertura nenhuma.
2. Escolha a severidade deliberadamente
| Severidade | Use quando |
|---|---|
| Erro | O valor é genuinamente inutilizável e um registro sem ele não faz sentido |
| Aviso | O valor está errado ou ausente mas o registro ainda é útil |
| Informativo | Vale expor, mas não deve afetar nada |
Reserve erros para valores genuinamente inaceitáveis. Um erro bloqueia a gravação — e dados bloqueados de entrar na plataforma não deixam de existir, apenas deixam de ser governados.
3. Escope regras por origem quando fizer sentido
Uma regra pode se aplicar a um sistema de origem. Isso expressa diferenças reais de obrigação: um sistema de atendimento pode ser obrigado a capturar telefone onde um feed analítico não é.
4. Promova regras a erro
Depois que as violações forem compreendidas e as piores corrigidas, promova as regras que devem genuinamente bloquear.
5. Verifique
A aba de qualidade de dados. A pontuação mede completude; violações são listadas à parte.
- Um valor violador produz a severidade esperada.
- Uma violação de severidade erro bloqueia a gravação; um aviso não.
- A violação aparece contra o registro.
A pontuação de qualidade mede completude, então uma violação de validação não a altera. Um registro pode ter 100 e ainda estar falhando regras. Leia a lista de violações para correção, e a pontuação para cobertura — elas respondem perguntas diferentes.
A seguir
Última verificação no commit d3c2586b (2026-08-03)