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

Введение

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

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

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

После активации плагина можно выбрать и добавить его через выпадающее меню "Добавить" в управлении источниками данных.

20240507204316

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

20240507204820

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

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

20240507204725

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

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

20240507210537

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

20240507220140

Подробнее см. раздел Поля коллекции / Обзор.

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

NocoBase автоматически сопоставляет типы полей внешней базы данных с соответствующим типом данных и типом интерфейса.

  • Тип данных: определяет вид, формат и структуру данных, которые поле может хранить.
  • Тип интерфейса: определяет тип элемента управления в пользовательском интерфейсе для отображения и ввода значений поля.
PostgreSQLMySQL/MariaDBТип данных NocoBaseТип интерфейса NocoBase
BOOLEANBOOLEAN
TINYINT(1)
логическийчекбокс
переключатель
SMALLINT
INTEGER
SERIAL
SMALLSERIAL
TINYINT
SMALLINT
MEDIUMINT
INTEGER
целое число
логический
сортировка
целое число
сортировка
чекбокс
переключатель
одиночный выбор
группа радиокнопок
BIGINT
BIGSERIAL
BIGINTбольшое целое число
сортировка
целое число
сортировка
чекбокс
переключатель
одиночный выбор
группа радиокнопок
Unix-временная метка
дата создания
дата последнего обновления
REALFLOATчисло с плавающей точкойчисло
процент
DOUBLE PRECISIONDOUBLE PRECISIONчисло двойной точностичисло
процент
DECIMAL
NUMERIC
DECIMALдесятичное числочисло
процент
валюта
VARCHAR
CHAR
VARCHAR
CHAR
строка
пароль
UUID
Nano ID
однострочный текст
электронная почта
телефон
пароль
цвет
иконка
одиночный выбор
группа радиокнопок
UUID
Nano ID
TEXTTEXT
TINYTEXT
MEDIUMTEXT
LONGTEXT
длинный текст
JSON
многострочный текст
Markdown
Markdown (Vditor)
форматированный текст
URL-адрес
JSON
UUID-UUIDUUID
JSON
JSONB
JSONJSONJSON
TIMESTAMPDATETIME
TIMESTAMP
дата и времядата и время
время
дата создания
дата последнего обновления
DATEDATEдата (без времени)дата и время
TIMETIMEвремявремя
-YEARдата и время
CIRCLEокружностьJSON
окружность
PATH
GEOMETRY(LINESTRING)
LINESTRINGлинияJSON
линия
POINT
GEOMETRY(POINT)
POINTточкаJSON
точка
POLYGON
GEOMETRY(POLYGON)
POLYGONмногоугольникJSON
многоугольник
GEOMETRYGEOMETRY--
BLOBBLOBblob (большой двоичный объект)-
ENUMENUMперечислениеодиночный выбор
группа радиокнопок
ARRAY-массивмножественный выбор
группа чекбоксов
BITBIT--
SETSETнабормножественный выбор
группа чекбоксов
RANGE---

Неподдерживаемые типы полей

Неподдерживаемые типы полей отображаются отдельно. Такие поля требуют доработки перед использованием.

20240507221854

Целевой ключ фильтра

Коллекции, отображаемые как блоки, должны иметь настроенный целевой ключ фильтра. Он используется для фильтрации данных по конкретному полю, и значение этого поля должно быть уникальным. По умолчанию целевой ключ фильтра — поле первичного ключа коллекции. Для представлений, коллекций без первичного ключа или коллекций с составным первичным ключом нужно определить пользовательский целевой ключ фильтра.

20240507210230

На страницу можно добавить только коллекции, в которых настроен целевой ключ фильтра.

20240507222827