--- title: Como ler o mapa de relações slug: como-leer-mapa-de-relaciones description: >- Guia para explorar o ecossistema de governança, analisar o impacto e navegar pelas relações técnicas. audiencia: >- Administrador | Responsável pelos dados | Curador de dados | Engenheiro de dados | Usuário roles: Consulta conforme o escopo; ações de administração conforme a capacidade modulo: Explorador de relações estado: Comportamento atual validado revision: '2026-10-19' section: guias order: 20 sources: - Cómoleerelmapaderelaciones.md locale: pt-br --- # Como ler o mapa de relações O Explorador de relações ajuda a responder a uma pergunta específica: **como este conceito de negócio se conecta aos responsáveis, controles, fontes técnicas e produtos?** A taxonomia continua sendo o eixo. Não é um grafo livre em que todos os objetos aparecem no mesmo nível. ## Antes de começar - O módulo **Explorador de relações** deve estar ativo para a empresa. - Só aparecem objetos do tenant e do escopo autorizado. - O mapa parte do objeto selecionado ou de uma semente válida do tenant quando é aberto sem seleção. - Atributos e campos são consultados progressivamente; não são carregados todos no primeiro nível. ## A faixa de caminho é o seletor de contexto O caminho superior funciona como o explorador de pastas do Windows: ```text Empresa / Domínio / Subdomínio / Entidade / Atributo / Repositório / Campo ``` - Cada segmento representa um nível disponível. - Ao clicar em um segmento, você retorna a esse nível e os objetos relacionados daquele contexto são exibidos. - `Volver al nivel anterior` sobe um nível sem perder a visualização atual. - `Limpiar selección` retorna o mapa à semente geral. - A mesma faixa mostra a profundidade, os filtros efetivos e a quantidade de objetos/relações. O caminho não abre o inspetor automaticamente. Mudar de contexto serve para navegar; **Detalhe** abre as informações ampliadas somente quando solicitado. ## Visão geral: entender o ecossistema Use Visão geral quando ainda não souber qual relação está procurando. 1. Selecione um Domínio ou Subdomínio. 2. Examine a coluna taxonômica: Entidades e Atributos. 3. Observe as laterais: Termos, Regras, Repositórios, Sistemas, Produtos e Contratos. 4. Clique em um objeto para mudar o contexto do mapa. 5. Use o caminho superior para subir ou voltar a uma pasta conceitual anterior. A Visão geral prioriza nomes e agrupamentos compreensíveis. Ela não tenta exibir todos os campos físicos de uma fonte. ## Impacto: analisar um objeto escolhido Impacto responde **o que alimenta o objeto e o que pode ser afetado se ele mudar**. - **Objeto analisado:** selecionado pelo controle visível de objeto raiz. - **Upstream:** origens ou elementos que alimentam o objeto. - **Downstream:** produtos, contratos, regras, sistemas ou processos que dependem dele. - **Filtros de impacto:** reduzem o resultado a categorias como Qualidade, Produtos, Contratos ou Sistemas. - **Profundidade:** indica quantos saltos são percorridos a partir do objeto raiz. Exemplo: ```text Atributo “Data de ingresso” ← Campo técnico em tabela acadêmica ← Repositório universitário → Regra de completude → Contrato de dados → Produto de dados ``` Se não houver um caminho upstream ou downstream real, a tela deve explicar essa ausência. Não deve inventar uma dependência pelo simples fato de os objetos compartilharem o mesmo Domínio. ## Detalhe técnico: seguir a relação física Detalhe técnico foi pensado para o Engenheiro de dados, o Curador de dados e o Responsável pelos dados que precisam verificar a rastreabilidade. ### Coluna vertebral O centro mantém uma hierarquia legível: ```text Domínio ↓ Subdomínio ↓ Entidade ↓ Atributo ``` Nas laterais aparecem os objetos relacionados: ```text Atributo ↔ Regra de qualidade Atributo ↔ Campo do Dicionário técnico Campo ↔ Repositório / esquema / tabela / coluna Repositório ↔ Sistema ``` Uma Entidade ou um Repositório pode mostrar linhas internas de atributos ou campos. O cartão exibe inicialmente até oito linhas; `+N` e a rolagem interna permitem consultar o restante sem transformar todo o diagrama em quadros ilegíveis. ### Como investigar um campo 1. Selecione a Entidade ou o Atributo no eixo central. 2. Procure o cartão de Repositório ou Dicionário técnico. 3. Verifique o nome da tabela e da coluna, o esquema, o tipo e o estado da associação. 4. Siga a linha até o Atributo taxonômico. 5. Abra **Detalhe** se precisar da tabela completa de campos, da origem ou da descrição. O nome funcional do Atributo é exibido na interface. O código técnico fica reservado à persistência, à validação, à importação ou ao SQL gerado. ## O que significa uma linha | Sinal | Significado | |---|---| | Linha em direção ao centro taxonômico | O objeto está relacionado ao contexto de negócio. | | Linha de um Atributo para um Campo | Existe uma associação física documentada. | | Linha entre Repositório e Sistema | O repositório declara um sistema relacionado. | | Linha em direção a uma Regra | A Regra usa o Atributo ou um campo associado. | | Linha em direção a Produto/Contrato | O objeto participa de uma entrega ou compromisso de dados. | | Sem linha | Não existe uma relação registrada; ela não deve ser inferida apenas pelo nome. | ## Filtros e profundidade Os filtros são aplicados ao contexto ativo, não ao tenant inteiro: - A profundidade 1 mostra relações diretas. - A profundidade 2 permite seguir um salto adicional. - Arestas equivalentes são exibidas uma única vez. - Filtros incompatíveis com a raiz são desabilitados para evitar um mapa vazio ou enganoso. - Mudar de nível pelo caminho recalcula a profundidade e os filtros válidos. ## Quando abrir Detalhe Não abra o painel lateral a cada clique. Mantenha o canvas livre para navegar e use **Detalhe** quando quiser: - ler a descrição, as responsabilidades e o estado; - revisar todos os atributos ou campos; - consultar associações técnicas e origem; - abrir a ficha completa do objeto. ## Problemas frequentes ### O mapa parece vazio Verifique se há um objeto raiz visível, se o módulo está ativo e se a profundidade e os filtros são compatíveis. O sistema mantém a raiz renderizada durante o carregamento e mostra um estado explicativo se não houver relações. ### Uma tabela aparece, mas seus campos não A tabela pode existir como Repositório sem que todos os seus campos estejam no Dicionário técnico ou associados a atributos. Abra Detalhe e verifique o estado de cada campo; não presuma que a relação com a tabela implica associação de colunas. ### Aparecem duas linhas semelhantes A interface deduplica relações equivalentes por par de objetos. Se duas linhas representarem relações semanticamente distintas, a legenda deverá diferenciá-las; se forem o mesmo vínculo, deverá ser exibida apenas uma. ### Não consigo navegar para um nível anterior Use o segmento correspondente do caminho superior ou `Volver al nivel anterior`. Limpar a seleção retorna à semente geral sem mudar de empresa. ## Conteúdo relacionado - [Modelo de objetos e relações](/pt-br/explicaciones/modelo-de-objetos-y-relaciones/) - [Papéis, capacidades e escopo](/pt-br/referencia/roles-capacidades-y-alcance/) - [Módulos e dependências](/pt-br/referencia/modulos-y-dependencias/) ## Resultado esperado Você consegue distinguir uma associação de negócio de uma relação física registrada, navegar por Visão geral, Impacto e Detalhe técnico e reconhecer quando uma dependência ainda não está documentada.