Выполнить запрос к базе данных (DB Execute)

Блок сценария DB Execute выполняет инструкции SQL в указанной базе данных. С его помощью можно обмениваться данными между сценариями.

Блок сценария DB Execute в Конструкторе сценариев

Условные выходы

Блок DB Execute может использовать условные выходы Failed и No Data.

Ошибка

При выполнении инструкции SQL произошла ошибка. Подробности ошибки не предоставляются.

Нет данных

Инструкция SELECT выполнена успешно, но не вернула ни одной записи.

Условные выходы блока DB Execute

Настройки

Текст заголовка

Текст заголовка — название экземпляра блока. Введите его в текстовое поле и нажмите Update внизу панели Edit. Новое название появится на схеме.

Соединение с базой данных

Соединение с базой данных задает нужное подключение к базе данных. Подробности см. в описании остальных параметров.

Название

Имя подключения к базе данных, отображаемое в меню выбора подключения блока DB Execute. Если список пуст, нажмите Управление подключениями к БД (Manage DB connections), чтобы добавить подключения.

Драйвер JDBC и строка соединения

Укажите драйвер JDBC и строку подключения для доступа к базе данных. Для некоторых распространенных СУБД предусмотрены шаблоны.

Имя пользователя и пароль базы данных

Укажите учетные данные для доступа к базе данных.

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

  • Добавить новое подключение (кнопка Добавить новый).
  • Изменить и сохранить выбранное подключение (кнопка Сохранить).
  • Удалить выбранное подключение (кнопка Удалить).
  • Выбрать подключение для блока DB Execute (кнопка Выбрать).
  • Сбросить выбранное подключение блока DB Execute (кнопка Ничего не выбирать (Select None)).
  • Закрыть окно без изменения подключения блока DB Execute (кнопка Закрыть).

SQL-запрос

Инструкция SQL для выполнения. В ней можно использовать переменные сценария. Например: SELECT id, name FROM customers WHERE phone=’$(item.from)’

Имя набора записей

Для инструкций SELECT укажите имя полученного набора записей. Это позволяет использовать в сценарии несколько наборов и выбирать нужный для перебора.

  • Столбцы первой полученной записи, если она есть, сохраняются в переменные сценария <recordset_name>.<column_name> (например, RS.id).
  • Количество возвращенных записей сохраняется в переменной <recordset_name>.__count__ (например, RS.__count__). Обратите внимание на двойные подчеркивания до и после count: они уменьшают вероятность совпадения имени переменной с именем столбца в наборе записей.
  • Для перебора набора записей используйте блок Получить следующую запись (Get Next Record).
  • Полученный набор ограничен 25 записями.

Подключение к базе данных выбирается из списка. Нажмите кнопку Управление подключениями к БД (Manage DB connections). Во всплывающем окне будут показаны все подключения к базам данных, определенные в этом сценарии. Для каждого подключения нужно задать следующие данные:

Настройки блока DB Execute в Конструкторе сценариев

|