Pular para o conteúdo principal

Entidades, crosswalks e registros dourados

Três conceitos sustentam todo o resto.

Entidade​

Uma única coisa do mundo real que a plataforma governa — uma pessoa, uma organização, um lugar. Uma entidade tem tipo, atributos, relacionamentos e histórico.

Registro de origem e crosswalk​

Cada sistema de origem guarda sua própria versão dessa coisa. Quando uma chega, um crosswalk registra a ligação: de qual sistema veio e qual o identificador dele para ela.

Crosswalks são o que torna a linhagem respondível e a consolidação reversível. Todo valor em um registro dourado remete a um deles.

Crosswalk não é transcodificação

Um crosswalk liga um registro a um sistema de origem. Mapear um valor de código — o US de um sistema para um USA canônico — é transcodificação, um conceito diferente. Algumas plataformas usam a palavra "crosswalk" para essa segunda ideia; esta documentação a reserva estritamente para a primeira.

Registro dourado​

A versão governada: um valor por atributo, escolhido entre todas as origens contribuintes por regras de sobrevivência.

O registro dourado não é uma cópia que substitui suas origens. Os registros contribuintes permanecem, mantêm seus crosswalks e continuam a ser atualizados. O registro dourado é a visão governada deles, recomputada conforme mudam.

"Registro mestre" significa o oposto em outras plataformas

Algumas usam esse termo para o contribuinte por origem. Esta documentação nunca o faz. Aqui o sobrevivente é o registro dourado, e suas entradas são registros de origem.

Como um valor é escolhido​

Quando origens discordam, uma regra de sobrevivência decide por atributo — o valor atualizado mais recentemente, o valor da origem de maior prioridade, ou todos os valores distintos preservados quando o atributo é genuinamente multivalorado.

A visão 360 mostra tanto o vencedor quanto as entradas, então um valor surpreendente sempre pode ser rastreado até o sistema que o forneceu.

Entidades consolidadas continuam resolvíveis​

Quando duas entidades se consolidam, a absorvida não desaparece. Ela vira um apelido: solicitá-la resolve para o sobrevivente, e a resposta informa isso. Integrações que guardam um identificador antigo seguem funcionando, e a consolidação pode ser desfeita.

A seguir​

Última verificação no commit d3c2586b (2026-08-03)