Añadir un Data Source

Configura una conexión externa de base de datos cuando Reporter necesite un Data Source que no esté ya disponible.

Usa esta página para crear un Data Source cuando Reporter necesite leer desde una base de datos externa o desde una conexión que no esté ya configurada. Si el informe usa datos internos de productos Lerian, como Midaz o CRM, el Data Source puede ya existir.

​

Objetivo

---

Configurar una conexión externa que Templates y Reports puedan usar.

Por ejemplo, crear un Data Source llamado production-postgres que apunte a una base de datos externa de reporting, o compliance-readonly para un usuario de base de datos solo-lectura usado por operadores de reporting.

​

Cuándo usarlo

---

Usa esta tarea cuando:

• el Data Source requerido no está ya disponible en Reporter;
• una nueva base de datos debe alimentar informes;
• un proceso de informe existente necesita una conexión solo-lectura separada;
• los operadores necesitan que schemas y campos estén disponibles en Template Builder o en filtros de informes.

Antes de añadir uno, comprueba si el Data Source interno requerido ya existe. Crear una conexión externa duplicada es innecesario cuando Reporter ya tiene la fuente configurada.

No uses esta tarea para arreglar una conexión existente. Usa Editar un Data Source y Probar una conexión de Data Source.

​

Antes de empezar

---

Ten estos datos a mano:

• host, puerto y nombre de base de datos;
• usuario y contraseña;
• nombres de schemas, cuando la base de datos use schemas;
• requisitos de SSL y certificado CA, cuando los exija la infraestructura;
• un nombre de conexión claro, como production-postgres o compliance-readonly.

Usa credenciales destinadas al acceso de reporting. Un Data Source da a Reporter acceso para leer datos usados en Templates y Reports.

​

Paso a paso

---

1. Abre Data Sources

   Ve a Data Sources y haz clic en Add Data Source.

2. Rellena los datos de conexión

   En Add Data Source, introduce Connection Name, Database Type, Host, Port, Database Name, Username y Password.

3. Configura schemas cuando sea necesario

   Para los tipos de base de datos en los que la Console muestra Schemas (actualmente PostgreSQL en el selector), añade los schemas que Reporter debe inspeccionar. Escribe un nombre de schema y haz clic en Add, o pulsa Enter.

4. Configura SSL cuando sea necesario

   Expande SSL Configuration, activa Enable SSL, selecciona SSL Mode y pega el CA Certificate si tu infraestructura lo requiere.

5. Añade metadatos cuando sea útil

   Expande Metadata para añadir campos clave-valor que ayuden a los operadores a clasificar la conexión.

6. Crea el Data Source

   Haz clic en Create.

7. Prueba la conexión

   El nuevo Data Source aparece con estado Disconnected. Ejecuta Test Connection antes de usarlo en Templates o Reports.

​

Guía de campos

---

Campo	Qué introducir	Ejemplo
Connection Name	Nombre obligatorio visible al operador. Campo técnico: configName. Validación en la Console: 3 a 100 caracteres.	production-postgres
Database Type	Motor de base de datos obligatorio. La Console actualmente ofrece POSTGRESQL y MONGODB. Campo técnico: type.	POSTGRESQL
Host	Dirección obligatoria del servidor de base de datos, no la URL de una aplicación. Campo técnico: host.	db.example.com
Port	Puerto obligatorio de la base de datos. Campo técnico: port; el rango válido es 1 a 65535.	5432
Database Name	Nombre obligatorio de la base de datos que Reporter consultará. Campo técnico: databaseName.	ledger
Username	Usuario obligatorio de la base de datos. Campo técnico: username.	reporter_readonly
Password	Secreto obligatorio al crear un Data Source. Campo técnico: password.	Se almacena vía el formulario
Schemas	Lista opcional de schemas para tipos de base de datos soportados. Se guarda como metadata.schemas; las entradas se recortan, pasan a minúsculas y se deduplican.	public, pix, transactions
Enable SSL	Toggle opcional de SSL. Cuando se activa, el payload de conexión incluye ssl.	Activado
SSL Mode	Obligatorio cuando SSL está activado. Usa disable, require, verify-ca o verify-full. Campo técnico: ssl.mode.	verify-ca
CA Certificate	Obligatorio para verify-ca y verify-full. Campo técnico: ssl.ca.	Certificado CA en PEM
Campos clave/valor de Metadata	Datos opcionales de clasificación. Solo se envían filas con clave no vacía. Campo técnico: metadata.	environment = production

​

Resultado esperado

---

El nuevo Data Source externo aparece en la página Data Sources con estado Disconnected hasta que se prueba. Tras una prueba exitosa, los operadores pueden usar sus campos en Templates y Reports.

​

Errores comunes y puntos de atención

---

Usar una URL de aplicación como Host

Host debe ser la dirección del servidor de base de datos, como db.example.com, no la URL de una aplicación o panel de administración.

Saltarse los schemas

Si la base de datos usa schemas y el schema requerido no está listado, los operadores pueden no ver las tablas y campos esperados.

Ignorar los requisitos de SSL

Si la infraestructura requiere SSL o un certificado CA, la conexión puede fallar hasta que SSL Configuration coincida con ese requisito.

Usar nombres poco claros

Nombres como db1 son difíciles de usar con seguridad. Prefiere nombres que muestren entorno y propósito, como production-compliance-readonly.

​

Pasos siguientes

---

• Usa Probar una conexión de Data Source inmediatamente después de la creación.
• Usa el Template Builder para usar los campos del Data Source en un Template.
• Usa Generar un Report cuando el Template y el Data Source estén listos.

API equivalente

Endpoint Create connection