#Зовнішня база даних

#Вступ

Використовуйте наявну зовнішню базу даних як джерело даних. Наразі підтримуються такі зовнішні бази даних: MySQL, MariaDB, PostgreSQL, MSSQL та Oracle.

#Інструкції з використання

#Додавання зовнішньої бази даних

Після активації плагіна ви зможете вибрати та додати її з випадаючого меню "Додати нове" (Add new) в управлінні джерелами даних.

Заповніть інформацію про базу даних, до якої потрібно підключитися.

#Синхронізація колекцій

Після встановлення з'єднання із зовнішньою базою даних, вона безпосередньо зчитуватиме всі колекції з джерела даних. Зовнішні бази даних не підтримують пряме додавання колекцій або зміну структури таблиць. Якщо потрібні зміни, ви можете виконати їх через клієнт бази даних, а потім натиснути кнопку "Оновити" (Refresh) в інтерфейсі для синхронізації.

#Налаштування полів

Зовнішня база даних автоматично зчитує поля наявних колекцій та відображає їх. Ви можете швидко переглянути та налаштувати заголовок поля, тип даних (Field type) та тип інтерфейсу (Field interface). Також можна натиснути кнопку "Редагувати" (Edit), щоб змінити додаткові налаштування.

Оскільки зовнішні бази даних не підтримують зміну структури таблиць, при додаванні нового поля доступний лише тип "поле зв'язку". Поля зв'язку не є реальними полями, а використовуються для встановлення зв'язків між колекціями.

Докладніше дивіться у розділі Поля колекції/Огляд.

#Зіставлення типів полів

NocoBase автоматично зіставляє типи полів із зовнішньої бази даних з відповідними типами даних (Field type) та типами інтерфейсу (Field Interface).

• Тип даних (Field type): визначає вид, формат і структуру даних, які може зберігати поле.
• Тип інтерфейсу (Field interface): це тип елемента керування, який використовується в інтерфейсі користувача для відображення та введення значень поля.

PostgreSQL	MySQL/MariaDB	Тип даних NocoBase	Тип інтерфейсу 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	-	-	-

#Непідтримувані типи полів

Непідтримувані типи полів відображаються окремо. Ці поля можна буде використовувати лише після їх адаптації розробниками.

#Ключ цільового фільтра

Колекції, що відображаються як блоки, повинні мати налаштований ключ цільового фільтра (Filter target key). Ключ цільового фільтра використовується для фільтрації даних за певним полем, і значення поля має бути унікальним. За замовчуванням ключ цільового фільтра є полем первинного ключа колекції. Якщо це представлення, колекція без первинного ключа або колекція зі складеним первинним ключем, вам потрібно визначити власний ключ цільового фільтра.

Лише колекції, для яких налаштовано ключ цільового фільтра, можуть бути додані на сторінку.