Gerenciando dados de referência
Dados de referência são os vocabulários controlados contra os quais seus dados mestres são governados: países, moedas, códigos de situação, classificações setoriais. Gerenciá-los centralmente é o que impede o mesmo conceito de ser grafado de três formas em três sistemas.
As três peças
A tela de dados de referência, onde os vocabulários controlados abaixo são definidos e versionados.
| Peça | O que faz |
|---|---|
| Tipo de lookup | Uma lista controlada |
| Valor de lookup | Uma entrada permitida: um código estável e um rótulo legível |
| Mapa de transcodificação | Transforma o código de um sistema de origem no canônico |
Códigos e rótulos
Um valor de lookup separa seu código do seu rótulo. O código é estável e é o que fica armazenado; o rótulo é o que as pessoas leem e pode ser traduzido ou reescrito sem tocar em dados armazenados.
Essa separação é por que renomear um país na interface não reescreve nenhum registro que o referencie.
Atributos vinculados a um tipo de lookup aceitam apenas seus códigos. A plataforma resolve códigos para rótulos na leitura, então todo consumidor exibe a mesma coisa.
Transcodificação
Sistemas de origem discordam sobre códigos. Um envia US, outro USA, um
terceiro 840. A transcodificação mapeia cada um para um único valor canônico na
entrada.
Um crosswalk liga um registro a um sistema de origem. A transcodificação mapeia um valor de código para um canônico. Algumas plataformas usam a palavra "crosswalk" para essa segunda ideia — esta documentação a reserva estritamente para a primeira.
Sem transcodificação, a comparação vê US e USA como discordância e pontua
dois registros da mesma pessoa como evidência contra uma correspondência.
Hierarquias
Alguns dados de referência são uma classificação nivelada em vez de uma lista plana — uma taxonomia setorial, uma agregação geográfica, uma árvore de categorias. Hierarquias modelam isso, permitindo classificar entidades numa folha e agregar em qualquer nível acima.
Duas ideias distintas são fáceis de confundir:
| Conceito | O que é |
|---|---|
| Árvore de valores | Um valor de lookup referenciando um valor pai — uma lista aninhada |
| Hierarquia nivelada | Uma estrutura nomeada com níveis ordenados na qual entidades são classificadas |
Ambas são legítimas; respondem perguntas diferentes. Uma árvore de valores restringe quais valores são permitidos; uma hierarquia nivelada apoia agregação e análise.
Datas de vigência
Dados de referência mudam: um país se divide, um código de situação é aposentado. Valores de lookup carregam janelas de vigência para que registros históricos continuem resolvendo corretamente, em vez de exibirem um vazio onde havia um código aposentado.
Conselhos
- Semeie a partir de padrões onde existirem. Códigos ISO de país, moeda e idioma são problemas resolvidos.
- Vincule atributos cedo. Adaptar um vocabulário controlado depois significa limpar todos os valores existentes.
- Transcodifique na fronteira. Mapeie na entrada, para que tudo a jusante veja um só vocabulário.
- Aposente em vez de excluir. Um código em uso por registros históricos precisa continuar resolvendo.
A seguir
Última verificação no commit d3c2586b (2026-08-03)