Выполнить запрос

Выполнить запрос Версия 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".
Запустить робота по кнопке "Старт" в верхней панели.