配列

配列は複数の値をまとめて送信する場合に設定するパラメーターの種類です。

配列のパラメーターには以下の項目を設定できます。

要素の種類

配列の要素の種類は以下から選択できます。

さらに要素の種類ごとに入力必須かどうかや正規表現による入力値チェックなどを設定できます。

要素の種類ごとに設定できる項目は、各種パラメーターのドキュメントをご参照ください。

要素の種類で配列/タプルを設定すると階層構造のある配列を設定できます。

階層構造のある配列の場合は、配列内の配列/タプルの要素の種類を以下から選択できます。

階層構造のある配列の場合でも要素の種類ごとに、入力必須かどうかや正規表現による入力値チェックなどを設定できます。

配列を送信する際のフォーマット形式を以下から選択できます。

配列の形式のまま送信されます。

フォーマットなし は以下のデータソースでのみ利用できます。

配列をJSON形式に変換した文字列が送信されます。

を設定でき、設定内容に基づいて配列を変換した文字列が送信されます。

// （例）引用符に `"`、区切り文字に `,` を設定した場合に、送信される文字列
"a","b","c"

SQL文内で使用できる配列の形式で送信されます。

SQLは以下のデータソースでのみ利用できます。

フォーマット形式でSQLを選択した場合、展開先を以下から選択します。

パラメータの値を、SQL文内で以下のようにIN句の値として利用する場合に選択します。

SELECT * FROM table1 WHERE column1 IN {{ array_parameter }};

配列の要素の種類がテキストや数値の場合、アクション実行時に上記のSQL文から以下のようなSQL文が生成されます。

SELECT * FROM table1 WHERE column1 IN (?, ?, ?);

また配列の要素の種類が配列/タプルの場合、アクション実行時に上記のSQL文から以下のようなSQL文が生成されます。

SELECT * FROM table1 WHERE column1 IN ((?, ?, ?), (?, ?, ?));

パラメーターの値を、SQL文内で以下のようにVALUES句の値として利用する場合に選択します。

INSERT INTO table1 (column1) VALUES {{ array_parameter }};

VALUESは配列の要素の種類が配列/タプルの場合のみ利用できます。

アクション実行時に上記のSQL文から以下のようなSQL文が生成されます。

INSERT INTO table1 (column1) VALUES (?, ?, ?), (?, ?, ?);