#Внешняя база данных

#Введение

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

#Инструкции по использованию

#Добавление внешней базы данных

После активации плагина вы сможете выбрать и добавить внешнюю базу данных из выпадающего меню «Add new» в разделе управления источниками данных.

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

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

После установления соединения с внешней базой данных NocoBase автоматически прочитает все коллекции из источника данных. Внешние базы данных не поддерживают прямое добавление коллекций или изменение их структуры. Если вам нужно внести изменения, сделайте это через клиент базы данных, а затем нажмите кнопку «Обновить» в интерфейсе NocoBase для синхронизации.

#Настройка полей

Внешняя база данных автоматически прочитает и отобразит поля существующих коллекций. Вы сможете быстро просмотреть и настроить заголовок поля, его тип данных (Field type) и тип пользовательского интерфейса (Field interface). Также вы можете нажать кнопку «Редактировать», чтобы изменить дополнительные параметры.

Поскольку внешние базы данных не поддерживают изменение структуры коллекций, при добавлении нового поля доступен только тип «связанное поле» (association field). Связанные поля не являются реальными полями в базе данных, они используются для установления связей между коллекциями.

Более подробную информацию вы найдете в разделе Поля коллекции/Обзор.

#Сопоставление типов полей

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). Ключ для фильтрации используется для отбора данных по определенному полю, при этом значение поля должно быть уникальным. По умолчанию ключом для фильтрации является поле первичного ключа коллекции. Если это представление, коллекция без первичного ключа или коллекция с составным первичным ключом, вам потребуется определить собственный ключ для фильтрации.

Только коллекции с настроенным ключом для фильтрации могут быть добавлены на страницу.