Una Connection separa el endpoint, el conector, el método de autenticación y la custodia protegida de credenciales de la lógica de un Mapping. Los campos y métodos disponibles dependen del conector elegido. Que una tecnología aparezca en el catálogo no demuestra que un worker tenga el controlador, la conectividad ni los permisos para usarla.
Antes de empezar
Prepara un recurso de laboratorio autorizado y preferiblemente de solo lectura. Identifica el worker que hará la prueba y la identidad que usará. No incluyas contraseñas, claves ni referencias sensibles de Vault en descripciones o capturas.
Procedimiento
- Abre Connections y crea un registro con un nombre que indique su propósito. Selecciona el conector y revisa sus campos obligatorios.
- Introduce los metadatos autorizados: host o endpoint, puerto, base de datos, esquema o recurso según corresponda. Confirma los valores con el responsable del entorno.
- Elige un método de autenticación y una custodia disponibles. Passwordless usa una identidad de ejecución; una custodia externa exige que la referencia protegida sea resoluble. No fuerces métodos ocultos.
- Completa el flujo protegido, revisa el tenant y guarda. Comprueba los metadatos persistidos antes de probar.
- Usa Test para la Connection guardada y lee el resultado seguro. Después ejecuta una extracción pequeña desde un Mapping/Session en el worker compatible.
- Revisa consumidores antes de rotar, revocar o eliminar la Connection. Distingue editar metadatos de sustituir credenciales.
Comprobar el resultado
La Connection muestra solamente los metadatos permitidos; la prueba informa el estado esperado y una lectura pequeña produce el resultado conocido. Compara identificadores con el editor. Una prueba de conexión satisfactoria no certifica todos los modos de escritura, reintento o recuperación.
Errores y recuperación
Ante un error de autenticación, revisa método, custodia, permisos y expiración. Para errores de red, comprueba DNS, TLS y salida del worker. Un controlador faltante requiere revisar capacidades instaladas. Mantén los mensajes seguros y nunca copies secretos al campo descripción para depurar.
Ejemplo sintético
CustomerLabReadOnly apunta a la base sintética training y la tabla customers mediante una identidad de lectura. Selecciónala en el componente de origen correspondiente y verifica diez registros conocidos.
Contexto de entorno
Antes de utilizar este módulo confirma Tenant, Domain y Environment en el menú de usuario. El entorno inicial es Development. Las capacidades del módulo, el Domain y el entorno se aplican juntas; Production queda de solo lectura sin autorización explícita. Cambiar el selector no mueve artefactos ni publica o ejecuta sus datos. Consulta entornos y recuperación y promoción entre entornos.
Preparar Connections del destino
Antes de promover hacia Production, prepara allí Connections propias con custodia y permisos válidos. Un administrador autorizado puede registrarlas o modificar sus metadatos con etl.connections.manage y etl.environments.production.edit. Esta autorización específica no habilita el editor de Mappings, Sessions o Workflows de Production. Las Connections legacy compartidas o ambiguas siguen de solo lectura.
El preview de promoción y Fork to Development solo ofrece Connections compatibles ya existentes en el destino. Selecciona cada reemplazo explícitamente; no se copian contraseñas ni se inventan referencias de secretos. Domain y Environment de la Connection permanecen ligados a su contexto de propiedad.
Disponibilidad de workers y carga de la vista
Una referencia a un worker retirado o con una identidad inválida no impide consultar Overview, Monitor o Connections. Esa referencia no queda disponible para ejecutar; los workers válidos continúan apareciendo según tus permisos. Un fallo real de almacenamiento o de política se informa como error y no se convierte en un contador cero.