第304章 SQL コンポーネント

警告: Camel 2.11 以降、このコンポーネントはコンシューマー (例: from()) とプロデューサーエンドポイント (例 : to()) の両方を作成できます。以前のバージョンでは、プロデューサーとしてしか機能できませんでした。

情報: このコンポーネントは、Transactional Client として使用できます。

SQL コンポーネントは、次のエンドポイント URI 表記を使用します。

sql:select * from table where id=# order by name[?options]

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]

sql:select * from table where id=:#myId order by name[?options]

名前付きパラメーターを使用する場合、Camel は指定された優先順位で名前を検索します。
1. java.util.Map の場合はメッセージ本文から
2. メッセージヘッダーから

名前付きパラメーターを解決できない場合は、例外が出力されます。

Camel 2.14 以降では、次のように Simple 式をパラメーターとして使用できます。

sql:select * from table where id=:#${property.myId} order by name[?options]

sql:select * from table where id=:#${property.myId} order by name[?options]

標準 ? SQL クエリーのパラメーターを示す記号は # 記号に置き換えられます。? 記号は、エンドポイントのオプションを指定するために使用されます。? シンボルの置換は、エンドポイントごとに設定できます。

Camel 2.17 以降では、次に示すように、SQL クエリーをクラスパスまたはファイルシステム内のファイルに外部化できます。

sql:classpath:sql/myquery.sql[?options]

sql:classpath:sql/myquery.sql[?options]

そして、myquery.sql ファイルはクラスパスにあり、単なるプレーンテキストです。

-- this is a comment
select *
from table
where
  id = :#${property.myId}
order by
  name

-- this is a comment
select *
from table
where
  id = :#${property.myId}
order by
  name

ファイルでは、複数行を使用して、必要に応じて SQL をフォーマットできます。– 破線などのコメントも使用します。

URI には、?option=value&option=value&…​ の形式でクエリーオプションを追加できます。