Una Connection guarda la configuración de acceso a un sistema; el conector es el adaptador que lo implementa. Para conectar GCP, Snowflake u otro proveedor ya disponible, registra una Connection: no necesitas desarrollar un conector nuevo. Esta guía de Connections se revisó contra Dova 29.0.3; las instrucciones de cada proveedor distinguen el formulario de las capacidades del adaptador.
Elige lo que necesitas hacer
| Escenario | Por dónde empezar |
|---|---|
| Leer un CSV de un bucket de Google | Google Cloud Storage: identidad, bucket y archivo |
| Consultar tablas de Google BigQuery | Google BigQuery |
| Leer o cargar tablas de Snowflake | Snowflake |
| Conectar otro proveedor | Campos y autenticación por proveedor |
| Comprobar un archivo concreto | Guarda la Connection y sigue «Leer un CSV desde un Mapping» más abajo. |
| Integrar una tecnología que no aparece | Requiere implementar y publicar un adaptador compatible; Register connection no instala controladores ni añade proveedores. |
1. Prepara el contexto y los permisos
Confirma Tenant, Domain y Environment. Elige Development para la primera prueba y una Folder a la que tengas acceso. Necesitas permiso para administrar Connections. Prepara el endpoint, el recurso y una identidad con permiso sobre ese recurso. La sesión de Google con la que entras a Dova no concede permisos al worker para leer un bucket.
2. Completa Register connection
El asistente tiene cinco pasos: Catalog, Endpoint, Authentication, Credential custody y Review. Usa Continue para avanzar y Back para volver. Los campos cambian cuando eliges proveedor y autenticación; un campo oculto no se completa por analogía con otro proveedor.
| Campo común | Obligación | Qué indicar |
|---|---|---|
| Connector, Connection name | Obligatorios | Conector disponible y un nombre reconocible, por ejemplo Lab_GCS_Read. |
| Domain, Folder | Obligatorios | Ubicación de la Connection dentro del tenant seleccionado. |
| Environment | Selección con valor inicial | Entorno propietario. Confírmalo antes de guardar. |
| Host o endpoint | Obligatorio | Host sin ruta para bases de datos; URL HTTPS base para APIs y objetos. No uses una URL de consola ni incluyas credenciales. |
| Port | Según proveedor | Conserva el puerto propuesto; algunos conectores lo fijan u ocultan. Modifícalo sólo si el servicio usa otro puerto admitido. |
| Campos del proveedor | Obligatorios u opcionales según la guía | Bucket y Project para GCS; Database y Warehouse para Snowflake, por ejemplo. |
| Authentication y credential custody | Obligatorios | Método compatible y dónde se resuelven las credenciales. Los datos adicionales dependen de ambos. |
| Shared within tenant | Opcional | Reutilización sólo dentro de este tenant; no concede permisos del proveedor. |
| Recordatorio de rotación | Opcional | Plazo de recordatorio cuando corresponda al método y custodia. |
Consulta los campos por proveedor antes de continuar con Authentication.
3. Elige autenticación y custodia
| Custodia | Datos necesarios | Cuándo usarla |
|---|---|---|
| Passwordless | Proveedor de identidad y runtime preparado; la identidad explícita depende del método | Identidad adjunta o federada del worker. Escribir un email no adjunta una service account ni concede permisos IAM. |
| Dova Vault | Material protegido exigido por el método y aceptación de la excepción | Contraseña, token, JSON o clave privada mediante el control protegido. No los pongas en Host, descripción, SQL ni chat. |
| Dova Worker Agent | Agent ID y Secret alias | El agente resuelve un secreto previamente configurado. El worker que lo use debe poder acceder a esa custodia. |
| External Vault | Proveedor y referencia protegida; identidad de acceso si el entorno la exige | Un Vault externo ya configurado y accesible desde la ejecución. |
Username, Client ID, Directory ID, audiencia o passphrase pueden ser obligatorios según el método; revisa la guía del proveedor. En Review confirma endpoint, entorno, método y custodia. Guarda la Connection antes de probarla.
4. Ejecuta Test connection
En la fila de Connections, usa el icono de prueba (triángulo/play) y consulta su resultado. Distingue configuración guardada, custodia validada y conectividad verificada: sólo esta última acredita contacto con el proveedor. En GCS, el adaptador prueba el listado de objetos del bucket; todavía no ha leído tu CSV. No cambies permisos de escritura para resolver una prueba de lectura.
5. Lee un CSV desde un Mapping
- Abre un Mapping de Development y añade Object storage input.
- Selecciona la Connection GCS guardada. En Object key introduce la ruta exacta dentro del bucket, por ejemplo
samples/sales.csv; no la URL de la consola nigs://bucket/. - Elige CSV y su CSV delimiter, por ejemplo una coma. Deja Selected fields vacío para leer todos los campos.
- Para este Preview público, la Connection debe usar credenciales explícitas de tu tenant en Dova Vault; para GCS, configura Service account JSON mediante su control protegido. Passwordless, External Vault y Agent local no son custodias admitidas en este Preview. Pulsa Preview data. Dova elige automáticamente un worker público elegible, priorizando disponibilidad y recursos. No hay selector manual de worker en Mappings. Si no existe capacidad pública elegible, Preview data no está disponible.
- Revisa encabezados y filas de muestra. Tras un preview correcto puedes elegir los campos detectados en Selected fields. La muestra admite CSV de Object storage input y lee como máximo 100 filas y 1 MiB. No ejecuta todo el pipeline ni sustituye una prueba de escritura.
- Para una ejecución completa, configura el destino, valida y publica el Mapping; crea o actualiza una Session y selecciona allí un worker compatible. Ejecuta desde la Session y revisa Monitor.
| Comprobación | Qué demuestra |
|---|---|
| Connections → Test connection | Autenticación, acceso al servicio y permisos de la operación de prueba. |
| Mappings → Preview data | Lectura del objeto indicado y reconocimiento de formato, delimitador y encabezados dentro de los límites de muestra. |
| Session → Run | Ejecución de la versión publicada con el worker, las transformaciones y el destino configurados. |
Si falla, identifica en qué paso
| Mensaje o síntoma | Qué revisar |
|---|---|
| Connection and Credential Profile authentication methods differ | La Connection y su Credential Profile declaran métodos distintos. El bloqueo ocurre antes de leer el archivo. Revisa la configuración guardada y usa un perfil compatible mediante el flujo protegido; no alteres el CSV para resolverlo. |
| Access denied / 403 | Identidad efectiva de las credenciales de lectura y permisos del bucket, objeto, tabla o API; también políticas IAM y condiciones del recurso. |
| Not found / 404 | Proyecto, bucket y Object key exactos, incluyendo mayúsculas y prefijos. |
| Test pasa pero Preview falla | La prueba de servicio no certifica lectura del objeto; revisa permisos de lectura, ruta, formato y worker. |
| Preview no disponible | Worker público elegible y compatible, Connection con credenciales propias del tenant en Dova Vault y entorno autorizado; no se utiliza la identidad del servidor como sustituto. |
| Driver o capability no disponible | Capacidades y versión del worker. Que el proveedor figure en el catálogo no instala su SDK. |
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.
Dova