SQL

Общее описание

Компонент SQL позволяет работать с базами данных, используя запросы JDBC. Разница между этим компонентом и компонентом JDBC заключается в том, что в случае SQL запрос является свойством конечной точки и использует полезную нагрузку сообщения в качестве параметров, передаваемых запросу.

Блок SQL может использоваться в качестве:

• блока отправителя

• блока получателя.

Настройка блока

В данном разделе описаны параметры блока SQL, которые необходимо заполнить при его настройке.

Базовые параметры

Название в UI	Название атрибута	Описание	Значение по умолчанию	Тип данных
Dynamic Endpoint	dynamicEndpoint	Доступен только для блоков-отправителей. Параметр позволяет включить встроенную функциональность динамического определения вызываемоой конечной точки. При включении параметра структура блока меняется таким образом, что в коде вместо определения to проставляется toD, а значение самого вызываемого ресурса может собираться из переменной, например ${header.foo}.	False	Логическое значение
Pattern	pattern	Доступен только для блоков-отправителей. Устанавливает стиль взаимодействия с присоединенной частью потока. Возможные значения: InOnly — отправить без подтверждения приемки. При выборе в отправленном yaml и в режиме просмотра кода будет виден параметр pattern на том же уровне, что и uri. InОut — ждать подтверждения после отправки.		Список
Query	query	Обязательный параметр Исполняемый запрос. Этот запрос имеет приоритет над запросом, указанным в URI конечной точки.		Текст
Connection	connection	Этот параметр позволяет выбрать предсозданное подключение к БД или создать новое с помощью визарда Connection Manager.		Список
Allow Named Parameters	allowNamedParameters	Определяет следует ли разрешать использование именованных параметров в запросах.	True	Логическое значение
Output Class	outputClass	Задает полный пакет и имя класса для использования в качестве преобразования, если значение Output Type – SelecTone.		Строка
Output Header	outputHeader	Позволяет сохранить результат запроса в заголовке, а не в тексте сообщения. По умолчанию значение outputHeader == null и результат запроса сохраняется в тексте сообщения, весь уже существующий контент в тексте сообщения сбрасывается. Если задан параметр Output Header, то это значение используется в качестве имени заголовка для хранения результата запроса, а исходное тело сообщения сохраняется.		Строка
Output Type	outputType	Позволяет преобразовать выходные данные получателя или отправителя в SelectList как список карт соответствий (Map), или SelecTone как отдельный объект Java следующим образом: Если запрос содержит только один столбец, то возвращается этот объект столбца JDBC. (например, SELECT COUNT( ) FROM PROJECT вернет объект Long. Если запрос содержит более одного столбца, то он вернет отображение этого результата. Если задан Output Class, то он преобразует результат запроса в объект Java bean, вызывая все сеттеры, соответствующие именам столбцов. Предполагается, что у вашего класса есть конструктор по умолчанию для создания экземпляра. Если в результате запроса получено более одной строки, генерируется исключение Non-unique. StreamList передает результат запроса с помощью итератора. Это можно использовать вместе с блоком Split блоке в потоковом режиме для обработки результирующего набора в потоковом режиме. Возможные значения SelectList SelectOne StreamList		Список
Separator	separator	Разделитель, который используется при определении значений параметров, которые находятся в теле сообщения, берется из текста сообщения (если тело сообщения имеет строковый тип. Примечание: Обратите внимание, что если вы используете именованные параметры, то вместо них используется тип Map. Значение по умолчанию - запятая.	,	Строка
Batch	batch	Включает или отключает пакетный режим.	False	Логическое значение
Noop	noop	Определяет то, что результаты SQL-запроса будут игнорироваться и в качестве выходного сообщения для продолжения обработки будет использоваться входное сообщение.	False	Логическое значение
Use Message Body For Sql	useMessageBodyForSql	Определяет следует ли использовать текст сообщения в качестве SQL, а затем заголовки в качестве параметров. Если эта опция включена, то SQL в uri не используется. Обратите внимание, что параметры запроса в тексте сообщения представлены вопросительным знаком вместо символа #.	False	Логическое значение
Backoff Error Threshold	backoffErrorThreshold	Количество последовательно полученных ошибок обработки, после которого включится режим пропуска запусков.		Целое число
Backoff Idle Threshold	backoffIdleThreshold	Количество последовательных запросов, которые не привели к созданию или обработке данных. После достижения установленного количества включится режим пропуска запусков.		Целое число
Backoff Multiplier	backoffMultiplier	Позволяет обработчику по расписанию включать режим пропуска запусков при достижении числа последовательных пустых запросов/ошибок. Этот параметр определяет количество запусков, которые будут пропущены. Когда используется этот параметр, также необходимо сконфигурировать backoffIdleThreshold и/или backoffErrorThreshold.		Целое число
Delay	delay	Количество миллисекунд перед следующим запуском.	500	Длинное целое число
Greedy	greedy	Если значение параметра установлено в True, то ScheduledPollConsumer запустится сразу же после того как предыдущий запуск обработал одно или несколько сообщений.	False	Логическое значение
Initial Delay	initialDelay	Количество миллисекунд до первого запуска.	1000	Длинное целое число
Repeat Count	repeatCount	Определяет максимальное количество срабатываний. Таким образом, если вы установите значение 1, планировщик сработает только один раз. Если вы установите значение 5, он сработает только пять раз. Нулевое или отрицательное значение означает, что срабатывание происходит постоянно.	0	Целочисленное значение
Run Logging Level	runLoggingLevel	Задает уровень логирования старта и финиша инициации потока. Возможные значения: TRACE DEBUG INFO WARN ERROR OFF		Список
Scheduled Executor Service	scheduledExecutorService	Позволяет настроить пользовательский / общий пул потоков для получателя. По умолчанию у каждого получателя есть свой собственный однопоточный пул потоков.
Scheduler	scheduler	Позволяет использовать cron-планировщик из компонента camel-spring или camel-quartz. Используйте value spring или quartz для встроенного планировщика.	none	Строка
Scheduler Properties	schedulerProperties	Применяется для настройки дополнительных свойств планировщика		Строка
Start Scheduler	startScheduler	Определяет будет ли планировщик автоматически запускаться.	True	Логическое значение
Time Unit	timeUnit	Задает единицы измерения времени для параметров Initial Delay и Delay. Возможные значения: Nanoseconds Microseconds Milliseconds Seconds Minutes Hours Days	Milliseconds	Список
Use Fixed Delay	useFixedDelay	Определяет, используется ли фиксированная задержка или фиксированная скорость.	True	Логическое значение

Расширенные параметры

Название в UI	Название атрибута	Описание	Значение по умолчанию	Тип данных
Lazy Start Producer	lazyStartProducer	Определяет должен ли отправитель стартовать в отложенном режиме (при получении первого сообщения). Отложенный запуск можно использовать в ситуациях, когда запуск отправителя может завершиться неудачей и привести к сбою при запуске маршрута. Если отложить запуск, то сбой при запуске можно будет обработать во время маршрутизации сообщений с помощью обработчиков ошибок маршрутизации. Примечание: При обработке первого сообщения создание и старт отправителя могут занять некоторое время и увеличить общее время обработки.	False	Логическое значение
Always Populate Statement	alwaysPopulateStatement	Если опция включена, то всегда вызывается метод populateStatement, включая случаи, когда нет ожидаемых параметров, которые нужно подготовить. Если это значение равно false, то populateStatement вызывается только в том случае, если необходимо задать 1 или более ожидаемых параметров; например, это позволяет избежать чтения тела сообщения/заголовков для SQL-запросов без параметров.	False	Логическое значение
Parameters Count	parametersCount	Если значение этого параметра больше нуля, то это значение будет использоваться для замены параметров вместо запроса через JDBC metadata API. Это полезно, если поставщик JDBC не смог вернуть правильное количество параметров, тогда пользователь может переопределить его.		Целочисленное значение
Placeholder	placeholder	Задает символ, который будет заменяться в SQL-запросе. Примечание: Это простая операция String.replaceAll() и синтаксический анализ SQL не требуется (строки, заключенные в кавычки, также изменятся).	#	Строка
Prepare Statement Strategy	prepareStatementStrategy	Позволяет плагину использовать пользовательскую стратегию org.apache.camel.component.sql.SqlPrepareStatementStrategy для управления подготовкой запроса и подготовленным заявлением.		Строка
Row Mapper Factory	rowMapperFactory	Интерфейс, который определяет метод для сопоставления каждой строки результирующего набора (ResultSet) с соответствующим объектом Java.		Строка
Template Options	templateOptions	Настраивает Spring JdbcTemplate с помощью пар ключ/значение из карты (Map).		Строка
Use Placeholder	usePlaceholder	Определяет, следует ли использовать заполнитель и заменять все символы-заполнители предназначенными значениями в SQL-запросах.	True	Логическое значение