#Zewnętrzna baza danych

#Wprowadzenie

Mogą Państwo używać istniejącej zewnętrznej bazy danych jako źródła danych. Obecnie obsługiwane zewnętrzne bazy danych to MySQL, MariaDB, PostgreSQL, MSSQL i Oracle.

#Instrukcje użytkowania

#Dodawanie zewnętrznej bazy danych

Po aktywacji wtyczki mogą Państwo wybrać i dodać ją z rozwijanego menu "Dodaj nowe" w zarządzaniu źródłami danych.

Proszę uzupełnić informacje dotyczące bazy danych, z którą chcą Państwo nawiązać połączenie.

#Synchronizacja kolekcji

Po nawiązaniu połączenia z zewnętrzną bazą danych, wszystkie kolekcje w ramach źródła danych zostaną bezpośrednio odczytane. Zewnętrzne bazy danych nie obsługują bezpośredniego dodawania kolekcji ani modyfikowania struktury tabel. Jeśli potrzebne są modyfikacje, mogą Państwo wykonać je za pomocą klienta bazy danych, a następnie kliknąć przycisk "Odśwież" w interfejsie, aby zsynchronizować zmiany.

#Konfiguracja pól

Zewnętrzna baza danych automatycznie odczyta i wyświetli pola istniejących kolekcji. Mogą Państwo szybko przeglądać i konfigurować tytuł pola, typ danych (Field type) oraz typ interfejsu użytkownika (Field interface). Mogą Państwo również kliknąć przycisk "Edytuj", aby zmodyfikować więcej ustawień.

Ponieważ zewnętrzne bazy danych nie obsługują modyfikowania struktury tabel, jedynym dostępnym typem podczas dodawania nowego pola jest pole relacji. Pola relacji nie są rzeczywistymi polami, ale służą do nawiązywania połączeń między kolekcjami.

Więcej szczegółów znajdą Państwo w rozdziale Pola kolekcji/Przegląd.

#Mapowanie typów pól

NocoBase automatycznie mapuje typy pól z zewnętrznej bazy danych do odpowiadającego im typu danych (Field type) i typu interfejsu użytkownika (Field Interface).

• Typ danych (Field type): Definiuje rodzaj, format i strukturę danych, które pole może przechowywać.
• Typ interfejsu użytkownika (Field interface): Odnosi się do typu kontrolki używanej w interfejsie użytkownika do wyświetlania i wprowadzania wartości pól.

PostgreSQL	MySQL/MariaDB	Typ danych NocoBase	Typ interfejsu 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	-	-	-

#Nieobsługiwane typy pól

Nieobsługiwane typy pól są wyświetlane oddzielnie. Pola te wymagają adaptacji deweloperskiej, zanim będzie można ich użyć.

#Klucz docelowy filtra

Kolekcje wyświetlane jako bloki muszą mieć skonfigurowany klucz docelowy filtra. Klucz docelowy filtra służy do filtrowania danych na podstawie określonego pola, a wartość pola musi być unikalna. Domyślnie klucz docelowy filtra jest polem klucza podstawowego kolekcji. W przypadku widoków, kolekcji bez klucza podstawowego lub kolekcji z kluczem złożonym, należy zdefiniować niestandardowy klucz docelowy filtra.

Tylko kolekcje, które mają skonfigurowany klucz docelowy filtra, mogą być dodane do strony.