Referência de relacionamentos
Tipo de relacionamento
Tipos de relacionamento. Cardinalidade e os sinalizadores simétrico e acíclico são definidos aqui.
| Configuração | Finalidade |
|---|---|
| Tipos de entidade de origem e destino | O que ele liga |
| Cardinalidade | Quantos vínculos por ponta |
| Nome de exibição | Como se lê no sentido direto |
| Nome de exibição inverso | Como se lê no sentido inverso |
| Simétrico | Se a direção é significativa |
| Acíclico | Se ciclos são rejeitados |
Nomes de exibição inversos importam para legibilidade: um vínculo armazenado deve ler "emprega" de uma ponta e "empregado por" da outra, em vez de obrigar quem lê a deduzir a direção.
Acíclico importa para hierarquias. Sem isso, uma cadeia de propriedade pode fechar num laço que nenhuma agregação resolve.
Estados de asserção
| Estado | Significado |
|---|---|
| Pendente | Destino ainda não encontrado; reprocessada conforme dados chegam |
| Resolvida | Existe uma aresta canônica |
| Ambígua | A chave correspondeu a vários candidatos |
| Conflitante | O destino resolveu, mas a aresta não pôde ser criada — uma regra de cardinalidade a bloqueou, ou a regra ou o tipo de relacionamento não existe mais |
| Rejeitada | Um curador rejeitou a asserção |
| Expirada | A origem parou de afirmar o fato; a evidência foi retirada do registro de origem. Se a evidência voltar, a asserção reabre como pendente. |
É onde uma asserção pousa quando o destino foi encontrado mas a aresta não pôde ser materializada. Um curador que esteja triando uma delas deve olhar o que bloqueou a aresta — na maioria das vezes uma regra de cardinalidade — em vez de caçar um registro de origem concorrente.
Não confunda expirada com uma aresta cujo período de vigência terminou. São objetos diferentes: expirada é um estado de asserção conduzido pela origem, enquanto um período fechado é uma propriedade da aresta. Veja Vigência abaixo.
Vigência
Todo relacionamento carrega um período de vigência. Um vínculo que termina é encerrado, não excluído.
| Consulta | Devolve |
|---|---|
| Padrão | Vínculos atualmente vigentes |
| Numa data | Vínculos vigentes naquela data |
| Filtrada por estado | Vínculos ativos, expirados ou futuros |
A cardinalidade é avaliada dentro da janela de vigência, então um relacionamento de um por ponta pode legitimamente ter vários ocupantes históricos.
Comportamento na consolidação
| Evento | Efeito |
|---|---|
| Consolidação | Vínculos passam a apontar para o sobrevivente; duplicatas colapsam |
| Consolidação com contraparte compartilhada | O vínculo existente do sobrevivente vence; o outro é superado |
| Desfazer | Vínculos superados são restaurados, depois os repontamentos revertidos |
Restaurar vínculos superados antes de reverter os repontamentos é o que torna o desfazer idêntico byte a byte em vez de aproximadamente certo.
Uma ponta de relacionamento que foi consolidada não pode ser gravada; a plataforma resolve para o sobrevivente primeiro, então um vínculo não pode ficar preso a um registro absorvido.
Regra de modelagem
| A coisa relacionada é | Modele como |
|---|---|
| Governada | Um relacionamento |
| Não governada | Um atributo |
Nunca ambos. Duas cópias de um fato divergem.
A seguir
Última verificação no commit d3c2586b (2026-08-03)