SQL Server - Insertアクション ​

Workatoでは、バッチおよび単一行挿入アクションの両方を提供しています。 これにより、レシピに必要なアクションを選択し、ビジネスニーズを満たす柔軟性が得られます。 バッチ挿入アクションと単一行挿入アクションのどちらを使用するかに関するベストプラクティスと、insert、update、upsertを使用するタイミングを確認してください。

行の挿入 ​

このアクションは、選択したテーブルに単一行を挿入します。

Insert rowアクション

テーブル/ビュー ​

まず、行を挿入するテーブルを選択します。 これは、選択リストからテーブルを選択するか、入力フィールドをテキストモードに切り替えて完全なテーブル名を入力することで実行できます。

列 ​

次に、入力フィールドにデータを手動で入力するか、前のトリガーまたはアクションからのデータピルを対応する列にマッピングします。 ここで生成される入力フィールドは、テーブル内の列に基づいています。

行のバッチを挿入 ​

このアクションでは、1行ずつではなく、1つのアクションで複数の行を挿入できます。 これにより、あるアプリからSQL Serverに多数のレコードを移動する際に、より高いスループットが得られます。 レシピの構造およびデータ量によっては、このアクションにより連携時間を100分の1に短縮できます。

Insert batch of rowsアクション

テーブル ​

単一行挿入アクションと同様に、まずターゲットテーブルを選択する必要があります。

行のソースリスト ​

Insert rowアクション（単一行を扱う場合）とは異なり、ここでは行のバッチを扱います。 そのため、次に入力するデータピルは、テーブルに挿入する行のバッチのソースです。 これは、リストデータピルを出力する任意のトリガーまたはアクションから取得できます。

データツリーからのリストデータピル

このフィールドにリストデータピルをマッピングしない場合、このアクションは1行のみを挿入し、行の挿入アクションと同じように動作します。

列 ​

最後に、先行するトリガーまたはアクションのデータを使用して行を挿入するには、出力データツリーから必要なフィールドをここにマッピングする必要があります。 ここで各列にマッピングするデータピルは、先ほど使用したソースリストデータピルからのものである必要がある点に注意してください。 ソースリストデータピルの外部でマッピングされたデータピルは反復処理されません。

バッチの操作に関する詳細については、リスト管理ガイドを参照してください。

補足事項 ​

データベースに挿入するデータが、スキーマで定義された指定のデータ型と一致していることを確認してください。 正しい型のデータを挿入することは、データの整合性とシステム機能にとって非常に重要です。 不一致がある場合、バッチ挿入のフォールバック動作では、数値以外の値が浮動小数点値0.0に変換されます。