Пользовательское подключение Версия 10 (Java)
Группа действий: Базы данных
Описание
Действие выполняет подключение к базе данных с заданными параметрами подключения.
Иконка действия
Параметры
Входные параметры
Уровень изоляции транзакций - Уровень изоляции доступа к базе во время выполнения транзакций.
Логин – Логин для подключения БД.
Пароль – Пароль для подключения БД.
URL сервера, где размещена БД– URL сервера, на котором развёрнута СУБД.
Класс драйвера для указанной базы данных – Определённое полное имя класса драйвера для указанной базы данных.
Путь к классу драйвера для указанной базы данных- Путь к драйверу для указанной базы данных.
Тайм-аут - Предельное время ожидания подключения к БД.
Выходные параметры
В результате получаем контекст подключения для работы с БД.
Настройки
Property | Description | Type | Filling example | Mandatory field |
---|---|---|---|---|
Parameters | ||||
Transaction isolation level | Isolation level of access to the database during the execution of transactions. Dropdown list: No transactions, Read uncommited, Read committed, Repeatable read, Serializable | Robin.String | No | |
Login | Login to connect the database | Robin.String | No | |
Password | Password to connect the database | Robin.Object | No | |
DB server URL | The URL of the server where the database is located. Examples: jdbc: h2: mem: h2inmem; jdbc: sqlite: C: Users User1 test.db | Robin.String | Yes | |
Driver class full name | Driver class full name | Robin.String | Yes | |
The driver classpath for the specified database | The driver classpath for the specified database | Robin.FilePath | Yes | |
Timeout | Time limit for connection creation. Further it is used as the maximum waiting time for the execution of requests in the connection. The default is 60 s. May depend on driver implementation. | Robin.Numeric | No | |
Results | ||||
DB context | Connection context to the selected database | Robin.DbContext | Database context |
Особые условия использования
Разница между пользовательским подключением стандартным подключением заключается в том, что с помощью стандартного подключения можно подключиться только к 1 из 4-х доступных БД (Oracle, MySql, PostgreSql,MsSqlServer) , с помощью пользовательского подключения можно подключиться к любой БД для которой установлен jdbc-драйвер.
Пример использования
Задача
Подключиться к базе данных и выполнить запрос
SELECT * FROM Table1
ORDER BY id ASC;
Решение
Воспользоваться действиями "Пользовательское подключение", "Выполнить запрос".
Реализация
- Собрать схему робота, состоящего из действий:
- Настроить параметры для действия "Пользовательское подключение".
Уровень изоляции транзакций - уровень разрешения чтения данных для субъекта, который подключается к БД (пользователь или система). Возможны несколько уровней изоляции транзакций:- Без транзакций
- Чтение незаконченных транзакций разрешено
- Чтение только законченных транзакций
- Повторное чтение данных вернет те же значения, что и в начале транзакции
- Сериализуемость
Чтение только законченных транзакций - роботу можно будет читать только зафиксированные записи.
Повторное чтение данных вернет те же значения, что и в начале транзакции - роботу можно будет читать только зафиксированные записи. Данные, которые робот читает в данный момент, другой субъект не сможет изменить, пока не закончится транзакция робота.
Сериализуемость - роботу можно будет читать только зафиксированные записи. Данные, которые робот читает в данный момент, другой субъект не сможет изменить и/или прочитать, пока не закончится транзакция робота. - Указать логин и пароль от БД.
В поле "URL сервера, где размещена БД" указать URL подключения к требуемой БД. Все дополнительные параметры необходимо указывать в URL сервера.
При использовании пользовательского подключения обязательно должен быть скачан драйвер для БД. Файл драйвера должен находится на той же машине, где работает программный робот. С помощью этого драйвера робот будет подключаться к базе.
В поле "Класс драйвера для указанной базы данных" необходимо указать имя класса драйвера. Узнать его можно в интернете, т.е посмотреть название драйвера под используемую БД. Соответственно, для каждого вида СУБД название класса драйвера будет свое.
В поле "Путь к классу драйвера для указанной базы данных" указать путь до файла драйвера, с помощью которого будет происходить подключение. Например:
Значение в поле "Таймаут" измеряется в секундах. - Настроить параметры для действия "Выполнить запрос".
- Нажать на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Запрос выполнен.