База данных

К Платформе можно подключить SQL базу данных в качестве источника сообщения и в качестве получателя.

Чтобы приступить к настройке коннектора, на вкладке Коннектор выберите тип База данных. После выбора типа коннектора станут доступны поля для ввода характеристик коннектора:

Поддерживаемые версии СУБД

Поддерживаемые версии СУБД для работы коннектора База данных:

• MSSQL Microsoft SQL Server 2017 14.0.1000.169 и выше.

• PostgreSQL 15.1 и выше.

• Oracle Database Express Edition 11g Release 2 (11.2) и выше.

Внимание

Особенности работы с версии 3.1.1.0

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

Подключение с помощью JDBC

Данный способ взаимодействия с MSSQL следует применять в случаях, когда MSSQL Server развернут внутри домена Windows и поддерживает только встроенную аутентификацию, а клиент, с которого происходит обращение, развернут вне домена Windows на Windows или Linux. Данный вид подключения позволяет подключаться без дополнительной настройки Kerberos, так как подключение осуществляется по протоколу NTLM.

Основные настройки

1. Выберите тип СУБД:

   • MSSQL

   • MSSQL (подключение с помощью JDBC)

   • PostgreSQL

   • Oracle

2. Заполните следующие поля для подключения к базе данных:

   • Сервер

   • Экземпляр

   • Порт

   • Имя базы данных

     Примечание

     Если база данных, указанная в настройках внешней системы, не существует, внешняя система зафиксирует ошибку и поменяет свой статус на Сломано.

3. Настройте параметры подключения.

   • Если подключение к базе данных будет осуществляться с использованием имени и пароля, установите соответствующий флажок в разделе Параметры авторизации и введите имя пользователя и пароль для доступа к базе данных.

     Примечание

     Для подключения к СУБД MSSQL с помощью JDBC могут быть использованы доменные аутентификационные данные. При подключении следует вводить имя пользователя в формате domain\i.ivanov, где domain - имя домена, i.ivanov - имя пользователя, для которого в настройки безопасности СУБД MSSQL добавлено имя для входа с установленной проверкой подлинности Windows, а также добавлены роли, необходимые для доступа к базам данных.

   • Если получение аутентификационных данных ожидается из сервиса Управление пользователями, установите флажок Получать пароль из модуля Credential. При этом поле Пароль станет недоступным для заполнения.

Дополнительные настройки

Дополнительные настройки производятся в режиме редактора конфигурации. Для перехода в режим редактора конфигурации используйте переключатель Режим диалога / редактора конфигурации.

Внимание

Перед переходом в режим редактора конфигурации сохраните внесенные данные!

При использовании MSSQL, PostgreSQL и Oracle поддерживается подключение с помощью указания строки подключения в параметре connectionString (параметр должен быть включен: useConnectionString: true). Использование данного параметра для MSSQL (подключение с помощью JDBС) не поддерживается. Со списком всех возможных ключей, а также примерами строк подключений можно ознакомиться на следующих сайтах:

• MS SQL: https://www.connectionstrings.com/sql-server/

• PostgreSQL: https://www.connectionstrings.com/npgsql/

• Oracle: https://www.connectionstrings.com/oracle/

После внесения данных нажмите на кнопку Сохранить изменения, после этого нажмите на кнопку Применить конфигурацию.

Для работы с системой создайте обработчики с направлением передачи В Platform или Из Platform, в зависимости от используемого бизнес-процесса.

Важно

Внешняя система с типом База данных не отправляет данные в Платформу самостоятельно. Задачу получения данных из БД или отправку в БД берет на себя обработчик. Запись данных в СУБД осуществляется в соответствии с UTC.