Base de datos
Cuando los datos están en una base de datos y no hay una API delante, conectas la base directamente. La plataforma solo lee: nunca escribe nada en ella.
En el workspace Aurora Imóveis, el conector Banco do sistema de locação es un PostgreSQL. De él vienen los contratos, los boletos de alquiler y los documentos de cada inquilino.
Bases de datos compatibles
| Tipo | Bases de datos |
|---|---|
| SQL | PostgreSQL, MySQL, MariaDB, SQL Server |
| NoSQL | MongoDB |
Otras bases de datos aparecen en la lista como próximamente.
Conectar una base de datos
- En Datos › Conectores, haz clic en Conectar fuente y abre la pestaña Base de datos.
- Elige el Tipo (SQL o NoSQL) y la Base de datos.
- Completa la conexión:
| Campo | Qué informar |
|---|---|
| Host y Puerto | La dirección del servidor, como db.exemplo.com.br, y el puerto (el estándar de la base ya viene completado) |
| Database | El nombre de la base, como locacao |
| Usuario y Contraseña | El usuario que la plataforma usa para leer |
| Connection string | Solo en MongoDB: la cadena de conexión completa, en lugar de host y puerto |
| SSL/TLS | Conecta con cifrado |
| Verificar certificado | Verifica el certificado del servidor (solo con SSL/TLS activado) |
- Haz clic en Probar conexión para verificar.
- Haz clic en Conectar y sincronizar.
La prueba se conecta a la base y lista las tablas y vistas (o colecciones, en MongoDB) que el usuario puede ver. Aparecen en la pestaña Tablas y vistas de la página del conector.
Siempre solo lectura
La opción Solo lectura (siempre) viene marcada y no se puede desactivar. Además de hacer solo consultas, la plataforma abre la sesión en modo de lectura cuando la base de datos lo permite.
Aun así, crea un usuario de solo lectura, con permiso de SELECT únicamente en las tablas que el portal necesita. En el ejemplo de Aurora Imóveis, el usuario es portal_leitura.
Red
La base de datos debe aceptar conexiones de la plataforma por internet:
- Permite las IPs de salida de Kobana en el firewall de la base.
- El host debe apuntar a una dirección pública. Las direcciones internas (como
localhosto IPs de red privada) se rechazan.
Tablas o consultas SQL
Una entidad puede leer de dos formas:
- Una tabla, vista o colección — elígela en la lista, en Crear entidad. También puedes filtrar qué filas entran (consulta Sincronización de las entidades).
- Una consulta SQL — escribe un
SELECT, conJOINsi lo necesitas. Es lo que usa Aurora Imóveis para unir contratos e inmuebles. Consulta Consultas SQL.
Al editar el conector, la base de datos elegida queda fija; el resto de la conexión se puede cambiar. Deja la contraseña (o la connection string) en blanco para mantener la guardada.