Выполнить запрос Версия 11 (Java)
Группа действий: Базы данных
Описание
Выполняет запрос на получение данных из таблицы
Иконка действия
Параметры и их настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|
Параметры |
|---|
Контекст БД | Контекст подключения к выбранной базе данных | Robin.DbContext | Контекст баз данных | Да |
Шаблон запроса | Шаблон запроса | Robin.String |
| Да |
Список параметров | Коллекция значений параметров для подстановки в запрос | Robin.Collection |
| Нет |
С заголовком | Если значение «true», строка с заголовком таблицы будет выделена отдельно и не будет входить в строки с содержимым таблицы | Robin.Boolean | true | Нет |
Убрать дубли заголовка | При значении «true», в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1 | Robin.Boolean | true | Нет |
| Результаты |
|---|
Результат | Результат выполнения запроса в виде таблицы. Если результатом является выборка данных, то результирующая таблица с данной выборкой данных. Если результатом является число затронутых строк, то результирующая таблица имеет один столбец „update_count“ и одну строку, содержащую число затронутых строк | Robin.DataTable |
|
|
Особые условия использования
Данное действие выполняет запрос. Для исполнения хранимых процедур используется действие Вызвать хранимую процедуру.
Параметры задаются через "Список параметров". Не следует их вставлять в тело запроса - это ведет к возникновению ошибок.
Для чекбокса "Убрать дубли":
- Есть таблица:
При "Убрать дубли заголовка" = true, и "С заголовком" = True, действие "Взять таблицу" вернет таблицу из 4х строк и 5 столбцов. Названия столбцов этой таблицы будут:
"Тест31", "Тест21", "Тест22", "Тест32", "Тест1";
- При значении "false", названия столбцов останутся прежними. Действия на net, которые возвращают\обрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов;
- Например, в исходной таблице есть столбцы "Тест1", "Тест" и "Тест". Если добавлять индексы только к текущим дублям, то названия станут такими "Тест1", "Тест1" и "Тест2", т.е. в итоге появятся новые дубли с названием "Тест1". Поэтому действие при переименовании конкретного столбца должно проверять, нет ли уже такого названия у другого столбца и при наличии таких совпадений проставлять у текущего столбца следующий по счету индекс. Т.е. в данном случае действие переименует столбцы как "Тест1", "Тест2" и "Тест3".
Пример использования
Задача
Cделать запрос к базе данных и сохранить результат в таблицу CSV. Запросить имя разработчика с ID=1.
Решение
Воспользоваться действиями "Стандартное подключение", "Выполнить запрос", "Сохранить таблицу в CSV".
Реализация
- Собрать схему робота, состоящую из действий.
- Настроить параметры для действия "Стандартное подключение".
- Настроить параметры для действия "Выполнить запрос". В поле "Контекст БД" указать контекст подключения к базе данных. В поле "Шаблон запроса" указать SQL выражение (запрашиваем имя разработчика с ID=1). Оно может содержать знаки вопросов, как в данном случае.
И тогда должно быть заполнено поле "Список параметров".
Эти параметры будут подставлены вместо знаков вопросов.
При поставлении чекбокса "С заголовком".
Чекбокс "С заголовком" не проставлен.
- Настроить параметры для действия "Сохранить таблицу в CSV".
- Запустить робота по кнопке "Старт" в верхней панели.
Результат
Программный робот отработал успешно.
Данные из базы получены и записаны в таблицу CSV.
