更新系SQL実行処理
オペレーション名
更新系SQL実行
機能概要
SQL文を用いてデータを書き込みます。
データモデル
本コンポーネントのデータモデルはテーブルモデル型です。
プロパティ
変数の使用については、「変数」を参照してください。
基本設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
名前 |
必須 |
使用不可 |
スクリプトキャンバス上での名前を入力します。 |
|
|
入力データ |
省略可 |
使用不可 |
スクリプトキャンバス上にあるコンポーネントを選択します。 |
|
必須設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
接続先 |
必須 |
使用不可 |
コネクションリソースを選択します。
|
|
|
SQL文 |
必須 |
使用可 |
データベースへ発行するSQL文を入力します。 |
注意
複数のクエリを連結したSQL文は指定できません。 |
|
スキーマ定義 |
省略可 |
- |
[SQL文]で指定したSQLパラメータを設定します。 |
|
|
スキーマ定義/列名 |
必須 |
使用不可 |
SQLパラメータの名前を設定します。 |
|
|
スキーマ定義/型 |
必須 |
使用不可 |
SQLパラメータの型を選択します。 |
|
> プロパティアクション
|
項目名 |
説明 |
備考 |
|---|---|---|
|
テーブルブラウザの起動 |
テーブルブラウザを起動します。 操作方法については、「テーブルブラウザ」を参照してください。 |
|
|
SQLウィザードの起動 |
SQLウィザードを起動します。 操作方法については、「SQLウィザード(更新系)」を参照してください。 |
|
書き込み設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
クエリタイムアウトを有効にする |
必須 |
使用不可 |
クエリタイムアウトを有効にするかどうかを選択します。
|
|
|
クエリタイムアウト(秒) |
必須 |
使用可 |
クエリタイムアウトを設定します。 |
|
コメント
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
コメント |
省略可 |
使用不可 |
このコネクターの簡単な説明を記述することができます。 |
|
スキーマ
出力スキーマ
ありません。
トランザクション
トランザクションをサポートしています。
使用できるコンポーネント変数
|
コンポーネント変数名 |
説明 |
備考 |
|---|---|---|
|
count |
更新したデータの件数が格納されます。 |
注意
バッチ更新処理時には、入力データの件数が格納されます。 例:入力データ1件で複数のデータが更新された場合には、countには「1」が格納されます。また、更新が行われなかった場合にも、入力データの件数が格納されます。 |
|
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文に「insert into test_table values (?{col1}, ?{col2}, ?{col3})」と記述した場合、3つのSQLパラメータ(col1、col2、col3)が動的に変更できます。
この更新系SQL実行処理をMapperの出力先に設定すると、Mapperの出力スキーマにcol1、col2、col3が表示されます。Mapperでcol1、col2、col3それぞれにマッピングすることで値を設定します。
-
文字列型をSQLパラメータに指定する場合にはシングルクォーテーションで囲いません。
[SQL文]にSQLパラメータを使用しない場合にはSQL文はプリコンパイルされません。
プリコンパイルしたSQL文を使用する場合にはSQLパラメータを使用してください。
