История страницы

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

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

...

Описание

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

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

Image Modified

Параметры

...

и их настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст БД	Контекст подключения к выбранной базе данных	Robin.DbContext	Контекст баз данных	Да
Шаблон запроса	Шаблон запроса	Robin.String		Да
Список параметров	Коллекция значений параметров для подстановки в запрос	Robin.Collection		Нет
С заголовком	Если значение «true», строка с заголовком таблицы будет выделена отдельно и не будет входить в строки с содержимым таблицы	Robin.Boolean	true	Нет
Убрать дубли заголовка	При значении «true», в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1	Robin.Boolean	true	Нет
Результаты
Результат	Результат выполнения запроса в виде таблицы. Если результатом является выборка данных, то результирующая таблица с данной выборкой данных. Если результатом является число затронутых строк, то результирующая таблица имеет один столбец „update_count“ и одну строку, содержащую число затронутых строк	Robin.DataTable

Особые условия использования

Данное действие выполняет запрос. Для исполнения хранимых процедур используется действие Вызвать хранимую процедуру.
Параметры задаются через "Список параметров". Не следует их вставлять в тело запроса - это ведет к возникновению ошибок.
Для чекбокса "Убрать дубли":

Есть таблица:
Image Modified
При "Убрать дубли заголовка" = true, и "С заголовком" = True, действие "Взять таблицу" вернет таблицу из 4х строк и 5 столбцов. Названия столбцов этой таблицы будут:
"Тест31", "Тест21", "Тест22", "Тест32", "Тест1";

При значении "false", названия столбцов останутся прежними. Действия на net, которые возвращают\обрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов;
Например, в исходной таблице есть столбцы "Тест1", "Тест" и "Тест". Если добавлять индексы только к текущим дублям, то названия станут такими "Тест1", "Тест1" и "Тест2", т.е. в итоге появятся новые дубли с названием "Тест1". Поэтому действие при переименовании конкретного столбца должно проверять, нет ли уже такого названия у другого столбца и при наличии таких совпадений проставлять у текущего столбца следующий по счету индекс. Т.е. в данном случае действие переименует столбцы как "Тест1", "Тест2" и "Тест3".

Пример использования

Задача

Cделать запрос к базе данных и сохранить результат в таблицу CSV. Запросить имя разработчика с ID=1.
Image Modified

Решение

Воспользоваться действиями "Стандартное подключение", "Выполнить запрос", "Сохранить таблицу в CSV".

Реализация

Собрать схему робота, состоящую из действий.
Image Modified
Настроить параметры для действия "Стандартное подключение".
Image Modified
Настроить параметры для действия "Выполнить запрос". В поле "Контекст БД" указать контекст подключения к базе данных. В поле "Шаблон запроса" указать SQL выражение (запрашиваем имя разработчика с ID=1). Оно может содержать знаки вопросов, как в данном случае.
Image Modified
И тогда должно быть заполнено поле "Список параметров".
Image Modified
Эти параметры будут подставлены вместо знаков вопросов.
Image Modified
При поставлении чекбокса "С заголовком".
Image Modified
Чекбокс "С заголовком" не проставлен.
Image Modified
Настроить параметры для действия "Сохранить таблицу в CSV".
Image Modified
Запустить робота по кнопке "Старт" в верхней панели.