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