Перейти к основному содержимому

Коннекторы источников данных

Источники данных​

Коннектор — это сохранённое подключение к источнику. Из него в проект попадают таблицы, с которыми потом работает скрипт загрузки. На этой странице разобраны три типа из окна «Создать подключение»:

  • файл — выгрузка, которую можно положить в хранилище Fastboard;
  • база данных — прямое подключение к СУБД;
  • REST API — один HTTP-запрос к внешней системе.

Для базы данных подготовьте адрес сервера, имя базы, логин и пароль. Для файла — сам файл на компьютере или уже лежащий на сервере. Для REST API — адрес, который отдаёт данные одним запросом.

Отдельный тип «Битрикс24» настраивается своим сценарием: Создание подключения «Битрикс24».

к сведению

Убедитесь что у вас есть доступ к диспетчеру данных. Роли «Зритель» и «Аналитик» этот раздел не открывают.

Как открыть диспетчер​

  1. В конструкторе проекта нажмите иконку базы данных в правом верхнем углу. Снимок экрана 2025-12-10 в 00.56.25 2 (2).png
  2. Откроется диспетчер данных. Слева — список «Подключения». Справа переключаются разделы «Скрипт загрузки», «Модель данных» и «Дата-каталог».
  3. Чтобы вернуться в конструктор, нажмите иконку монитора в том же правом верхнем углу.

Frame 495.png

Список подключений разделён на две секции:

  • «В проекте» — источники, данные которых уже используются в этом проекте;
  • «Все подключения» — все источники, доступные Вам.

Создание подключения​

  1. Откройте раздел «Скрипт загрузки».

Frame 496.png

  1. Внизу списка подключений слева нажмите «Создать подключение».
  2. В окне выберите тип источника и заполните его параметры.

Снимок экрана 2026-10-07 в 01.44.51.png

  1. Сохраните подключение. В списке появится источник с указанным названием.

Поле «Описание» есть в окнах создания и редактирования, после параметров доступа. Текст необязателен, не длиннее 1000 символов; высоту поля можно потянуть за нижний край. Если описание заполнено, оно сохраняется вместе с подключением и попадает на вкладку «Подключения» каталога данных, пока Вы не измените этот текст уже в каталоге. После ручной правки в каталоге связь с полем подключения для этого источника прерывается. Пустое описание можно сохранить: тогда текст очистится, остальные параметры подключения при этом не меняются.

к сведению

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

Файловые источники​

Файл нужен, когда данные приходят готовой выгрузкой. Формат определяется автоматически для CSV, TXT, JSON, XLS/XLSX и XML. Файл с другим расширением загружается, если внутри у него структура одного из этих форматов: тогда формат выбирается вручную.

  1. В окне создания подключения выберите тип «Файл».
  2. Задайте «Название подключения».
  3. Выберите расположение:
    • «Загрузить» — файл с Вашего компьютера. По умолчанию действует ограничение 25 МБ; размер меняется в настройках системы. Папка загрузки на сервере: /fastboard/upload;
    • «С сервера» — файл из папки Upload на сервере. Так загружают файл любого размера, если его заранее положили на сервер.
  4. При необходимости включите «Все файлы в папке». Тогда доступен только вариант «С сервера», формат выбирается вручную, а в загрузку попадают все файлы этого формата из папки. Появляется поле маски имени: если маска задана, берутся только подходящие файлы.
  5. Включите «Автообновление», если хранилище Fastboard должно само перечитывать файл или файлы после изменения на сервере.
  6. Нажмите «Создать». Начнётся загрузка в хранилище Fastboard. Новый источник появится в списке подключений, и из него можно выбирать данные для проектов.

Базы данных​

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

  1. В окне создания подключения выберите тип базы данных.
  2. Заполните параметры:
ПолеЧто указать
«Название подключения»Имя источника в списке. Задаёте сами
«СУБД»ClickHouse, PostgreSQL, MS SQL, Oracle или MySQL
«Хост»Адрес сервера
«Порт»Порт СУБД
«База данных»Имя базы
«Логин» и «Пароль»Учётная запись для подключения

Для ClickHouse дополнительно выбирается схема HTTP или HTTPS. Для Oracle укажите формат даты: у разных экземпляров он отличается. К Greenplum подключаются тем же типом PostgreSQL.

  1. Нажмите «Проверить соединение». При успехе появится зелёное уведомление. Если соединение не установлено, появится предупреждение: поправьте параметры и проверьте снова.
  2. Нажмите «Создать», чтобы сохранить подключение.

REST API​

Коннектор REST API забирает данные внешней системы одним HTTP-запросом: по адресу, методу и параметрам одного вызова.

  1. В окне создания подключения выберите «REST API». Откроется окно «Создание подключения».
  2. Заполните обязательные поля. Пока они пустые, подключение не создаётся, а под полем появляется «Поле не может быть пустым!».
    • «Название источника» — имя в списке подключений. Допустимы латинские буквы, цифры и символы * / . - = _ < > ^ % & ! ? @ ' " : ; #. Другие символы дают ошибку «Поле содержит некорректные символы».
    • «URL» — адрес API.
  3. Выберите метод GET или POST. GET получает данные по адресу и параметрам. POST передаёт тело запроса.
  4. Настройте запрос на вкладках:
    • «Params» — пары «Ключ» и «Значение». Новая строка добавляется кнопкой «Добавить».
    • «Authorization» — тип авторизации:
      • «No auth» — без авторизации, дополнительных полей нет;
      • «Basic» — «Имя пользователя» и «Пароль»;
      • «Bearer token» — поле «Токен»;
      • «API Key» — «Ключ» и «Значение».
    • «Headers» — пары «Ключ» и «Значение», новые строки кнопкой «Добавить».
    • «Body» — только для POST. Либо пары ключ/значение (form-data), либо многострочное поле raw.
  5. Укажите «Формат получаемого ответа»: JSON, CSV или XML. Для CSV появляются чекбокс «Включать заголовки» и поле «Разделитель».
  6. При необходимости измените «Timeout». По умолчанию стоит 120 секунд.
  7. Включите «Автообновление», если подключение должно обновляться само.
  8. Нажмите «Тест соединения» и убедитесь, что API отвечает.
  9. Нажмите «Создать».

«Назад» возвращает к выбору типа источника. Введённые параметры при этом не сохраняются.

Удаление коннектора​

Удаление из проекта и удаление самого подключения — разные действия.

Убрать данные из проекта​

В списке действий источника (три точки) выберите «Удалить данные из проекта». Из скрипта загрузки уйдут данные этого источника. Затем запустите скрипт, чтобы проект обновился. Таблицы удалённого источника уберите в разделе «Модель данных»: после этого коннектор больше не числится в секции «В проекте».

Frame 497.png

Удалить подключение из системы​

Это доступно при праве «Управление». Откройте окно редактирования коннектора «Изменить параметры», оно вызывается через меню три точки. В открывшемся окне найдите и нажмите кнопку «Удалить подключение».

Frame 498 (1).png

Frame 499.png

Доступ к коннекторам​

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

У каждого коннектора две таблицы прав:

ПравоЧто можно
«Управление»

Видеть источник в общем списке, использовать его в проектах, менять параметры, удалять подключение и выдавать доступ другим

«Использование»

Видеть источник в общем списке и использовать его в своих проектах

Связанные материалы​