#Externí databáze

#Úvod

NocoBase umožňuje využívat stávající externí databáze jako zdroj dat. Aktuálně podporujeme databáze MySQL, MariaDB, PostgreSQL, MSSQL a Oracle.

#Pokyny k použití

#Přidání externí databáze

Po aktivaci pluginu jej můžete vybrat a přidat z rozbalovacího menu „Přidat nový“ ve správě zdrojů dat.

Vyplňte informace o databázi, ke které se chcete připojit.

#Synchronizace kolekcí

Po navázání spojení s externí databází NocoBase automaticky načte všechny kolekce z daného zdroje dat. Externí databáze nepodporují přímé přidávání kolekcí ani úpravu jejich struktury. Pokud potřebujete provést změny, učiňte tak prostřednictvím databázového klienta a poté klikněte na tlačítko „Obnovit“ v rozhraní pro synchronizaci.

#Konfigurace polí

Externí databáze automaticky načte a zobrazí pole stávajících kolekcí. Můžete rychle prohlížet a konfigurovat název pole, datový typ (Field type) a typ uživatelského rozhraní (Field interface). Pro úpravu dalších nastavení můžete také kliknout na tlačítko „Upravit“.

Jelikož externí databáze nepodporují úpravu struktury kolekcí, jediným dostupným typem při přidávání nového pole je asociační pole. Asociační pole nejsou skutečná pole, ale slouží k navázání spojení mezi kolekcemi.

Více podrobností naleznete v kapitole Pole kolekcí/Přehled.

#Mapování typů polí

NocoBase automaticky mapuje typy polí z externí databáze na odpovídající datový typ (Field type) a typ uživatelského rozhraní (Field Interface).

• Datový typ (Field type): Definuje druh, formát a strukturu dat, která může pole ukládat.
• Typ uživatelského rozhraní (Field interface): Odkazuje na typ ovládacího prvku používaného v uživatelském rozhraní pro zobrazení a zadávání hodnot polí.

PostgreSQL	MySQL/MariaDB	Datový typ NocoBase	Typ rozhraní 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	-	-	-

#Nepodporované typy polí

Nepodporované typy polí jsou zobrazeny samostatně. Tato pole vyžadují vývojovou adaptaci, než je bude možné použít.

#Klíč pro cílené filtrování

Kolekce zobrazované jako bloky musí mít nakonfigurován klíč pro cílené filtrování (Filter target key). Tento klíč slouží k filtrování dat na základě specifického pole, přičemž hodnota pole musí být unikátní. Ve výchozím nastavení je klíčem pro cílené filtrování pole primárního klíče kolekce. U pohledů, kolekcí bez primárního klíče nebo kolekcí se složeným primárním klíčem je nutné definovat vlastní klíč pro cílené filtrování.

Pouze kolekce, které mají nakonfigurován klíč pro cílené filtrování, lze přidat na stránku.