Перейти к содержанию

Oracle

Чтобы добавить подключение к базе данных, нажмите шестерёнку в правом верхнем углу и перейдите в Управление > Базы данных > Добавить базу данных.

Настройки

Вы можете редактировать эти настройки в любое время. Просто не забудьте сохранить ваши изменения.

Название

Название для отображения базы данных в интерфейсе Glarus BI.

Хост

IP-адрес базы данных или её доменное имя (например, esc.mydatabase.com).

Порт

Порт базы данных. Например, 1521.

Oracle system ID (SID)

Обычно что-то вроде ORCL или XE. Необязательно, если используется название службы.

Название службы Oracle

Опциональный псевдоним TNS.

Имя пользователя

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

Пароль

Пароль для подключения к базе данных.

Использовать защищённое соединение (SSL)

Вы можете использовать как аутентификацию клиента, так и сервера (известную как взаимная аутентификация).

Подключение к автономной базе данных Oracle Cloud

Если вы настроили свою базу данных так, чтобы она требовала взаимный TLS (mTLS), вам понадобится кошелёк. Чтобы загрузить кошелёк:

  1. Перейдите в автономную базу данных Oracle.
  2. Перейдите к деталям базы данных.
  3. Нажмите на DB connection.
  4. Загрузите кошелёк.
  5. Создайте пароль для файла ключей.
  6. Скопируйте файл keystore.jks туда, где вы храните данные конфигурации Glarus BI.
  7. Используйте JAVA_OPTS, чтобы Glarus BI знал о расположении и пароле хранилища ключей (для получения дополнительной информации о хранилищах ключей см. следующий раздел).
  8. В Glarus BI на странице подключения данных введите host, port и service_name. Вы можете найти эти значения в файле tsnnames.ora.

Аутентификация клиента с помощью хранилища ключей

Чтобы настроить сервер (сервер Oracle) для аутентификации личности клиента (Glarus BI), вам необходимо настроить файл хранилища ключей, который включает закрытый ключ клиента.

Вы импортируете закрытый ключ клиента в хранилище ключей (а не root CA в файл хранилища доверенных сертификатов). Добавьте следующие параметры JVM для Glarus BI:

-Djavax.net.ssl.keyStore=/path/to/keystore.jks
-Djavax.net.ssl.keyStoreType=JKS \
-Djavax.net.ssl.keyStorePassword=<keyStorePassword>

Вы можете определить их с помощью переменной среды JAVA_OPTS, например:

JAVA_OPTS: "-Djavax.net.ssl.keyStore=/scripts/keystore.jks -Djavax.net.ssl.keyStoreType=JKS -Djavax.net.ssl.keyStorePassword=<keyStorePassword>"

После этого при попытке подключения через SSL сервер Oracle будет аутентифицировать Glarus BI, используя закрытый ключ.

Аутентификация сервера с хранилищем доверенных сертификатов

Чтобы настроить клиент (Glarus BI) для аутентификации сервера (сервера Oracle), вам может потребоваться настроить файл хранилища доверенных сертификатов, который включает root CA сервера, чтобы JVM, работающая с Glarus BI, доверяла цепочке сертификатов. Обратитесь к документации Oracle по использованию keytool для управления файлами ключей и доверенных сертификатов, импортом сертификатов и т.д.

Дополнительные сведения о настройке хранилища доверенных сертификатов для экземпляров Oracle AWS RDS см. в инструкциях, предоставленных Amazon.

Если вам необходимо подключиться к другим базам данных с помощью SSL, вместо создания нового хранилища доверенных сертификатов вы, вероятно, захотите добавить RDS CA в существующий файл хранилища доверенных сертификатов (вероятно, называемый cacerts).

Поддерживаемые версии базы данных Oracle и драйвера Oracle

  • Версия драйвера: минимальная версия драйвера Oracle должна быть 19c, независимо от того, какая версия Java или версия базы данных Oracle у вас установлена.
  • Версия базы данных: минимальная версия базы данных должна быть версии 19c, поскольку Oracle больше не поддерживает версии базы данных до 19.

Загрузка JAR-файла JDBC-драйвера Oracle

Вы можете загрузить JDBC-драйвер со страницы загрузок JDBC-драйвера Oracle.

Мы рекомендуем использовать JAR-файл ojdbc8.jar.

Добавление JAR-файла JDBC-драйвера Oracle в каталог плагинов Glarus BI

В вашем каталоге Glarus BI (каталог, в котором вы храните и запускаете glarus-bi.jar), создайте каталог с именем plugins (если он ещё не существует).

Переместите только что загруженный JAR-файл (ojdbc8.jar) в каталог плагинов и перезапустите Glarus BI. Glarus BI автоматически сделает драйвер Oracle доступным при повторном запуске.

При запуске из JAR

По умолчанию каталог плагинов называется plugins и находится в том же каталоге, что и JAR-файл Glarus BI.

Например, если вы запускаете Glarus BI из каталога /app/, вы должны переместить JAR-файл JDBC-драйвера Oracle в /app/plugins/:

# пример структуры каталога для запуска Glarus BI с поддержкой Oracle
/app/glarus-bi.jar
/app/plugins/ojdbc8.jar

При запуске из Docker

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

Дополнительная информация