Настройка подключений FineBI к базам данных
В данном материале вы узнаете, как можно настроить подключение к базам данных при помощи коннекторов, а также сторонним базам при помощи JDBC подключения в системе FineBI, а также узнаете, как добавлять новые драйвера баз данных.
Подключение к базам данных из списка предложенных по умолчанию
Некоторые базы данных в FineBI имеют коннекторы по умолчанию. Драйверы для этих баз уже имеются в системе, поэтому все, что нужно для работы с ними – заполнить соответствующую информацию в форме подключения.
Чтобы подключиться к базе необходимо перейти во вкладку «Manage» > «Data Connection» > «Data Connection Management» и кликнуть на кнопку «New Data Connection».
Далее нужно выбрать базу с источниками данных Fine BI из списка предложенных. Алгоритм действий в случае, если вашей базы нет в этом списке – описан в п. 4 статьи.
На текущем этапе нужно ввести информацию для подключения к базе данных, а именно:
- Host (адрес сервера базы данных)
- Port (порт сервера базы данных)
- Database Name (имя базы данных)
- User login (имя пользователя подключения)
- Password (пароль пользователя подключения)
После ввода учетных данных, кликните на кнопку «Test Connection» в правом верхнем углу для проверки установления подключения к базе данных.
В случае, если учетные данные введены корректно и подходящий драйвер имеется в FineBI – вы увидите значок зеленой галочки и надпись об успешном подключении к базе «Connection Successful».
Если вы видите сообщение «Test connection failed», то вам необходимо проверить корректность введенных учетных данных, или при необходимости скачать недостающие драйвера выбранной базы данных.
Иногда, часть драйверов может не загрузиться по умолчанию, поэтому для решения данной проблемы следует зайти на сайт официальной документации FineBI и найти драйвер или в магазин плагинов FanRuan и найти плагин с драйвером или сам драйвер.
Документация: https://help.fanruan.com/finebi/doc-view-290.html
Магазин плагинов: https://market.fanruan.com/
Плагин (с драйвером) поставляется архивированным файлом, который не нужно распаковывать. Для установки необходимо зайти во вкладку «Manage» > «Plugin», нажать на кнопку «Local install».
Если всё прошло успешно, то можно подключиться к базе во вкладке «Data Connection», выбрав установленный драйвер в разделе driver при вводе учетных данных подключения.
В случае, если вы скачиваете драйвер .jar без плагина, например, с официального сайта базы данных, то вам нужно выполнить действия следующего пункта документации.
Подключение к базам данных без базовых коннекторов
1 Подготовка драйверов
В случае, если коннектора к вашей базе данных нет в FineBI по умолчанию, то необходимо:
-
Скачать архив plugin-com.fr.plugin.decision.config.visual.v11-1.9.9.zip
(для получения свяжитесь с нами) - Установить скачанный драйвер в разделе «Plugin»
- На вкладке «Manage» появится новый раздел «System Tools», перейдите в него.
- Выбрать тип значения true у параметра SystemConfig.driverUpload
- Сохранить изменения, кликнув «Save»
- Скачать драйвер для JDBC подключения в формате .jar с официального сайта поставщика базы данных
- Перейти во вкладку Driver Management в разделе data connection и создать новый драйвер и в окне выбора драйвера укажите скачанный файл .jar
Проделав эти действия, вы сможете настроить драйвер для последующего подключения к вашей базе данных систем аналитики Fine BI. Следующим пунктом, описаны необходимые для этого действия.
2 Настройка подключения OtherJDBC
Для установки подключения к базе данных, к которой нет базового коннектора, нужно воспользоваться JDBC. Перейдите на вкладку «Manage» > «Data Connection» > «Data Connection Management» и выберите «Other JDBC».
Далее перед вами откроется страница ввода учетных данных для подключения, аналогичную в п.1. Нужно отметить, что заполнение данных о Host, Port, Database name должны описываться в блоке «Data Connection URL» в качестве ссылки для установления JDBC подключения, остальные поля нужно оставить пустыми.
Пример строки URL: jdbc:sqlserver://host:port/dbname/?user=<username>&password=<password>
Кейс подключения кастомной БД на примере Exasol
Базы данных Exasol нет в списке баз по умолчанию, поэтому нужно отдельно установить драйвер и подключаться с помощью Other JDBC:
- Для начала скачиваем архив plugin-com.fr.plugin.decision.config.visual.v11-1.9.9.zip (по запросу у нас)
- Устанавливаем плагин, который хранится в скачанном архиве: Во вкладке Plugin нажимаем Local Install и выбираем скачанный архив.
- Проверьте отображение раздела «System Tools» на вкладке «Manage» системы, возможно, потребуется перезапуска сервера.
- В появившейся вкладке Manage -> System Tools устанавливаем значения true у параметра SystemConfig.driverUpload.
- После изменения данного параметра выполняем перезапуск сервера FineBI.
- На момент написания статьи плагин с драйвером для Exasol в FineBI отсутствует. Поэтому проследуем на официальный сайт Exasol и скачаем архив с JDBC драйвером Exasol: https://www.exasol.com/support/projects/DOWNLOAD/issues/DOWNLOAD-1098?filter=allissues
В архиве нас интересует файл exajdbc.jar - переносим его в каталог установки FineBI, webapps/webroot/WEB-INF/lib.
- Добавим драйвер в систему FineBI: во вкладке Manage переходим в раздел Data Connection Manage и выбираем Driver Management
Нажмем «New Driver» > «Upload File» и выбираем файл exajdbc.jar, скачанный на предыдущем шаге, сохраняем результат.
- Переходим в «Manage» >«Data Connection» > «Data Connection Manage» и нажимаем «New data Connection». Далее выбираем «Other JDBC».
- В открывшейся форме в разделе Driver необходимо выбрать «Custom» и загруженный в систему драйвер.
- Заполняем строку «Data Connection URL» в форматеjdbc:exa://host:port и вводим Database Name, Username, Password в соответствующих полях формы.
- Нажмем Test Connection, убедимся, что подключение прошло успешно, сохраняем результат по клику на «Save».
- Загружать таблицы данных из базы теперь можно в разделе «Server Dataset» с помощью выбора «SQL Dataset» во вкладке «Create Dataset».