PostgreSQL
Data source: External PostgreSQLStandard Edition+Introducción
PostgreSQL puede conectarse a NocoBase como base de datos externa. Una vez conectado, NocoBase leerá las tablas, los campos y las vistas de PostgreSQL, y los utilizará como tablas de datos en la fuente de datos externa.
A diferencia de la base de datos principal, la estructura real de las tablas de PostgreSQL externo seguirá siendo mantenida por el sistema empresarial original, el cliente de base de datos o los scripts de migración. NocoBase se encarga de leer la estructura, guardar los metadatos de los campos y configurar los bloques de página, los permisos, los flujos de trabajo y las API.
Casos adecuados para usar PostgreSQL externo:
- Conectar las bases de datos PostgreSQL de sistemas empresariales existentes, como ERP, MES, WMS o CRM
- Crear interfaces de gestión con NocoBase sin migrar los datos históricos
- Aplicar controles de permisos, procesar flujos, corregir datos o mostrar informes sobre tablas existentes
- Mantener la estructura de la base de datos mediante el DBA, scripts de migración o el sistema original
PostgreSQL externo no es la base de datos del sistema de NocoBase. NocoBase no se hará cargo de sus copias de seguridad, restauración, migración ni cambios en la estructura de las tablas.
Instalación del plugin
Este plugin es comercial. Para obtener información detallada sobre la activación, consulta la Guía de activación de plugins comerciales
Añadir una fuente de datos
En «Gestión de fuentes de datos», haz clic en «Add new», selecciona PostgreSQL y completa la información de conexión.
Configuración habitual de la conexión:
Si PostgreSQL contiene muchos objetos, limita primero el alcance mediante Schema, Table prefix y «Collections». Conecta solo las tablas y vistas que utilice la aplicación actual para simplificar la configuración posterior de permisos, la creación de páginas y el mantenimiento de la sincronización.
Seleccionar tablas de datos
Después de completar la información de conexión, puedes hacer clic en «Load Collections» para leer las tablas y vistas disponibles en PostgreSQL. Los resultados de la lectura dependerán de la cuenta de conexión, Schema, Table prefix y la configuración de «Collections».
De forma predeterminada, «Add all collections» estará activado, lo que indica que se conectarán todas las tablas y vistas del alcance actual. Si solo quieres conectar algunos objetos, desactiva «Add all collections» y selecciona en la lista las tablas o vistas que necesites.
Una sola fuente de datos externa puede conectar como máximo 500 tablas o vistas a la vez. Si PostgreSQL contiene muchos objetos, se recomienda limitar primero el alcance mediante Schema, Table prefix o «Collections».
Synchronizar y configurar campos
La estructura de las tablas de PostgreSQL externo se mantiene en el lado de la base de datos. NocoBase no creará campos, modificará sus tipos ni eliminará campos reales en PostgreSQL externo.
Cuando cambie la estructura de las tablas en PostgreSQL, puedes ejecutar «Sync from database» en la fuente de datos para volver a leer los metadatos de las tablas y los campos. La sincronización actualizará en NocoBase la información guardada sobre las tablas de datos, los campos, las claves principales, las claves únicas y el mapeo de tipos de campo, pero no eliminará las tablas reales ni los datos de PostgreSQL.
Después de sincronizar los campos, puedes configurar en NocoBase el título del campo, el tipo de campo (Field type) y el componente del campo (Field interface). Si necesitas crear campos de relación de NocoBase, los metadatos de la relación también se guardarán en NocoBase; no se añadirán automáticamente campos de clave externa reales a las tablas de PostgreSQL.
Mapeo de tipos de campo
NocoBase asignará automáticamente los tipos de campo de PostgreSQL al Field type y al Field interface adecuados. Puedes ajustar la forma de visualización en la configuración del campo.
Mapeos habituales:
Los tipos de campo de PostgreSQL no compatibles se mostrarán por separado en la configuración de campos. Para utilizar este tipo de campos como campos normales en NocoBase, primero es necesario desarrollar una adaptación.
Clave principal e identificador único de los registros
Se recomienda que las tablas de datos utilizadas para mostrar y editar bloques de página tengan una clave principal o un campo único. NocoBase utilizará preferentemente la clave principal como identificador único del registro.
Si conectas una vista, una tabla sin clave principal o una tabla con clave principal compuesta, debes configurar manualmente «Record unique key» en la configuración de la tabla de datos. Si no existe un identificador único disponible, es posible que los bloques de página no puedan consultar, editar o eliminar correctamente los registros.
Enlaces relacionados
- Base de datos externa — Consulta la configuración general y las instrucciones de gestión de las bases de datos externas
- Gestión de fuentes de datos — Consulta el acceso y los métodos de gestión de las fuentes de datos
- Campos de las tablas de datos — Consulta las instrucciones sobre los tipos de campo y el mapeo de campos