Cloudata — Connecting data. Driving results.Dova Docs26.0.0
Abrir Dova

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

EscenarioPor dónde empezar
Leer un CSV de un bucket de GoogleGoogle Cloud Storage: identidad, bucket y archivo
Consultar tablas de Google BigQueryGoogle BigQuery
Leer o cargar tablas de SnowflakeSnowflake
Conectar otro proveedorCampos y autenticación por proveedor
Comprobar un archivo concretoGuarda la Connection y sigue «Leer un CSV desde un Mapping» más abajo.
Integrar una tecnología que no apareceRequiere 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únObligaciónQué indicar
Connector, Connection nameObligatoriosConector disponible y un nombre reconocible, por ejemplo Lab_GCS_Read.
Domain, FolderObligatoriosUbicación de la Connection dentro del tenant seleccionado.
EnvironmentSelección con valor inicialEntorno propietario. Confírmalo antes de guardar.
Host o endpointObligatorioHost sin ruta para bases de datos; URL HTTPS base para APIs y objetos. No uses una URL de consola ni incluyas credenciales.
PortSegún proveedorConserva el puerto propuesto; algunos conectores lo fijan u ocultan. Modifícalo sólo si el servicio usa otro puerto admitido.
Campos del proveedorObligatorios u opcionales según la guíaBucket y Project para GCS; Database y Warehouse para Snowflake, por ejemplo.
Authentication y credential custodyObligatoriosMétodo compatible y dónde se resuelven las credenciales. Los datos adicionales dependen de ambos.
Shared within tenantOpcionalReutilización sólo dentro de este tenant; no concede permisos del proveedor.
Recordatorio de rotaciónOpcionalPlazo 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

CustodiaDatos necesariosCuándo usarla
PasswordlessProveedor de identidad y runtime preparado; la identidad explícita depende del métodoIdentidad adjunta o federada del worker. Escribir un email no adjunta una service account ni concede permisos IAM.
Dova VaultMaterial protegido exigido por el método y aceptación de la excepciónContraseña, token, JSON o clave privada mediante el control protegido. No los pongas en Host, descripción, SQL ni chat.
Dova Worker AgentAgent ID y Secret aliasEl agente resuelve un secreto previamente configurado. El worker que lo use debe poder acceder a esa custodia.
External VaultProveedor y referencia protegida; identidad de acceso si el entorno la exigeUn 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

  1. Abre un Mapping de Development y añade Object storage input.
  2. 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 ni gs://bucket/.
  3. Elige CSV y su CSV delimiter, por ejemplo una coma. Deja Selected fields vacío para leer todos los campos.
  4. 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.
  5. 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.
  6. 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ónQué demuestra
Connections → Test connectionAutenticación, acceso al servicio y permisos de la operación de prueba.
Mappings → Preview dataLectura del objeto indicado y reconocimiento de formato, delimitador y encabezados dentro de los límites de muestra.
Session → RunEjecución de la versión publicada con el worker, las transformaciones y el destino configurados.

Si falla, identifica en qué paso

Mensaje o síntomaQué revisar
Connection and Credential Profile authentication methods differLa 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 / 403Identidad 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 / 404Proyecto, bucket y Object key exactos, incluyendo mayúsculas y prefijos.
Test pasa pero Preview fallaLa prueba de servicio no certifica lectura del objeto; revisa permisos de lectura, ruta, formato y worker.
Preview no disponibleWorker 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 disponibleCapacidades 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.

Buscar en el manual

Escribe al menos dos caracteres.

Tab para recorrer los resultados · Escape para cerrar