Objetivo
Valida la conectividad antes de que los operadores dependan de la fuente de datos en plantillas o informes. Por ejemplo, prueba la conexión después de crear
production-postgres, después de una rotación de contraseña, o antes de generar un informe mensual que depende de un esquema modificado recientemente.
Cuándo usarlo
Usa esta tarea:
- inmediatamente después de agregar una fuente de datos externa.
- al revisar una fuente de datos interna existente antes de usarla en una plantilla o un filtro.
- después de editar el host, las credenciales, el esquema o la configuración SSL.
- antes de generar informes que dependen de la conexión.
- cuando no aparecen tablas en el explorador de esquemas.
- cuando la generación de informes falla por errores de conexión o de esquema.
Antes de empezar
Confirma:
- que la fuente de datos existe en la página Data Sources.
- que el host, el puerto, el nombre de la base de datos, el usuario, el esquema y la configuración SSL esperados están configurados.
- que se recomienda que la base de datos sea alcanzable desde Reporter.
- que el usuario de la base de datos tiene permiso para leer las tablas requeridas.
Una prueba exitosa confirma el acceso en ese momento. No garantiza que los informes futuros tengan éxito si las credenciales, las reglas de red o los permisos de la base de datos cambian más adelante.
Paso a paso
1
Abre Data Sources
Ve a Data Sources.
2
Encuentra la conexión
Localiza la tarjeta de la fuente de datos 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
Reporter devuelve el resultado de la conexión, un mensaje seguro para mostrar al cliente y la latencia medida. Una prueba exitosa devuelve
connected. Una prueba fallida devuelve failed.6
Recupera el esquema por separado
Después de una prueba exitosa, usa la operación de esquema separada para obtener esquemas, tablas y campos.
Guía de campos
Campos de la acción y del resultado de la prueba
Campos de esquema disponibles por separado
Resultado esperado
Reporter devolvió
connected para la prueba. Obtén el esquema por separado antes de usar sus campos en Template Builder y en los filtros de informes.
Errores comunes y puntos de atención
La conexión funciona pero no aparecen tablas
La conexión funciona pero no aparecen tablas
Revisa los nombres de los esquemas y los permisos de la base de datos. El usuario de la base de datos puede conectarse pero no tener acceso a las tablas necesarias para la generación de informes.
La conexión falla después de editar las credenciales
La conexión falla después de editar las credenciales
Vuelve a abrir la fuente de datos y confirma el usuario, la contraseña, el host, el puerto y la configuración SSL.
Probar una vez y suponer que sigue siendo válida
Probar una vez y suponer que sigue siendo válida
Las reglas de red, las contraseñas rotadas y los permisos de la base de datos pueden cambiar. Vuelve a probar cuando aparezcan errores de generación.
Próximos pasos
- Usa Template Builder después de que los esquemas y los campos sean visibles.
- Usa Generar un informe después de que la fuente de datos esté en buen estado.
- Usa Editar una fuente de datos si la prueba falla porque la configuración es incorrecta.