61.4. 끝점 옵션


SQL 끝점은 URI 구문을 사용하여 구성됩니다.

sql:query
Copy to Clipboard Toggle word wrap

다음과 같은 경로 및 쿼리 매개변수 사용:

61.4.1. 경로 매개변수(1 매개변수)

Expand
이름설명Default유형

쿼리 (공용)

수행할 SQL 쿼리를 설정합니다. file: 또는 classpath:를 접두사로 사용하여 쿼리를 외부화하고 파일의 위치를 지정할 수 있습니다.

 

문자열

61.4.2. 쿼리 매개변수(45 매개변수)

Expand
이름설명Default유형

allowNamedParameters (common)

쿼리에 이름이 지정된 매개변수를 사용할 수 있도록 허용할지 여부입니다.

true

boolean

데이터 소스 (공용)

엔드포인트 수준에서 데이터베이스와 통신하는 데 사용할 DataSource를 설정합니다.

 

DataSource

outputClass (common)

outputType=SelectOne이 될 때 변환으로 사용할 전체 패키지와 클래스 이름을 지정합니다.

 

문자열

outputHeader (common)

메시지 본문 대신 헤더에 쿼리 결과를 저장합니다. 기본적으로 outputHeader == null 및 쿼리 결과는 메시지 본문에 저장되고 메시지 본문의 기존 콘텐츠가 삭제됩니다. outputHeader가 설정된 경우 값은 쿼리 결과를 저장하기 위해 헤더 이름으로 사용되며 원래 메시지 본문은 보존됩니다.

 

문자열

OutputType (common)

Consumer 또는 producer to SelectList as SelectList as List of Map, or SelectOne as a single Java object in the following way: a) 쿼리에 단일 열만 반환되는 경우 (예: Select Column() FROM PROJECT는 긴 오브젝트를 반환합니다. b) 쿼리에 여러 열이 있는 경우 해당 결과의 맵이 반환됩니다. c) outputClass가 설정된 경우, 그런 다음 열 이름과 일치하는 모든 setter를 호출하여 쿼리 결과를 Java kubeconfig 오브젝트로 변환합니다. 클래스에 인스턴스를 만들 수 있는 기본 생성자가 있다고 가정합니다. d) 쿼리가 두 개 이상의 행을 초래하는 경우 고유하지 않은 결과 예외가 발생합니다. StreamList는 Iterator를 사용하여 쿼리의 결과를 스트리밍합니다. 이는 스트리밍 모드에서 Splitter EIP와 함께 사용하여 스트리밍 방식으로 ResultSet을 처리할 수 있습니다.

CloudEvent 값:

  • SelectOne
  • SelectList
  • StreamList

SelectList

SqlOutputType

구분 기(common)

# 자리 표시자에 삽입하기 위해 메시지 본문(본체가 문자열 유형인 경우)에서 매개 변수 값을 가져올 때 사용할 구분 기호입니다. 이름이 지정된 매개변수를 사용하면 대신 Map 유형이 사용됩니다. 기본값은 쉼표입니다.

,

grafka

breakBatchOnConsumeFail (consumer)

onConsume에 실패한 경우 일괄 처리를 중단할지 여부를 설정합니다.

false

boolean

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

expectedUpdateCount (consumer)

onConsume를 사용할 때 유효성을 검사하도록 예상 업데이트 수를 설정합니다.

-1

int

maxMessagesPerPoll (consumer)

폴링할 최대 메시지 수를 설정합니다.

 

int

OnConsume (consumer)

각 행을 처리한 후 Exchange가 성공적으로 처리된 경우 이 쿼리를 실행할 수 있습니다. 예를 들어 행이 처리된 것으로 표시됩니다. 쿼리에 매개 변수가 있을 수 있습니다.

 

문자열

onConsumeBatchComplete (consumer)

전체 일괄 처리를 수행한 후 이 쿼리는 일괄 업데이트 행 등으로 실행될 수 있습니다.After processing the entire batch, this query can be executed to bulk update rows. 쿼리에 매개 변수가 있을 수 없습니다.

 

문자열

onConsumeFailed (consumer)

각 행을 처리한 후 교환이 실패한 경우 이 쿼리를 실행할 수 있습니다(예: 행을 실패로 표시). 쿼리에 매개 변수가 있을 수 있습니다.

 

문자열

routeEmptyResultSet (consumer)

빈 결과 집합을 다음 홉으로 보낼 수 있는지 여부를 설정합니다. 기본값은 false입니다. 따라서 빈 결과가 필터링됩니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

Transacted (consumer)

트랜잭션을 활성화하거나 비활성화합니다. 그런 다음 교환을 처리하는 데 실패한 경우 소비자는 추가 트랜잭션 처리를 중단하여 롤백을 신속하게 수행합니다.

false

boolean

UseIterator (consumer)

결과 집합을 경로로 전달해야 하는 방법을 설정합니다. 전달을 목록 또는 개별 오브젝트로 나타냅니다. 기본값은 true입니다.

true

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

processingStrategy (consumer (advanced))

사용자가 행/배치를 처리할 때 사용자 정의 org.apache.camel.component.sql.SqlProcessingStrategy를 사용하여 쿼리를 실행할 수 있습니다.

 

SqlProcessingStrategy

일괄 (producer)

배치 모드를 활성화하거나 비활성화합니다.

false

boolean

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

noop (producer)

설정된 경우 는 SQL 쿼리의 결과를 무시하고 기존 IN 메시지를 처리를 위한 OUT 메시지로 사용합니다.

false

boolean

useMessageBodyForSql (producer)

메시지 본문을 SQL으로 사용할지 여부 및 매개 변수의 헤더입니다. 이 옵션을 사용하면 uri의 SQL이 사용되지 않습니다. 메시지 본문의 쿼리 매개변수는 # 기호 대신 물음표로 표시됩니다.

false

boolean

alwaysPopulateStatement (advanced)

활성화하면 org.apache.camel.component.sql.SqlPrepareStatementStrategy의 populateStatement 메서드가 항상 호출됩니다. 이 값이 false인 경우 1개 이상의 예상 매개변수를 설정할 경우에만 populateStatement가 호출됩니다. 예를 들어 매개 변수가 없는 SQL 쿼리에 대한 메시지 본문/헤더를 읽지 않도록 합니다.

false

boolean

parametersCount (advanced)

0보다 큰 설정으로 인해 Camel은 JDBC 메타데이터 API를 통해 쿼리하지 않고 이 개수 매개 변수 값을 사용합니다. JDBC 공급업체에서 올바른 매개변수 수를 반환할 수 없는 경우 사용자가 대신 재정의할 수 있습니다.

 

int

자리 표시자 (advanced)

SQL 쿼리에서 교체할 문자를 지정합니다. 간단한 String.replaceAll() 작업이며 SQL 구문 분석과 관련이 없습니다(quoted 문자열도 변경됩니다).

#

문자열

prepareStatementStrategy (advanced)

플러그인에서 사용자 지정 org.apache.camel.component.sql.SqlPrepareStatementStrategy를 사용하여 쿼리 및 준비 문의 준비를 제어할 수 있습니다.

 

SqlPrepareStatementStrategy

templateOptions (고급)

맵의 키/값으로 Spring JdbcTemplate을 구성합니다.

 

map

usePlaceholder (advanced)

자리 표시자를 사용하고 모든 자리 표시자 문자를 SQL 쿼리에 로그인할지 여부를 설정합니다.Sets whether to use placeholder and replace all placeholder characters with sign in the SQL queries.

true

boolean

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat