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
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.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
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
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
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.