#Base de Datos Externa

#Introducción

Puede usar una base de datos externa existente como fuente de datos. Actualmente, las bases de datos externas compatibles incluyen MySQL, MariaDB, PostgreSQL, MSSQL y Oracle.

#Instrucciones de Uso

#Añadir una Base de Datos Externa

Después de activar el plugin, podrá seleccionarlo y añadirlo desde el menú desplegable "Añadir nuevo" en la gestión de fuentes de datos.

Complete la información de la base de datos a la que desea conectarse.

#Sincronización de Colecciones

Una vez establecida la conexión con una base de datos externa, NocoBase leerá directamente todas las colecciones de la fuente de datos. Las bases de datos externas no permiten añadir colecciones ni modificar la estructura de las tablas directamente. Si necesita realizar modificaciones, hágalo a través de un cliente de base de datos y luego haga clic en el botón "Actualizar" en la interfaz para sincronizar los cambios.

#Configuración de Campos

La base de datos externa leerá y mostrará automáticamente los campos de las colecciones existentes. Podrá ver y configurar rápidamente el título del campo, el tipo de dato (Field type) y el tipo de interfaz de usuario (Field interface). También puede hacer clic en el botón "Editar" para modificar más configuraciones.

Dado que las bases de datos externas no permiten modificar la estructura de las tablas, el único tipo disponible al añadir un nuevo campo es el campo de relación. Los campos de relación no son campos reales, sino que se utilizan para establecer conexiones entre colecciones.

Para más detalles, consulte el capítulo Campos de colección/Descripción general.

#Mapeo de Tipos de Campo

NocoBase mapea automáticamente los tipos de campo de la base de datos externa a su tipo de dato (Field type) y tipo de interfaz de usuario (Field Interface) correspondientes.

• Tipo de dato (Field type): Define el tipo, formato y estructura de los datos que un campo puede almacenar.
• Tipo de interfaz de usuario (Field interface): Se refiere al tipo de control utilizado en la interfaz de usuario para mostrar e introducir los valores de los campos.

PostgreSQL	MySQL/MariaDB	Tipo de Dato de NocoBase	Tipo de Interfaz de NocoBase
BOOLEAN	BOOLEAN TINYINT(1)	boolean	checkbox switch
SMALLINT INTEGER SERIAL SMALLSERIAL	TINYINT SMALLINT MEDIUMINT INTEGER	integer boolean sort	integer sort checkbox switch select radioGroup
BIGINT BIGSERIAL	BIGINT	bigInt sort	integer sort checkbox switch select radioGroup unixTimestamp createdAt updatedAt
REAL	FLOAT	float	number percent
DOUBLE PRECISION	DOUBLE PRECISION	double	number percent
DECIMAL NUMERIC	DECIMAL	decimal	number percent currency
VARCHAR CHAR	VARCHAR CHAR	string password uuid nanoid	input email phone password color icon select radioGroup uuid nanoid
TEXT	TEXT TINYTEXT MEDIUMTEXT LONGTEXT	text json	textarea markdown vditor richText url json
UUID	-	uuid	uuid
JSON JSONB	JSON	json	json
TIMESTAMP	DATETIME TIMESTAMP	date	date time createdAt updatedAt
DATE	DATE	dateOnly	datetime
TIME	TIME	time	time
-	YEAR		datetime
CIRCEL		circle	json circle
PATH GEOMETRY(LINESTRING)	LINESTRING	lineString	Json lineString
POINT GEOMETRY(POINT)	POINT	point	json point
POLYGON GEOMETRY(POLYGON)	POLYGON	polygon	json polygon
GEOMETRY	GEOMETRY	-	-
BLOB	BLOB	blob	-
ENUM	ENUM	enum	select radioGroup
ARRAY	-	array	multipleSelect checkboxGroup
BIT	BIT	-	-
SET	SET	set	multipleSelect checkboxGroup
RANGE	-	-	-

#Tipos de Campo No Compatibles

Los tipos de campo no compatibles se muestran por separado. Estos campos requieren una adaptación de desarrollo antes de poder utilizarlos.

#Clave de Destino de Filtro

Las colecciones que se muestran como bloques deben tener configurada una clave de destino de filtro (Filter target key). La clave de destino de filtro se utiliza para filtrar datos basándose en un campo específico, y el valor de ese campo debe ser único. Por defecto, la clave de destino de filtro es el campo de clave primaria de la colección. Para vistas, colecciones sin clave primaria o colecciones con una clave primaria compuesta, deberá definir una clave de destino de filtro personalizada.

Solo las colecciones que tienen una clave de destino de filtro configurada pueden añadirse a la página.