#Extern databas

#Introduktion

Ni kan använda en befintlig extern databas som en datakälla. För närvarande stöds följande externa databaser: MySQL, MariaDB, PostgreSQL, MSSQL och Oracle.

#Användningsinstruktioner

#Lägga till en extern databas

När ni har aktiverat plugin-et kan ni välja och lägga till det från rullgardinsmenyn "Lägg till ny" under datakälla-hanteringen.

Fyll i informationen för den databas ni vill ansluta till.

#Samling-synkronisering

Efter att en anslutning har upprättats med en extern databas kommer alla samlingar inom datakällan att läsas in direkt. Externa databaser stöder inte direkt tillägg av samlingar eller ändring av tabellstrukturen. Om ändringar behövs kan ni utföra dem via en databasklient och sedan klicka på knappen "Uppdatera" i gränssnittet för att synkronisera.

#Konfigurera fält

Den externa databasen läser automatiskt in och visar fälten från befintliga samlingar. Ni kan snabbt granska och konfigurera fältets rubrik, datatyp (Field type) och UI-typ (Field interface). Ni kan också klicka på knappen "Redigera" för att ändra fler inställningar.

Eftersom externa databaser inte stöder ändringar av tabellstrukturen är den enda tillgängliga fälttypen när ni lägger till ett nytt fält ett relationsfält (association field). Relationsfält är inte faktiska fält, utan används för att upprätta kopplingar mellan samlingar.

För mer information, se kapitlet Samlingsfält/Översikt.

#Fälttypmappning

NocoBase mappar automatiskt fälttyperna från den externa databasen till motsvarande datatyp (Field type) och UI-typ (Field Interface).

• Datatyp (Field type): Definierar vilken typ, vilket format och vilken struktur den data som ett fält kan lagra har.
• UI-typ (Field interface): Avser den typ av kontroll som används i användargränssnittet för att visa och mata in fältvärden.

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

#Fälttyper som inte stöds

Fälttyper som inte stöds visas separat. Dessa fält kräver anpassning via utveckling innan de kan användas.

#Filtermålsnyckel

Samlingar som visas som block måste ha en filtermålsnyckel (Filter target key) konfigurerad. Filtermålsnyckeln används för att filtrera data baserat på ett specifikt fält, och fältvärdet måste vara unikt. Som standard är filtermålsnyckeln samlingens primärnyckelfält. För vyer, samlingar utan primärnyckel, eller samlingar med en sammansatt primärnyckel, behöver ni definiera en anpassad filtermålsnyckel.

Endast samlingar som har en filtermålsnyckel konfigurerad kan läggas till på sidan.