cSQL

クエリーに基づき、SQL接続を使って任意のデータベースに対して読み書きを行います。

詳細は、Apache Camelのドキュメンテーションhttps://camel.apache.org/components/latest/をご覧ください。

注: このコンポーネントは、Talendが提供するR2022-11以降のTalend Studioマンスリーアップデートをインストール済みである場合にのみ利用できます。詳細は管理者にお問い合わせください。

cSQLの標準プロパティ

これらのプロパティは、標準ルートのフレームワークで実行されているcSQLを設定するために使われます。

標準のcSQLコンポーネントは、Connectivityファミリーに属しています。

基本設定

[Properties] (プロパティ)	説明
[Datasource] (データソース)	このコンポーネントで再利用するデータベース接続を開くコンポーネントを選択します。
[Output Type] (出力タイプ)	出力データの種類を選択してます。 SelectOne: 出力は単一のJavaオブジェクトとしてください。 SelectList: 出力はマップのリスト形式にしてください。 StreamList: イテレーターを使用して出力をストリーミングします。
バッチモード	このチェックボックスを選択すると、ステートメントがバッチモードで実行されます。
[Use SQL statement from message body] (メッセージボディのSQL文を使用)	メッセージボディでクエリー文が指定されている場合は、このチェックボックスをオンにします。
[Type] (タイプ)	SQLクエリのソースタイプを選択します。メッセージボディのSQL文を使用オプションが有効になっている場合、このオプションは使用できません。 [Built-In] (組み込み): クエリーステートメントは、コンポーネント内に直接入力されます。 [Repository] (リポジトリー): クエリーステートメントは、既存のリポジトリーリソースファイルから選択されます。 [File Path] (ファイルパス): クエリーステートメントは、ローカルファイルシステムから選択されます。
[Query] (クエリー)	このオプションは、[Type] (タイプ)リストで[Built-In] (組み込み)が選択されている場合に表示されます。スキーマ定義と一致するようデータベースクエリー文を指定します。この場合、フィールドの適切な順序に特に注意が必要です。 Talendが提供するR2025-12 Talend Studioマンスリーアップデート、またはそれ以降のアップデートをインストールしている場合は、複数行を使用してSQLステートメントを自由にフォーマットできます。また、クエリコードボックスの横にある[...]をクリックすると、SQLビルダーが開いて、そこでクエリを作成できます。詳細については、「 SQLBuilderを使用してクエリーを作成する」を参照してください。
リソース	このオプションは、[Type] (タイプ)リストから[Repository] (リポジトリー)が選択されている場合に表示されます。リポジトリーからリソースクエリステートメントファイルを選択します。クエリステートメントのバージョンが複数ある場合は、[バージョン]フィールドで目的のバージョンを選択します。
[Resource File] (リソースファイル)	このオプションは、[Type] (タイプ)リストから[File Path] (ファイルパス)が選択されている場合に表示されます。ローカルファイルシステムにクエリステートメントファイルへのパスを入力します。

詳細設定

[Properties] (プロパティ)	説明
挿入にから生成されたキーを返す	cSQLを使用して自動インクリメントキーが設定されたテーブルにデータを挿入する際に、生成されたキーを取得するには、このチェックボックスを選択します。生成されたキーは、メッセージヘッダーCamelSqlGeneratedKeyRowsに含まれています。cSQLでサポートされているメッセージヘッダーの詳細については、「メッセージヘッダー」を参照してください。取得する生成済み列を指定するには、[+]をクリックして必要な回数だけ予想キーテーブルに行を追加し、列名を入力します。情報メモ注: このオプションは、Talendが提供するR2025-12以降のTalend Studioマンスリーアップデートをインストール済みである場合にのみ利用できます。詳細は管理者にお問い合わせください。
[URI Options] (URIオプション)	オプションの引数を対応するテーブルに設定します。[+]を必要な回数だけクリックして、テーブルに引数を追加します。[名前]フィールドでは、ドロップダウンリストからURIオプションを選択するか、リストにないオプション名を入力できます。次に、対応する[Value] (値)フィールドをクリックして、値を入力します。利用できるURIオプションについては、https://camel.apache.org/components/latest/sql-component.htmlサイトをご覧ください。

[Properties] (プロパティ)

説明

挿入にから生成されたキーを返す

cSQLを使用して自動インクリメントキーが設定されたテーブルにデータを挿入する際に、生成されたキーを取得するには、このチェックボックスを選択します。生成されたキーは、メッセージヘッダーCamelSqlGeneratedKeyRowsに含まれています。cSQLでサポートされているメッセージヘッダーの詳細については、「メッセージヘッダー」を参照してください。

取得する生成済み列を指定するには、[+]をクリックして必要な回数だけ予想キーテーブルに行を追加し、列名を入力します。

注: このオプションは、Talendが提供するR2025-12以降のTalend Studioマンスリーアップデートをインストール済みである場合にのみ利用できます。詳細は管理者にお問い合わせください。

[URI Options] (URIオプション)

オプションの引数を対応するテーブルに設定します。[+]を必要な回数だけクリックして、テーブルに引数を追加します。[名前]フィールドでは、ドロップダウンリストからURIオプションを選択するか、リストにないオプション名を入力できます。次に、対応する[Value] (値)フィールドをクリックして、値を入力します。利用できるURIオプションについては、https://camel.apache.org/components/latest/sql-component.htmlサイトをご覧ください。

使用方法

使用方法のガイダンス	説明
使用ルール	cSQLは、ルートで開始、中間、終了のコンポーネントとして使用できます。このコンポーネントは、データベースへの接続を作成するcSQLConnectionコンポーネントと共に使用する必要があります。cSQLConnectionの詳細は、cSQLConnectionをご覧ください。
制限事項	該当なし

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください