SQL Server Exec

SQL Server Execcコンポーネントは、SQL Serverに対してSQL文を実行してデータを更新/削除することができます。
SQL Server 2005以上に対応しています。
　

　
　　
h3. 出力ペイロード

出力ペイロード	説明
`cv.Payload`	入力ペイロードに加えて実行したSQL文によりLastInsertIdまたはRowsAffectedを渡します

LastInsertIdは、実行したSQL文がINSERT文だったときに、DBによって生成されたIDが取得できた場合に返されます。
RowsAffectedは、実行したSQL文によって影響を受けたレコード数を返します。例えば、DELETE文だったときに削除された行数が戻ります。
　

プロパティー名	説明
SQL	実行するSQL文を指定
バルクモード	SQL文の実行でバルクモードを使用するかを選択
バルクサイズ	バルクモードを使用する場合にそのサイズを指定します
ホスト	SQL Serverのホストを指定します
ポート	SQL Serverのポートを指定します
ユーザ名	SQL Serverのユーザ名を指定します
パスワード	SQL Serverのパスワードを指定します
データベース	データベースを指定します
Encrypt	通信の暗号化を disable（SSL/TLS接続をしない）、true（SSL/TLS接続をする）、false（ログインのみ暗号化する）から指定します
TrustServerCertificate	SQL Serverのサーバー証明書を信頼するか選択します。オンの場合はSQL Server が送信する証明書を信頼します。オフを指定した場合にはトラストストア証明書に照らして SQL Server 証明書を検証します
ルート証明書	使用するルート証明書を指定します。AWSのAuroraまたはRDSを使用する場合にはAWSが発行したサーバー証明書を使用する必要があります。そのサーバー証明書のルート証明書となります

実行するSQL文にプレースホルダーを使用してcv.Playloadの値をSQL文に使用することができます。

UPDATE table1 SET name='更新名' WHERE id=?

　
? で指定したプレースホルダーにはcv.Payloadの値が使われます。cv.Payloadに1と入っていた時に、idが1のレコードを更新します。
プレースホルダーは2つ以上指定することもできます。

UPDATE table1 SET name=? WHERE id=?

　
2つ以上のプレースホルダーに値を指定するためにcv.Payloadに配列で値を指定しください。

["First Last", 20]

　
Text2SQLはOpenAIのChatGPTの機能を使用して取得したいデータをプロンプトに入力した日本語からSQL文を生成できる機能です。
使い方はこちらを参照してください。