Qué vas a hacer#
Registrar el acceso a un sistema (por ejemplo, la base de datos de tu ERP) y dejarlo listo para un pipeline. La conexión guarda la dirección y la contraseña (cifrada); el pipeline es el que trae los datos usando ese acceso.
El registro tiene cuatro pasos, siempre en este orden:
| # | Paso | Qué haces en él |
|---|---|---|
| 1 | Sistema | Eliges dónde están tus datos (Postgres, MySQL, SQL Server, Oracle y otras bases de datos). |
| 2 | Dirección y contraseña | Llenas la dirección del servidor, el nombre de la base, el usuario y la contraseña. El nombre de la conexión ya viene sugerido. |
| 3 | Probar | Haces clic en Probar ahora y lees el resultado en una frase. |
| 4 | Listo | Revisas y guardas. La contraseña no aparece. |
El pipeline apunta a la conexión, no copia la contraseña
Cambiar la contraseña en un lugar vale para todos los pipelines que usan la conexión.
Antes de empezar#
- Entra en la cuenta correcta y revisa la empresa/workspace que muestra la aplicación.
- Necesitas ser dueño del workspace: ETL/ELT → Conexiones es área del dueño.
- Elige un origen ofrecido en el
catálogo de conectores y lee su ficha. Un
conector en
Acceso limitadopuede requerir habilitación; un elemento enPlaneadotodavía no es una conexión utilizable. - Pide al responsable del origen un acceso adecuado a la tarea. Para leer datos, no pidas permisos de administración del sistema.
- Número de conexiones por plan: Starter 3 · Growth 10 · Business 30 · Scale 100 · Enterprise a medida. Consulta Planes.
- Registrar una conexión no inicia ninguna ingesta y no genera costo de nube.
Si solo vas a enviar un archivo, usa el flujo de importación — consulta importar un archivo. Un archivo local no exige inventar una contraseña ni crear una bóveda.
Dónde empieza#
En ETL/ELT → Conexiones. Antes de crear, mira la lista: si ya existe una conexión al mismo sistema, úsala. Cada conexión muestra una Situación — Funcionando, Con problema, Nunca probada o Probar de nuevo.
Usa Nueva conexión para abrir la elección del sistema.
Paso 1 — Sistema#
Elige dónde están tus datos. Cada tarjeta dice, en una línea, qué te vamos a pedir en el paso siguiente. Si llegaste desde una tarjeta del catálogo, este paso ya viene hecho.
¿Tus datos están en una hoja de cálculo? No necesitas conexión: crea un pipeline y envía el archivo directamente.
Paso 2 — Dirección y contraseña#
Llena lo que te informó tu equipo de TI. Cada campo tiene una línea de ayuda con un ejemplo:
- Dirección del servidor — nombre o IP del servidor de la base de datos.
- Puerto — ya viene el predeterminado; cámbialo solo si TI dice que es otro.
- Nombre de la base, Usuario (de preferencia uno solo de lectura, creado para el BI) y Contraseña.
El nombre de la conexión ya viene sugerido (sistema + nombre de la base); cámbialo si quieres. Nunca pongas una contraseña ni datos personales en el nombre.
Opciones avanzadas (cerrado) guarda lo que normalmente solo toca TI: schema, seguridad de la conexión (SSL), cómo llegamos a la base (directo por internet, túnel SSH, Cloud SQL, VPN). Ya viene con el valor predeterminado seguro.
La contraseña se guarda cifrada y nunca más aparece en pantalla — ni para ti. Para cambiarla después, usa Cambiar la contraseña.
Si algo sale mal aquí: el campo con problema queda en rojo, con la explicación debajo y un resumen arriba.
Paso 3 — Probar#
Haz clic en Probar ahora. Intentamos entrar en el sistema con los datos informados y listar las tablas — no se modifica nada en tu sistema.
El resultado es una frase: Conexión funcionando (con cuántas tablas encontramos) o No logramos entrar, con el motivo y qué hacer — por ejemplo, "El servidor no respondió a tiempo… pide a tu equipo de TI que habilite el acceso". El detalle por etapa (red, usuario y contraseña, lectura) está en Ver detalles de la prueba (para TI).
La prueba es opcional: Continuar sin probar (o Continuar igual, después de una falla) guarda la conexión como Nunca probada.
Paso 4 — Listo#
Revisa los datos y guarda. La contraseña no aparece, solo si fue informada.
Usa Guardar conexión. Si llegaste desde el armado de un pipeline, el botón es Guardar y usar en el pipeline y vuelves allí con la conexión ya elegida. Cancelar no guarda nada.
Guardar no trae datos: quien los trae es el pipeline que use la conexión.
Los cuatro estados detrás de la situación (para TI)#
La lista muestra UNA situación. En la ficha de la conexión aparecen los cuatro hechos de donde viene — y una conexión puede estar "Activa" y nunca haber traído nada:
| Estado | Valores posibles |
|---|---|
| Registro | Borrador · Activa · Archivada |
| Validación | Validada ✓ · Falló en la prueba · Probando… · Validación obsoleta · No probada |
| Credencial | Credencial configurada · Credencial expirada · Credencial revocada · Credencial inaccesible · Sin credencial |
| Última ingesta | Última ingesta OK · Última ingesta falló · Ingesta en ejecución · Nunca ingirió · Sin pipeline |
Resultado esperado#
Tienes una conexión identificable y autorizada; la credencial está cifrada y referenciada; la situación de la prueba corresponde a lo que efectivamente se verificó; el estado de ingesta dice Nunca ingirió o Sin pipeline — porque guardar no carga ningún dato.
Si algo sale mal#
| Síntoma | Qué revisar | Próxima acción |
|---|---|---|
| Falló la red | Dirección, puerto, modo de red, allowlist | Habilita el servidor de la aplicación y el ejecutor; valida con quien administra el origen |
| Falló la autenticación | Método, validez y usuario elegidos | Sustituye o vuelve a autorizar la credencial según el conector |
| Autentica, pero falló la lectura | Permisos en el schema/tabla específicos | Pide solo el acceso necesario (solo lectura) |
| Lectura "No probado" | Si el conector soporta esa verificación | Trátalo como no verificado, no como aprobado |
| El paso siguiente no abre | El resumen de errores arriba del paso actual | Corrige el campo en rojo |
| Conector no disponible | Estado público en la ficha del conector | Consulta el catálogo de conectores |
| No veo Conexiones en el menú | Tu rol en el workspace | Conexiones es área del dueño; pide acceso al dueño |
| Llegué al límite de conexiones | Límite del plan | Archiva una conexión sin uso o consulta Planes |
Límites y costos#
- Registrar, probar y guardar: R$ 0 en la plataforma. Algunos conectores externos cobran por llamada de API — revisa la ficha del conector.
- El número de conexiones está limitado por el plan.
- No publicamos tiempos de registro ni de prueba: dependen del origen y de la red.
Volver a la aplicación#
- Registrar ahora: Conexiones → Nueva conexión
- Ver las conexiones ya registradas: Conexiones de datos
Próxima tarea#
Crea el pipeline que va a usar esta conexión: Primera ingesta. En la ficha de la conexión, el atajo es Usar en un pipeline nuevo.
Última revisión: 2026-10-03. Las capturas de esta página salieron de la versión
entregada, en un entorno de demostración con datos ficticios (workspace
sintético del seed del proyecto), viewport 1366×768. La procedencia de cada imagen
— archivo, SHA-256, ruta, commit, rol y revisión de privacidad — está en el
manifiesto de capturas e2e/baseline/galeria-v3.json. Una captura de entorno
local documenta la interfaz; no comprueba la ejecución en la nube. Ningún dato,
nombre ni credencial de cliente aparece en esta documentación.