Выполнить запрос Версия 10 (Java)

Группа действий: Базы данных

Описание

Выполняет запрос на получение данных из таблицы.

Иконка действия

Параметры

Входные параметры

Контекст БД – Контекст подключения к выбранной базе данных.
Шаблон запроса – Текст запроса, который будет выполняться.
Список параметров – Параметры, которые будут подставляться в шаблон запроса.
С заголовком – Логическая переменная, если значение которой «true», строка с заголовком таблицы будет выделена отдельно и не будет входить в строки с содержимым таблицы.
Убрать дубли заголовка – Логическая переменная, если значении которой «true», в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы.

Выходные параметры

В результате получаем результирующую таблицу работы запроса

Настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст БД	Контекст подключения к выбранной базе данных	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".
Запустить робота по кнопке "Старт" в верхней панели.