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
- 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.
- 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.
- 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.
- 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.
- 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.