Probar una conexión de Data Source

Verifica que las credenciales y los ajustes de red de un Data Source son correctos antes de depender de él para generar informes en el módulo Reporter.

Usa esta página para confirmar que Reporter puede alcanzar un Data Source y cargar su schema. El Data Source puede ser una conexión interna ya configurada para un producto Lerian o una conexión externa añadida desde la Console.

​

Objetivo

---

Validar la conectividad antes de que los operadores dependan del Data Source en Templates o Reports.

Por ejemplo, prueba tras crear production-postgres, tras una rotación de contraseña o antes de generar un informe mensual que dependa de un schema recientemente cambiado.

​

Cuándo usarlo

---

Usa esta tarea:

• inmediatamente después de añadir un Data Source externo;
• al revisar un Data Source interno existente antes de usarlo en un Template o filtro;
• tras editar host, credenciales, schema o ajustes SSL;
• antes de generar Reports que dependan de la conexión;
• cuando no aparecen tablas en el explorador de schemas;
• cuando la generación de Reports falla por errores de conexión o de schema.

​

Antes de empezar

---

Confirma:

• el Data Source existe en la página Data Sources;
• el host, puerto, nombre de base de datos, usuario, schema y ajustes SSL esperados están configurados;
• la base de datos debe ser alcanzable desde Reporter;
• el usuario de base de datos tiene permiso para leer las tablas requeridas.

Una prueba exitosa confirma el acceso en ese momento. No garantiza que los Reports futuros tendrán éxito si las credenciales, las reglas de red o los permisos de la base de datos cambian más tarde.

​

Paso a paso

---

1. Abre Data Sources

   Ve a Data Sources.

2. Localiza la conexión

   Encuentra la tarjeta del Data Source que necesitas probar.

3. Ejecuta la prueba

   Haz clic en Test Connection.

4. Espera el resultado

   El estado cambia a Connecting mientras Reporter prueba la conexión.

5. Lee el resultado

   Si la prueba tiene éxito, el estado cambia a Connected y se muestra la latencia, como Latency: 45ms. Si falla, el estado cambia a Disconnected y aparece un mensaje de error.

6. Revisa el schema cuando esté conectado

   Expande la tarjeta de conexión para ver los schemas, tablas y campos devueltos por la conexión.

​

Guía de campos

---

​

Acción de prueba y campos de resultado

Campo o estado	Qué significa	Ejemplo
Test Connection	Acción en la tarjeta del Data Source. La Console usa el connectionId seleccionado para llamar al endpoint de prueba.	Probar production-postgres.
Connecting	Estado local mientras la solicitud de prueba está pendiente. Espera el resultado final antes de editar o generar un Report.	Connecting
Connected	Resultado exitoso. Reporter devolvió connected o success, y el Data Source es usable en ese momento.	Connected con Latency: 45ms.
Disconnected	Resultado fallido o error de solicitud. Revisa host, puerto, credenciales, acceso de red, schema y ajustes SSL.	Disconnected tras authentication failed.
Latencia	latencyMs, devuelto en milisegundos tras una prueba exitosa. Es una señal, no una garantía de la velocidad futura de generación.	45
Mensaje de prueba	message devuelto por Reporter, usualmente más útil en caso de fallo. Úsalo como primera pista de qué corregir.	authentication failed

​

Campos de schema mostrados tras la prueba

Elemento de schema	Qué muestra	Ejemplo
Tablas	tables[].name devuelto por la validación de schema. Estas son las tablas que los operadores pueden usar en Template Builder y en filtros de informes.	transactions
Campos	tables[].fields[] dentro de cada tabla. Estos campos pueden insertarse como variables de Template o usarse como filtros de Report.	amount, created_at
Sin schema cargado	Array tables vacío o error al cargar el schema. La conexión puede funcionar, pero los permisos de tabla o los nombres de schema aún necesitan corrección.	No se descubrieron tablas.

​

Resultado esperado

---

El estado del Data Source es Connected, la información de schema está disponible y los operadores pueden usar con seguridad sus campos en Template Builder y en filtros de informes.

​

Errores comunes y puntos de atención

---

La conexión tiene éxito pero no aparecen tablas

Revisa los nombres de schema y los permisos de la base de datos. El usuario de la base de datos puede conectar pero no tener acceso a las tablas necesarias para el reporting.

La conexión falla tras editar credenciales

Reabre el Data Source y confirma usuario, contraseña, host, puerto y ajustes SSL.

Probar una vez y asumir que sigue siendo válido

Las reglas de red, las contraseñas rotadas y los permisos de base de datos pueden cambiar. Vuelve a probar cuando aparezcan errores de generación.

​

Pasos siguientes

---

• Usa el Template Builder tras ver schemas y campos visibles.
• Usa Generar un Report cuando el Data Source esté saludable.
• Usa Editar un Data Source si la prueba falla por ajustes incorrectos.

Test connection

Prueba una conexión de Data Source de forma programática.

Validate schema

Valida el acceso de schema a tablas y campos.