JDBC - Run custom SQLアクション（バッチ）
Run custom SQLバッチアクションは、JDBCソースでSQLコマンドを実行します。 これには、INSERT、UPDATE、SELECT、および DELETEなどのデータ操作言語（DML）ステートメントと、CREATE、ALTER、およびDROPなどのデータ定義言語（DDL）コマンドが含まれます。
1 MBのクエリサイズ制限
1 December 2025以降、このコネクターのRun custom SQLアクションでは、1 MBのクエリサイズ制限が適用されます。 この変更により、プラットフォームの信頼性が向上し、パフォーマンスが向上し、データベースコネクションを過負荷にしたり、アップストリームシステムに影響を与えたりする大規模なクエリを回避できます。
Workatoはこのアクションで最大50,000を返します。 複雑なSELECTクエリには、カスタムSQLを使用して行を選択アクションを使用します。 このアクションには、OPAバージョン2.4.3以降が必要です。
OPA必須
このアクションは、Workatoオンプレミスエージェントで実行されるコネクションで使用します。 詳細については、オンプレミスエージェントを使用するコネクションドキュメントを参照してください。
入力
| 入力フィールド | 説明 |
|---|---|
| SQL | 有効なSQL文字列を入力します。 複数のSQLステートメントをセミコロン（;）で区切って含めることができます。 ただし、返されるのは最後のステートメントの結果のみです。 データピルを使用してSQLを動的に構築し、データピルを必ず一重引用符（''）で囲んでください。クエリサイズは1 MBに制限されています。 |
| 行制限なしで更新専用SQLステートメントを実行 | 任意です。 行制限なしでSQLステートメントを実行するには、これをYesに設定します。 このオプションは行を返しません。 デフォルトはいいえです。 |
| パラメーター | SQLクエリの名前付きパラメーターを定義します。 各パラメーターをSQL文字列内のプレースホルダーに一致させます。 静的な値を指定するか、データピルをマッピングします。 データベースが想定する内容に一致するデータ型を選択します。 OPAバージョン2.7.3以降が必要です。 |
| 出力フィールド | 行を返すSQLクエリ（SELECTステートメントなど）に対して、想定される出力列を定義します。 Workatoはこのスキーマを使用してデータピルを生成します。 |
出力
| 出力フィールド | 説明 |
|---|---|
| 行 | SQLクエリから返される行のリスト。 WorkatoはOutput fields入力に基づいてこれらのフィールドを定義します。 |
| 影響を受けた行数 | SQLステートメントが影響を与えた行数を示す整数。 |
SQLパラメーターを使用する
実行時にクエリに値を指定するには、SQLパラメーターを使用します。 このアプローチはSQLインジェクションを防ぎ、再利用可能な動的SQLをサポートします。
たとえば、IDで顧客レコードを取得する場合:
SELECT * FROM customers WHERE id = :customer_idParameters入力でcustomer_idという名前のフィールドを定義し、データピルにマッピングします。 たとえば、Stripeステップの顧客IDStep 6。
SQLパラメーターを定義してデータピルにマッピングする
制限事項
行を返すSQLクエリは50,000に制限されます。
Last updated: