Уведомление о переводе ИИ

Эта документация была автоматически переведена ИИ.

Подключение внешних таблиц данных (FDW)

Коллекция: подключение внешних данных (FDW)Community Edition+

Введение

Этот плагин позволяет подключаться к удалённым таблицам данных, используя технологию Foreign Data Wrapper (FDW) базы данных. В настоящее время поддерживаются базы данных MySQL и PostgreSQL.

Подключение источников данных vs. Подключение внешних таблиц данных
  • Подключение источников данных означает установление соединения с определённой базой данных или API-сервисом, что позволяет полноценно использовать все возможности базы данных или предоставляемые API услуги.
  • Подключение внешних таблиц данных подразумевает получение данных из внешнего источника и их отображение для локального использования. В контексте баз данных это называется FDW (Foreign Data Wrapper) — технология, позволяющая работать с удалёнными таблицами как с локальными. При этом подключение осуществляется для каждой таблицы отдельно. Поскольку это удалённый доступ, при использовании могут возникать различные ограничения и особенности.

Эти два подхода можно использовать в комбинации: первый — для установления соединения с источником данных, а второй — для доступа к данным из разных источников. Например, вы можете подключить источник данных PostgreSQL, в котором одна из таблиц является внешней таблицей данных, созданной с помощью FDW.

MySQL

MySQL использует движок federated, который необходимо активировать. Он поддерживает подключение к удалённым базам данных MySQL и совместимым по протоколу, таким как MariaDB. Подробную информацию вы найдёте в документации Federated Storage Engine.

PostgreSQL

В PostgreSQL различные типы расширений fdw позволяют работать с разными типами удалённых данных. В настоящее время поддерживаются следующие расширения:

  • postgres_fdw: для подключения к удалённой базе данных PostgreSQL из PostgreSQL.
  • mysql_fdw (в разработке): для подключения к удалённой базе данных MySQL из PostgreSQL.
  • Для других типов расширений FDW вы можете обратиться к PostgreSQL Foreign Data Wrappers. Для интеграции с NocoBase потребуется реализовать соответствующие адаптационные интерфейсы в коде.

Установка

Предварительные условия

Затем установите и активируйте плагин через менеджер плагинов.

Установка и активация плагина

Руководство пользователя

В разделе «Управление коллекциями > Создать коллекцию» в выпадающем списке выберите «Подключить внешние данные».

Подключить внешние данные

В выпадающем списке «Сервис базы данных» выберите существующий сервис базы данных или «Создать сервис базы данных».

Сервис базы данных

Создание сервиса базы данных

Создание сервиса базы данных

После выбора сервиса базы данных, в выпадающем списке «Удалённая таблица» выберите таблицу данных, которую вы хотите подключить.

Выбор таблицы данных для подключения

Настройка информации о полях

Наст�ройка информации о полях

Если структура удалённой таблицы изменилась, вы также можете «Синхронизировать из удалённой таблицы».

Синхронизация из удалённой таблицы

Синхронизация удалённой таблицы

Синхронизация удалённой таблицы

Наконец, отображение в интерфейсе.

Отображение в интерфейсе