--- title: Sincronização de metadados description: >- Revise alterações de fontes técnicas com previews, snapshots e agendas configuráveis, sem presumir automação ativa. audiencia: >- Engenheiro de dados | Administrador | Curador de dados | Responsável pelos dados roles: >- Engenheiro de dados com technical.manage e escopo técnico; Administrador com escopo global da empresa modulo: Repositórios de dados e Dicionário técnico revision: '2026-10-19' section: administrar-tecnicamente order: 30 sources: - CONTEXT.md - ARCHITECTURE.md - TESTING_GUIDE.md - Modelodeobjetosyrelaciones.md - Módulosydependencias.md - 'Roles,capacidadesyalcance.md' locale: pt-br --- # Sincronização de metadados A sincronização de metadados compara as informações disponíveis com o estado documentado, prepara um **preview** das alterações e conserva **snapshots versionados** para rastreabilidade. Detecta tabelas e colunas criadas, modificadas ou excluídas; revise-as como alterações de metadados, não como decisões automáticas de governança. A sincronização conecta o Repositório ao Dicionário técnico. Pode facilitar a localização de campos que precisam de documentação ou a revisão de associações existentes, mas não cria, por si só, definições de negócio, responsáveis, relações taxonômicas nem controles. ## Antes de começar **Papel.** A gestão cabe ao **Engenheiro de dados** com `technical.manage` e escopo técnico ativo para o Repositório afetado. Um **Administrador** pode realizá-la em toda a empresa. Curador de dados e Responsável pelos dados participam quando uma alteração técnica precisa de interpretação de negócio dentro do escopo que lhes cabe, mas não podem ampliar por conta própria o acesso técnico. **Módulo.** Para que a operação seja útil, **Repositórios de dados** e **Dicionário técnico** devem estar habilitados. Se um módulo for desativado, GovFrame ocultará ou limitará a funcionalidade, e o backend rejeitará as operações que dependam dele; a desativação não excluirá automaticamente os dados já registrados. **Pré-requisitos.** Deve haver um Repositório registrado, um conector compatível e acesso autorizado a esse repositório. Confirme a empresa e o escopo técnico antes de começar. Trabalhe com informações de conexão gerenciadas com segurança; não copie credenciais, identificadores pessoais nem detalhes de infraestrutura para as notas de sincronização. ## Percurso recomendado 1. **Defina o escopo da revisão.** Selecione o Repositório autorizado e verifique seu contexto de Domínios ou Subdomínios. Essa associação facilita a leitura do Impacto, mas não substitui as associações entre colunas e Atributos. 2. **Solicite ou revise um preview.** Use o espaço de sincronização para comparar os metadados que serão incorporados com o contexto já documentado. O preview é o momento de distinguir tabelas e colunas criadas, modificadas ou excluídas e evitar aceitar alterações com base apenas na semelhança dos nomes. 3. **Revise o efeito no Dicionário técnico.** Para cada alteração relevante, verifique se há um Campo documentado, um Atributo associado, uma Regra de qualidade, um Contrato ou outra relação registrada. Se não houver uma relação, registre essa ausência e coordene sua revisão; não infira uma dependência por compartilharem Domínio ou nome. 4. **Mantenha a rastreabilidade.** Os snapshots versionados permitem comparar estados dos metadados e acompanhar a evolução da fonte. Use-os como evidência técnica do que foi observado; eles não equivalem a uma certificação de qualidade nem a uma aprovação de negócio. 5. **Configure ou revise a cadência disponível.** O modelo admite sincronização **manual, diária, semanal ou mensal**. A agenda efetiva e a automação dependem da configuração da empresa e do ambiente de execução autorizado. Registrar uma frequência não permite presumir que exista um job produtivo habilitado, que uma exploração tenha sido executada ou que uma fonte esteja acessível naquele momento. > **Exemplo sintético.** Um preview do Repositório “Operação de pedidos” informa uma nova coluna na tabela de pedidos e uma alteração em outra coluna. O Engenheiro de dados revisa o snapshot e solicita validação funcional antes de associar a nova coluna ao Atributo “Canal do pedido”. Se não houver evidência de equivalência, o campo poderá permanecer sem associação documentada. ## Interpretar o resultado Uma sincronização revisada oferece um histórico de snapshots e uma visão das alterações técnicas que ajuda a priorizar o trabalho de documentação. No mapa de relações, o detalhe técnico permite percorrer o vínculo entre Atributo, Campo do Dicionário e Repositório quando ele já tiver sido registrado. A presença de um Repositório ou de uma tabela não demonstra, por si só, que todos os campos estejam documentados; a falta de um vínculo também não deve ser suprida com uma relação estimada. Quando uma Regra de qualidade exigir SQL, o percurso técnico é mais rigoroso: deve existir um campo físico associado e um dialeto configurado. O resultado da geração de SQL não promete a execução automática dessa consulta nem uma exploração programada da fonte. ## Resultado esperado Ao final, a equipe dispõe de um preview revisado ou de um snapshot versionado do Repositório, com alterações técnicas identificadas e decisões de associação pendentes ou confirmadas conforme as evidências disponíveis. Se a empresa configurar uma agenda e o ambiente autorizado a executar, ela ficará expressa em uma das cadências suportadas, sem que isso se torne uma garantia de execução. ## Limites do estado atual - A sincronização respeita o isolamento por empresa, o módulo habilitado, a capacidade e o escopo técnico; não permite ampliar o acesso a outros Repositórios. - Snapshots e agendas são informações operacionais de metadados. Não substituem definições de negócio, responsabilidades nem decisões de aprovação. - A detecção de alterações limita-se aos metadados documentados de tabelas e colunas criadas, modificadas ou excluídas; não deve ser apresentada como um catálogo independente de Riscos ou Controles. - Os controles de governança são representados por objetos existentes, como Regras de qualidade, Políticas ou Procedimentos, Workflows, tarefas, aprovações, classificações ou certificações, conforme o caso. ## Referências relacionadas - [Modelo de objetos e relações](/pt-br/explicaciones/modelo-de-objetos-y-relaciones/) - [Como ler o mapa de relações](/pt-br/guias/como-leer-mapa-de-relaciones/) - [Papéis, capacidades e escopo](/pt-br/referencia/roles-capacidades-y-alcance/) - [Módulos e dependências](/pt-br/referencia/modulos-y-dependencias/)