Objetivo
Mantener un Data Source usable sin eliminarlo y recrearlo. Por ejemplo, edita un Data Source cuando rota la contraseña de una base de datos externa, el host cambia tras una migración de infraestructura, debe verse un nuevo schema o se actualizan los ajustes SSL.
Cuándo usarlo
Usa esta tarea cuando:
- cambiaron las credenciales;
- cambiaron el host, el puerto o el nombre de la base de datos;
- cambió el acceso a schemas;
- cambió el SSL Mode o el certificado CA;
- los metadatos necesitan más contexto operativo.
Antes de empezar
Confirma qué cambió:
- credenciales: actualiza Username o Password;
- ubicación de la base de datos: actualiza Host, Port o Database Name;
- visibilidad de schemas: actualiza la lista de schemas;
- seguridad: actualiza SSL Mode o CA Certificate.
Una actualización del Data Source afecta la generación futura de Reports. Los Reports ya generados se quedan sin cambios.
Paso a paso
Abre el formulario de edición
Haz clic en los tres puntos verticales () de la tarjeta y selecciona Edit.
El campo Password aparece vacío por motivos de seguridad. Introduce un nuevo valor solo si vas a cambiar la contraseña. Dejarlo en blanco mantiene la contraseña actual.
Guía de campos
| Campo | Qué cambiar | Ejemplo |
|---|---|---|
| Connection Name | Nombre obligatorio visible al operador. Campo técnico: configName; la validación de la Console es 3 a 100 caracteres. | production-postgres-readonly |
| Database Type | Motor de base de datos usado por la conexión. La Console actualmente ofrece POSTGRESQL y MONGODB. | POSTGRESQL |
| Host | Dirección del servidor de base de datos. Cambiarlo cambia de dónde lee Reporter los datos futuros. | db-new.example.com |
| Port | Puerto de red de la base de datos. Rango válido: 1 a 65535. | 5432 |
| Database Name | Base de datos que Reporter consulta a través de este Data Source. | ledger_reporting |
| Username | Usuario de base de datos usado por Reporter. | reporter_readonly |
| Password (opcional) | Déjalo en blanco para conservar la contraseña actual. Introduce un valor solo cuando reemplaces la credencial almacenada. | Nueva contraseña rotada |
| Schemas | Lista opcional de schemas, guardada como metadata.schemas; las entradas se recortan, pasan a minúsculas y se deduplican. | public, pix |
| Enable SSL | Activa/desactiva SSL. Desactivar envía ssl.mode = disable. | Desactivado tras migración de red |
| SSL Mode | Comportamiento de SSL. Usa disable, require, verify-ca o verify-full. | verify-full |
| CA Certificate | Obligatorio al cambiar SSL a verify-ca o verify-full. Déjalo en blanco salvo que reemplaces material de SSL. | Certificado CA en PEM |
| Campos clave/valor de Metadata | Datos opcionales de clasificación. Solo se envían filas con clave no vacía. | owner = compliance |
Resultado esperado
El Data Source conserva la configuración actualizada. Tras una prueba exitosa, los operadores pueden confiar en él para Templates y Reports.
Errores comunes y puntos de atención
Dejar la contraseña vacía sin querer
Dejar la contraseña vacía sin querer
Dejar Password vacío preserva la contraseña existente. Introduce un nuevo valor solo cuando la credencial haya cambiado.
Cambiar el host sin probar
Cambiar el host sin probar
Los cambios de host y puerto pueden apuntar a Reporter a una base de datos distinta. Ejecuta siempre Test Connection tras guardar.
Eliminar un schema que usan Templates
Eliminar un schema que usan Templates
Si un Template o filtro depende de campos de un schema, eliminar ese schema puede romper la generación futura.
Editar cuando la conexión debería retirarse
Editar cuando la conexión debería retirarse
Si la base de datos ya no la usa ningún proceso de reporting, elimina el Data Source en lugar de editarlo.
Pasos siguientes
- Usa Probar una conexión de Data Source tras cada cambio de conexión.
- Usa Generar un Report solo cuando la conexión esté saludable.
- Usa Eliminar un Data Source cuando la conexión esté retirada.