Добавление jdbс драйверов

Драйвера JDBC для доступа к данным

На текущий момент(версия 8) Luxms BI поставляется со следующим набором JDBC для доступа к Источникам данных:

  • PostgreSQL, v42.2.5
  • Clickhouse, v0.2.4
  • SQLserver, v7.0.0
  • Oracle, v12.2.0.1
  • Oracle, v19.9.0.0
  • Mysql, v5.1.47
  • Linter, v1.8
  • SQLite, v3.20.1
  • Olap4j, v1.1.0
  • Hive2, v3.1.2
  • Teradata, v16.20.0.13

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

Подключение дополнительных драйверов

Драйвера JDBC используются компонентами luxmsbi-importer и luxmsbi-datagate. Расположение драйверов JDBC в папках файловой системы, определяется параметром конфигурации компонента(/opt/luxmsbi/config/[Имя Компонента]/application.properties):

luxmsbi.drivers-config.location=/opt/luxmsbi/lib/jdbc

Требования к настройке драйверов JDBC:

  1. Имя папок должно соответсвовать следующим правилам: [Vendor name]_[Major version]_[Minor version],

    где Vendor name - должно совпадать с именем используемым в url, для подключения к источнику данных.

Например: /opt/luxmsbi/lib/jdbc/mysql_5_1/

  1. Каждая папка драйвера должна содержать:
  • набор JAR-файлов драйвера;
  • файл описания info.json, в формате JSON.
  1. Формат файла описания info.json, например для MariaDB:
{"vendor":"mysql","majorVersion":5,"minorVersion":1,"className":"com.mysql.jdbc.Driver","config":{}}

Элемент “config” может содержать перечень свойств, поддерживаемых конкретным драйвером, включая свойства конфигурации пула соединений, например:

  • max-pool-size;
  • timeout;
  • и прочие.
  1. Владелец и права на папку драйвера, содержащиеся в ней файлы, должны быть следующие:
[root@host ~]# ls -la /opt/luxmsbi/lib/jdbc/mysql_5_1/
total 1004
drwxrwx---.  2 bi   bi        62 Jun  2 04:00 .
drwxrwx---. 11 bi   bi     12288 Jun  1 11:05 ..
-rw-r-----.  1 bi   bi       100 Jun  1 11:04 info.json
-rw-r-----.  1 bi   bi   1007502 Jun  1 11:04 mysql-connector-java-5.1.47.jar

Добавление драйверов требует перезапуска компонентов:

sudo systemctl restart luxmsbi-datagate luxmsbi-importer