---
title: Conectores y repositorios de datos
description: Registre fuentes técnicas, delimite repositorios y gestione el acceso a metadata con alcance y seguridad por empresa.
audiencia: Ingeniero de datos | Administrador | Data Steward | Data Owner
roles: Ingeniero de datos con technical.manage y scope técnico; Administrador con alcance global de la empresa
modulo: Repositorios de datos
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
---

# Conectores y repositorios de datos

Los **conectores** permiten establecer el vínculo con una fuente técnica; los **repositorios de datos** dan a esa fuente un contexto gobernable dentro de GovFrame. Separar ambos conceptos ayuda a documentar no solo dónde vive la información, sino también qué dominio de negocio representa, quién puede administrarla y qué metadata o campos técnicos pertenecen a ella.

Un repositorio puede representar una base de datos o plataforma analítica u operacional. Puede relacionarse con Dominios o Subdominios y conservar una referencia de Entidad por compatibilidad o contexto heredado. Esa relación no asocia automáticamente las tablas o columnas de la fuente con la taxonomía.

## Antes de empezar

**Rol.** Esta operación corresponde al **Ingeniero de datos** con la capacidad `technical.manage` y un scope técnico activo sobre el repositorio. El **Administrador** puede operar con alcance global dentro de la empresa. Data Steward y Data Owner colaboran aportando significado de negocio, pero no sustituyen la autorización técnica.

**Módulo.** Debe estar habilitado **Repositorios de datos**. Si el módulo está desactivado, la función no es operable y el backend rechaza sus procedimientos; los datos ya registrados no se eliminan automáticamente por ese cambio.

**Precondiciones.** Confirma que trabajas en la empresa correcta, que existe una membresía autorizada y que conoces el propósito, responsable y alcance de la fuente. Reúne únicamente los datos de conexión que estén aprobados por la organización; las credenciales deben gestionarse por el mecanismo seguro de la plataforma, nunca en descripciones, comentarios o documentación de negocio.

El modelo actual admite conectores para **PostgreSQL, BigQuery, SingleStore y Power BI Service**. Una fuente que no pertenezca a esta lista no debe presentarse como compatible sin una ampliación documentada del producto.

## Recorrido recomendado

1. **Delimita el repositorio.** Identifica la fuente técnica y su función: operacional, analítica u otra finalidad aprobada. Relaciónala con los Dominios o Subdominios que aporten el contexto de negocio real. Evita usar una asociación amplia como sustituto de la clasificación de cada campo.
2. **Registra el conector autorizado.** Selecciona el tipo de conector compatible e incorpora la información requerida mediante los controles disponibles. Esta es una guía funcional: la interfaz puede variar y no se presupone un formulario ni una secuencia de pantallas concreta.
3. **Asigna la administración técnica.** Comprueba que los Ingenieros de datos responsables tengan scope activo sobre ese repositorio. El rol por sí solo no concede acceso a todos los repositorios del tenant.
4. **Comprueba la configuración sin exponer secretos.** La plataforma protege las credenciales y no las devuelve al cliente. La validación de un conector debe respetar los controles de red: se bloquean destinos no permitidos y la verificación TLS se exige por defecto. No intentes eludir esos controles ni reutilices datos de acceso fuera del contexto aprobado.
5. **Conecta el repositorio con el gobierno.** Una vez disponible la metadata, revisa los campos que deban documentarse en el Diccionario técnico y asócialos a Atributos solo cuando exista una correspondencia física comprobable. Steward y Owner pueden enriquecer las definiciones y descripciones de negocio dentro de su alcance.

> **Ejemplo sintético.** Un repositorio llamado “Analítica de ventas” puede vincularse al Dominio Ventas y al Subdominio Pedidos. La tabla física de pedidos no queda por ello asociada automáticamente a la Entidad Pedido, ni cada columna a un Atributo: esas relaciones se registran y revisan por separado en el Diccionario técnico.

## Seguridad, alcance y trazabilidad

Cada conector, repositorio y relación técnica pertenece a una empresa. GovFrame obtiene el contexto de empresa desde la sesión y aplica controles de membresía, módulo, capacidad y alcance antes de permitir una operación. Cambiar parámetros en el navegador no amplía el acceso ni permite consultar datos de otra empresa.

La plataforma conserva la configuración necesaria y referencias protegidas para operar las conexiones; no corresponde usar GovFrame como inventario de secretos. Mantén fuera de las fichas públicas los valores de credenciales, identificadores personales y detalles de infraestructura. Las pruebas y validaciones de conectores deben evitar abrir conexiones de clientes o realizar exploraciones reales sin autorización específica.

## Resultado esperado

Al terminar, debe existir un repositorio con un propósito y contexto taxonómico comprensibles, conectado mediante un tipo soportado y administrable solo por las personas con scope técnico. El repositorio queda preparado para recibir o contextualizar metadata y para enlazar campos físicos con Atributos cuando se confirme la relación. También puede relacionarse con un Sistema de información, Productos o Contratos mediante las asociaciones que correspondan.

## Límites del estado actual

- Un repositorio puede abarcar varios ámbitos de negocio, pero esa asociación no implica una relación de columna a atributo.
- El Diccionario técnico depende de un Repositorio registrado; habilitar ambos módulos es necesario para una documentación técnica útil.
- Los módulos controlan visibilidad y operación por empresa. Reactivarlos restituye la disponibilidad sujeta a roles, alcance y estado de los datos.
- Los riesgos y controles no son catálogos independientes en el modelo actual. Un control puede documentarse, según el caso, como Regla de calidad, Política o Procedimiento, Workflow, tarea, aprobación, clasificación o certificación.

## Referencias relacionadas

- [Modelo de objetos y relaciones](/es/explicaciones/modelo-de-objetos-y-relaciones/)
- [Cómo leer el mapa de relaciones](/es/guias/como-leer-mapa-de-relaciones/)
- [Roles, capacidades y alcance](/es/referencia/roles-capacidades-y-alcance/)
- [Módulos y dependencias](/es/referencia/modulos-y-dependencias/)