--- title: Conectores e repositórios de dados description: >- Registre fontes técnicas, delimite repositórios e gerencie o acesso a metadados com escopo e segurança por empresa. 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 revision: '2026-10-19' section: administrar-tecnicamente order: 10 sources: - CONTEXT.md - ARCHITECTURE.md - TESTING_GUIDE.md - Modelodeobjetosyrelaciones.md - Módulosydependencias.md - 'Roles,capacidadesyalcance.md' locale: pt-br --- # Conectores e repositórios de dados Os **conectores** permitem estabelecer o vínculo com uma fonte técnica; os **repositórios de dados** dão a essa fonte um contexto governável no GovFrame. Separar esses dois conceitos ajuda a documentar não apenas onde as informações estão armazenadas, mas também qual Domínio de negócio representam, quem pode administrá-las e quais metadados ou campos técnicos pertencem a elas. Um repositório pode representar um banco de dados ou uma plataforma analítica ou operacional. Ele pode se relacionar com Domínios ou Subdomínios e manter uma referência de Entidade por compatibilidade ou contexto herdado. Essa relação não associa automaticamente as tabelas ou colunas da fonte à taxonomia. ## Antes de começar **Papel.** Esta operação cabe ao **Engenheiro de dados** com a capacidade `technical.manage` e um escopo técnico ativo no repositório. O **Administrador** pode operar com escopo global dentro da empresa. O Curador de dados e o Responsável pelos dados colaboram fornecendo significado de negócio, mas não substituem a autorização técnica. **Módulo.** **Repositórios de dados** deve estar habilitado. Se o módulo estiver desativado, a função não poderá ser operada e o backend rejeitará seus procedimentos; os dados já registrados não serão excluídos automaticamente por causa dessa alteração. **Pré-requisitos.** Confirme que você está trabalhando na empresa correta, que existe uma associação autorizada e que conhece a finalidade, a pessoa responsável e o escopo da fonte. Reúna somente os dados de conexão aprovados pela organização; as credenciais devem ser gerenciadas pelo mecanismo seguro da plataforma, nunca em descrições, comentários ou documentação de negócio. O modelo atual aceita conectores para **PostgreSQL, BigQuery, SingleStore e Power BI Service**. Uma fonte que não pertença a essa lista não deve ser apresentada como compatível sem uma ampliação documentada do produto. ## Percurso recomendado 1. **Delimite o repositório.** Identifique a fonte técnica e sua função: operacional, analítica ou outra finalidade aprovada. Relacione-a aos Domínios ou Subdomínios que forneçam o contexto real de negócio. Evite usar uma associação ampla como substituta da classificação de cada campo. 2. **Registre o conector autorizado.** Selecione o tipo de conector compatível e insira as informações necessárias por meio dos controles disponíveis. Este é um guia funcional: a interface pode variar e não se pressupõe um formulário nem uma sequência específica de telas. 3. **Atribua a administração técnica.** Verifique se os Engenheiros de dados responsáveis têm escopo ativo nesse repositório. O papel, por si só, não concede acesso a todos os repositórios do tenant. 4. **Verifique a configuração sem expor segredos.** A plataforma protege as credenciais e não as devolve ao cliente. A validação de um conector deve respeitar os controles de rede: destinos não permitidos são bloqueados e a verificação de TLS é exigida por padrão. Não tente contornar esses controles nem reutilize dados de acesso fora do contexto aprovado. 5. **Conecte o repositório à governança.** Quando os metadados estiverem disponíveis, revise os campos que devem ser documentados no Dicionário técnico e associe-os a Atributos somente quando houver uma correspondência física comprovável. O Curador de dados e o Responsável pelos dados podem enriquecer as definições e descrições de negócio dentro de seu escopo. > **Exemplo sintético.** Um repositório chamado “Analítica de vendas” pode ser vinculado ao Domínio Vendas e ao Subdomínio Pedidos. A tabela física de pedidos não fica, por isso, automaticamente associada à Entidade Pedido, nem cada coluna a um Atributo: essas relações são registradas e revisadas separadamente no Dicionário técnico. ## Segurança, escopo e rastreabilidade Cada conector, repositório e relação técnica pertence a uma empresa. O GovFrame obtém o contexto da empresa a partir da sessão e aplica controles de associação, módulo, capacidade e escopo antes de permitir uma operação. Alterar parâmetros no navegador não amplia o acesso nem permite consultar dados de outra empresa. A plataforma mantém a configuração necessária e referências protegidas para operar as conexões; o GovFrame não deve ser usado como inventário de segredos. Mantenha valores de credenciais, identificadores pessoais e detalhes de infraestrutura fora das fichas públicas. Os testes e as validações de conectores devem evitar abrir conexões de clientes ou realizar explorações reais sem autorização específica. ## Resultado esperado Ao terminar, deve existir um repositório com uma finalidade e um contexto taxonômico compreensíveis, conectado por meio de um tipo compatível e administrável somente por pessoas com escopo técnico. O repositório estará preparado para receber ou contextualizar metadados e para vincular campos físicos a Atributos quando a relação for confirmada. Ele também pode se relacionar com um Sistema de informação, Produtos ou Contratos por meio das associações pertinentes. ## Limites do estado atual - Um repositório pode abranger vários escopos de negócio, mas essa associação não implica uma relação entre coluna e Atributo. - O Dicionário técnico depende de um Repositório registrado; habilitar os dois módulos é necessário para uma documentação técnica útil. - Os módulos controlam a visibilidade e a operação por empresa. Reativá-los restabelece a disponibilidade, sujeita a papéis, escopo e estado dos dados. - Riscos e controles não são catálogos independentes no modelo atual. Um controle pode ser documentado, conforme o caso, como Regra de qualidade, Política ou Procedimento, Workflow, tarefa, aprovação, classificação ou certificação. ## 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/)