#Externe database

#Introductie

Gebruik een bestaande externe database als gegevensbron. Momenteel worden de volgende externe databases ondersteund: MySQL, MariaDB, PostgreSQL, MSSQL en Oracle.

#Gebruiksaanwijzing

#Een externe database toevoegen

Nadat u de plugin heeft geactiveerd, kunt u deze selecteren en toevoegen via het vervolgkeuzemenu 'Nieuwe toevoegen' in het gegevensbronbeheer.

Vul de informatie in voor de database waarmee u verbinding wilt maken.

#Collecties synchroniseren

Nadat een verbinding met een externe database is gelegd, worden alle collecties binnen de gegevensbron direct ingelezen. Externe databases ondersteunen het direct toevoegen van collecties of het wijzigen van de tabelstructuur niet. Als wijzigingen nodig zijn, kunt u deze uitvoeren via een databaseclient en vervolgens op de knop 'Vernieuwen' in de interface klikken om te synchroniseren.

#Velden configureren

De externe database leest automatisch de velden van bestaande collecties in en toont deze. U kunt snel de titel, het gegevenstype (Field type) en het UI-type (Field interface) van een veld bekijken en configureren. U kunt ook op de knop 'Bewerken' klikken om meer configuraties aan te passen.

Omdat externe databases het wijzigen van de tabelstructuur niet ondersteunen, is het enige beschikbare type bij het toevoegen van een nieuw veld een relatieveld. Relatievelden zijn geen echte velden, maar worden gebruikt om verbindingen tussen collecties tot stand te brengen.

Voor meer details, zie het hoofdstuk Collectievelden/Overzicht.

#Veldtype-mapping

NocoBase wijst de veldtypen van de externe database automatisch toe aan het corresponderende gegevenstype (Field type) en UI-type (Field Interface).

• Gegevenstype (Field type): Definieert de soort, het formaat en de structuur van de gegevens die een veld kan opslaan.
• UI-type (Field interface): Verwijst naar het type besturingselement dat in de gebruikersinterface wordt gebruikt om veldwaarden weer te geven en in te voeren.

PostgreSQL	MySQL/MariaDB	NocoBase Gegevenstype	NocoBase Interfacetype
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	-	-	-

#Niet-ondersteunde veldtypen

Niet-ondersteunde veldtypen worden apart weergegeven. Deze velden vereisen ontwikkelingsaanpassing voordat ze kunnen worden gebruikt.

#Filterdoelsleutel

Collecties die als blokken worden weergegeven, moeten een filterdoelsleutel (Filter target key) geconfigureerd hebben. De filterdoelsleutel wordt gebruikt om gegevens te filteren op basis van een specifiek veld, en de veldwaarde moet uniek zijn. Standaard is de filterdoelsleutel het primaire sleutelveld van de collectie. Voor views, collecties zonder primaire sleutel, of collecties met een samengestelde primaire sleutel, moet u een aangepaste filterdoelsleutel definiëren.

Alleen collecties waarvoor een filterdoelsleutel is geconfigureerd, kunnen aan de pagina worden toegevoegd.