325장. SQL 구성 요소
Camel 버전 1.4로 사용 가능
sql: 구성 요소를 사용하면 JDBC 쿼리를 사용하여 데이터베이스에서 작업할 수 있습니다. 이 구성 요소와 JDBC 구성 요소의 차이점은 쿼리의 경우 쿼리가 끝점의 속성이며 쿼리에 전달되는 매개 변수로 메시지 페이로드를 사용한다는 것입니다.
이 구성 요소는 실제 SQL 처리를 위해 백그라운드에서 spring-jdbc 를 사용합니다.
Maven 사용자는 이 구성 요소를 위해 다음 종속성을 pom.xml 에 추가해야 합니다.
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-sql</artifactId>
<version>x.x.x</version>
<!-- use the same version as your Camel core version -->
</dependency>SQL 구성 요소는 다음과 같은 기능을 지원합니다.
- Idempotent Consumer EIP 패턴을 위한 JDBC 기반 리포지토리입니다. 325.13절. “JDBC 기반 멱등 리포지토리 사용” 을 참조하십시오.
- 집계 EIP 패턴을 위한 JDBC 기반 리포지토리입니다. 325.14절. “JDBC 기반 집계 리포지토리 사용” 을 참조하십시오.
325.1. URI 형식
WARNING:From Camel 2.11 이후 이 구성 요소는 소비자(예: from()) 및 생산자 끝점(예: to())을 둘 다 생성할 수 있습니다. 이전 버전에서는 생산자로만 작동할 수 있습니다.
INFO: 이 구성 요소는 트랜잭션 클라이언트로 사용할 수 있습니다.
SQL 구성 요소는 다음 끝점 URI 표기법을 사용합니다.
sql:select * from table where id=# order by name[?options]
Camel 2.11 이후부터는 다음과 같이 :'#name_of_the_parameter' 스타일을 사용하여 명명된 매개변수를 사용할 수 있습니다.
sql:select * from table where id=:#myId order by name[?options]
명명된 매개 변수를 사용하는 경우 Camel은 지정된 우선 순위에서 의 이름을 조회합니다.
1. 메시지 본문에서 java.util.Map
2. 메시지 헤더에서
명명된 매개 변수를 확인할 수 없는 경우 예외가 발생합니다.
Camel 2.14 에서 다음과 같이 간단한 표현식을 매개변수로 사용할 수 있습니다.
sql:select * from table where id=:#${property.myId} order by name[?options]
? 기호가 끝점에 대한 옵션을 지정하는 데 사용되므로 SQL 쿼리에 대한 매개 변수를 나타내는 표준 ? 기호가 # 기호로 대체됩니다. ? 기호 교체는 끝점에 따라 구성할 수 있습니다.
Camel 2.17 이후부터는 다음과 같이 classpath 또는 파일 시스템의 파일에 대한 SQL 쿼리를 외부화할 수 있습니다.
sql:classpath:sql/myquery.sql[?options]
그리고 myquery.sql 파일은 classpath에 있고 일반 텍스트일 뿐입니다.
-- this is a comment
select *
from table
where
id = :#${property.myId}
order by
name파일에서 여러 줄을 사용하고 SQL을 원하는 형식으로 포맷할 수 있습니다. 또한 - dash 행과 같은 주석을 사용합니다.
다음 형식 ?option=value&option=value&…로 URI에 쿼리 옵션을 추가할 수 있습니다.
