Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Выполнить

...

запрос Версия 11 (Java)

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

...

Описание

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

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

Image Removed

Параметры

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

Контекст БД                       Контекст подключения к выбранной базе данных

Шаблон запроса               – Текст запроса, который будет выполняться

Список параметров          – Параметры, которые будут подставляться в шаблон запроса

С заголовком                    – Логическая переменная, если значение которой «true», строка с заголовком таблицы будет выделена отдельно и не будет входить в строки с содержимым таблицы

Убрать дубли заголовка  – Логическая переменная, если значении которой «true», в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы

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

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

Настройки

Image Added

Параметры и их настройки

Свойство

Описание

Тип

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

Обязательность заполнения поля

Параметры

Контекст БД

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

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". 

Реализация

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

Результат

Программный робот отработал успешно.
Image Modified
Данные из базы получены и записаны в таблицу CSV.
 
Image Modified