検索系SQL実行処理
オペレーション名
検索系SQL実行
機能概要
SQL文を用いてデータを読み取ります。
データモデル
本コンポーネントのデータモデルはテーブルモデル型です。
プロパティ
変数の使用については、「変数」を参照してください。
基本設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
名前 |
必須 |
使用不可 |
スクリプトキャンバス上での名前を入力します。 |
|
|
入力データ |
省略可 |
使用不可 |
スクリプトキャンバス上にあるコンポーネントを選択します。 |
|
必須設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
接続先 |
必須 |
使用不可 |
コネクションリソースを選択します。
|
|
|
SQL文 |
必須 |
使用可 |
データベースへ発行するSQL文を入力します。 |
|
|
入力スキーマ定義 |
省略可 |
- |
[SQL文]で指定したSQLパラメータを設定します。 |
|
|
入力スキーマ定義/列名 |
必須 |
使用不可 |
SQLパラメータの名前を設定します。 |
|
|
入力スキーマ定義/型 |
必須 |
使用不可 |
SQLパラメータの型を選択します。 |
|
|
出力スキーマ定義 |
必須 |
- |
[SQL文]で指定したSQL文のスキーマ定義を表示します。 |
|
|
出力スキーマ定義/列名 |
必須 |
使用不可 |
[SQL文]で指定した列名を表示します。 |
|
|
出力スキーマ定義/型 |
必須 |
使用不可 |
[列名]の型を表示します。 |
「<Native型> (<内部データ型>)」形式で表示されます。
|
> プロパティアクション
|
項目名 |
説明 |
備考 |
|---|---|---|
|
テーブルブラウザの起動 |
テーブルブラウザを起動します。 操作方法については、「テーブルブラウザ」を参照してください。 |
|
|
SQLウィザードの起動 |
SQLウィザードを起動します。 操作方法については、「SQLウィザード(検索系)」を参照してください。 |
|
|
抽出テスト |
指定したSQL文を実行します。結果として取得した件数が表示されます。 |
|
|
SQL文を実行して出力スキーマを設定 |
[SQL文]で指定したSQL文から出力スキーマ情報を取得し[出力スキーマ定義]に設定します。 |
|
読み取り設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
フェッチサイズ |
省略可 |
使用可 |
JDBCフェッチサイズを指定します。 |
注意
以下のコネクターには本プロパティはありません。
|
|
クエリタイムアウトを有効にする |
必須 |
使用不可 |
クエリタイムアウトを有効にするかどうかを選択します。
|
|
|
クエリタイムアウト(秒) |
必須 |
使用可 |
クエリタイムアウトを設定します。 |
|
データ処理方式
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
データ処理方式 |
必須 |
使用不可 |
データ処理方式を選択します。
|
|
コメント
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
コメント |
省略可 |
使用不可 |
このコネクターの簡単な説明を記述することができます。 |
|
スキーマ
トランザクション
トランザクションをサポートしています。
大容量データ処理
大容量データ処理に対応しています。
使用できるコンポーネント変数
|
コンポーネント変数名 |
説明 |
備考 |
|---|---|---|
|
count |
検索したデータの件数が格納されます。 |
注意
PSPでは値が格納されません。 |
|
error_code |
エラー(SQLException)発生時、発生したエラーに対応するエラーコードが格納されます。 |
注意
エラーコードは各ドライバの仕様に基づいています。 |
|
message_category |
エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。 |
|
|
message_code |
エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。 |
|
|
message_level |
エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。 |
|
|
error_type |
エラー発生時、発生したエラーの種類が格納されます。 |
|
|
error_message |
エラー発生時、発生したエラーのメッセージが格納されます。 |
|
|
error_trace |
エラー発生時、発生したエラーのトレース情報が格納されます。 |
|
検索系SQL実行処理では、SQLパラメータを使用することができます。
プリコンパイルしたSQL文を使用したいときにはSQLパラメータを使用します。同一SQL文を複数回実行するときにプリコンパイルされたSQL文を使用するとパフォーマンスが向上します。
SQLパラメータの使用方法
SQLパラメータは「?{name}」と記述します。「name」は任意に指定できます。
SQLパラメータはMapperで値を設定します。
たとえば、SQL文に「select * from test_table where col1 = ?{col1} and col2 = ?{col2} and col3 = ?{col3}」と記述した場合、3つのSQLパラメータ(col1、col2、col3)が動的に変更できます。
この検索系SQL実行処理をMapperの出力先に設定すると、Mapperの出力スキーマにcol1、col2、col3が表示されます。Mapperでcol1、col2、col3それぞれにマッピングすることで値を設定します。
-
文字列型をSQLパラメータに指定する場合にはシングルクォーテーションで囲いません。
[SQL文]にSQLパラメータを使用しない場合にはSQL文はプリコンパイルされません。
プリコンパイルしたSQL文を使用する場合にはSQLパラメータを使用してください。
メッセージコード、例外メッセージ、制限事項
|
コネクター |
メッセージコード |
例外メッセージ |
制限事項 |
|---|---|---|---|
| DB2 コネクターのメッセージおよび制限事項 |
|
|
|
| MySQL コネクターのメッセージおよび制限事項 |
|
|
|
| Oracle コネクターのメッセージおよび制限事項 |
|
|
|
| PostgreSQL コネクターのメッセージおよび制限事項 |
|
|
|
| SQL Server コネクターのメッセージおよび制限事項 |
|
|
|
| JDBC コネクターのメッセージおよび制限事項 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
