#Database Esterno

#Introduzione

Utilizzi un database esterno esistente come fonte dati. Attualmente, i database esterni supportati includono MySQL, MariaDB, PostgreSQL, MSSQL e Oracle.

#Istruzioni per l'uso

#Aggiungere un Database Esterno

Dopo aver attivato il plugin, può selezionarlo e aggiungerlo dal menu a discesa "Aggiungi nuovo" nella gestione delle fonti dati.

Inserisca le informazioni del database a cui desidera connettersi.

#Sincronizzazione delle collezioni

Dopo aver stabilito una connessione con un database esterno, tutte le collezioni all'interno della fonte dati verranno lette direttamente. I database esterni non supportano l'aggiunta diretta di collezioni o la modifica della struttura delle tabelle. Se sono necessarie modifiche, può eseguirle tramite un client di database e quindi fare clic sul pulsante "Aggiorna" nell'interfaccia per sincronizzare.

#Configurazione dei Campi

Il database esterno leggerà e visualizzerà automaticamente i campi delle collezioni esistenti. Può visualizzare e configurare rapidamente il titolo del campo, il tipo di dati (Field type) e il tipo di interfaccia utente (Field interface). Può anche fare clic sul pulsante "Modifica" per modificare ulteriori configurazioni.

Poiché i database esterni non supportano la modifica della struttura delle tabelle, l'unico tipo disponibile quando si aggiunge un nuovo campo è il campo di relazione (association field). I campi di relazione non sono campi reali, ma sono utilizzati per stabilire connessioni tra le collezioni.

Per maggiori dettagli, consulti il capitolo Campi delle collezioni/Panoramica.

#Mappatura del Tipo di Campo

NocoBase mappa automaticamente i tipi di campo del database esterno ai corrispondenti tipi di dati (Field type) e tipi di interfaccia utente (Field Interface).

• Tipo di dati (Field type): Definisce il tipo, il formato e la struttura dei dati che un campo può memorizzare;
• Tipo di interfaccia utente (Field interface): Si riferisce al tipo di controllo utilizzato nell'interfaccia utente per visualizzare e inserire i valori dei campi.

PostgreSQL	MySQL/MariaDB	Tipo di dati NocoBase	Tipo di interfaccia 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
CIRCLE		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	-	-	-

#Tipi di Campo Non Supportati

I tipi di campo non supportati vengono visualizzati separatamente. Questi campi richiedono un adattamento di sviluppo prima di poter essere utilizzati.

#Chiave di Filtro Target

Le collezioni visualizzate come blocchi devono avere una chiave di filtro target (Filter target key) configurata. La chiave di filtro target viene utilizzata per filtrare i dati in base a un campo specifico, e il valore del campo deve essere univoco. Per impostazione predefinita, la chiave di filtro target è il campo chiave primaria della collezione. Per le viste, le collezioni senza una chiave primaria o le collezioni con una chiave primaria composita, è necessario definire una chiave di filtro target personalizzata.

Solo le collezioni che hanno una chiave di filtro target configurata possono essere aggiunte alla pagina.