База данных

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

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

../../_images/image87.png

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

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

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

  • PostgreSQL 15.1 и выше.

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

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

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

  • MSSQL

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

  • PostgreSQL

  • Oracle

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

  • Сервер

  • Экземпляр

  • Порт

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

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

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

Примечание

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

Редактирование конфигурации

Для перехода в режим редактора конфигурации нажмите на соответствующую кнопку:

../../_images/image802.png

Внимание

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

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

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

../../_images/config_apply1.png

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

Важно

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