#Externe Datenbank

#Einführung

Sie können eine bestehende externe Datenbank als Datenquelle verwenden. Derzeit werden folgende externe Datenbanken unterstützt: MySQL, MariaDB, PostgreSQL, MSSQL und Oracle.

#Anwendungsanleitung

#Externe Datenbank hinzufügen

Nachdem Sie das Plugin aktiviert haben, können Sie es im Dropdown-Menü „Add new“ der Datenquellenverwaltung auswählen und hinzufügen.

Geben Sie die Informationen für die Datenbank ein, die Sie verbinden möchten.

#Sammlungssynchronisierung

Nachdem eine Verbindung zu einer externen Datenbank hergestellt wurde, werden alle Sammlungen innerhalb der Datenquelle direkt eingelesen. Externe Datenbanken unterstützen das direkte Hinzufügen von Sammlungen oder das Ändern der Tabellenstruktur nicht. Wenn Änderungen erforderlich sind, können Sie diese über einen Datenbank-Client vornehmen und anschließend in der Benutzeroberfläche auf die Schaltfläche „Aktualisieren“ klicken, um die Synchronisierung durchzuführen.

#Felder konfigurieren

Die externe Datenbank liest die Felder bestehender Sammlungen automatisch ein und zeigt sie an. Sie können den Titel, den Datentyp (Field type) und den UI-Typ (Field interface) des Feldes schnell anzeigen und konfigurieren. Klicken Sie auf die Schaltfläche „Bearbeiten“, um weitere Einstellungen zu ändern.

Da externe Datenbanken das Ändern der Tabellenstruktur nicht unterstützen, ist beim Hinzufügen eines neuen Feldes nur der Beziehungstyp verfügbar. Beziehungsfelder sind keine echten Felder, sondern dienen dazu, Verbindungen zwischen Sammlungen herzustellen.

Weitere Details finden Sie im Kapitel Sammlungsfelder/Übersicht.

#Feldtyp-Zuordnung

NocoBase ordnet die Feldtypen der externen Datenbank automatisch dem entsprechenden Datentyp (Field type) und UI-Typ (Field Interface) zu.

• Datentyp (Field type): Definiert die Art, das Format und die Struktur der Daten, die ein Feld speichern kann.
• UI-Typ (Field interface): Bezieht sich auf den Steuerelementtyp, der in der Benutzeroberfläche zur Anzeige und Eingabe von Feldwerten verwendet wird.

PostgreSQL	MySQL/MariaDB	NocoBase Datentyp	NocoBase Interface Type
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	-	-	-

#Nicht unterstützte Feldtypen

Nicht unterstützte Feldtypen werden separat angezeigt. Diese Felder erfordern eine Entwicklungsanpassung, bevor sie verwendet werden können.

#Filter-Zielschlüssel

Sammlungen, die als Blöcke angezeigt werden, müssen einen Filter-Zielschlüssel (Filter target key) konfiguriert haben. Der Filter-Zielschlüssel dient dazu, Daten basierend auf einem bestimmten Feld zu filtern, wobei der Feldwert eindeutig sein muss. Standardmäßig ist der Filter-Zielschlüssel das Primärschlüsselfeld der Sammlung. Bei Ansichten, Sammlungen ohne Primärschlüssel oder Sammlungen mit einem zusammengesetzten Primärschlüssel müssen Sie einen benutzerdefinierten Filter-Zielschlüssel definieren.

Nur Sammlungen, für die ein Filter-Zielschlüssel konfiguriert wurde, können der Seite hinzugefügt werden.