actionを一括挿入

一括挿入 action を使用して、CSV またはテキストファイルから行を読み取り、ターゲットデータベーステーブルにバッチで挿入します。 このアクションを使用すると、大規模なデータセットを効率的にロードし、挿入された行数の合計を取得できます。

大規模なデータ挿入操作を実行する際、例えばファイルからデータベースに数千件または数百万件のレコードをロードする場合は、一括挿入 action を使用してください。

設定

  • セッション名フィールドには、接続 actionでデータベース サーバーとの接続に使用したセッション名を入力します。 詳細については、データベースでの [接続] actionの使用を参照してください。
  • ソースファイル フィールドに読み込むソースファイルのパスを入力します。
    注: .csvおよび.txtファイルのみ指定できます。
  • テーブル名 フィールドに、行を挿入する対象のデータベーステーブルを入力します。
  • 区切り文字の値を入力して、ソースファイルの列がどのように区切られているかを指定してください。
    注: カンマがデフォルトの区切り文字の値です。 他にサポートされている値には、カンマ、タブ、改行が含まれます。
  • specificDelimiter を指定します。 区切り文字 が その他 に設定されている場合、これはカスタム区切り文字です。 たとえば、|を使用します。
  • 開始行番号 フィールドに、ソースファイルから読み取る最初のデータ行を入力してください。
    注: デフォルト値は2であり、ファイルにヘッダー行が含まれているため、2またはデフォルト値以上でなければなりません。
  • 列マッピング フィールドで、マッピングを追加 をクリックして、ソースファイルの列をターゲットテーブルの列にマッピングします。 列名とデータ型が一致していることを確認してください。
    • マッピングエントリのために、ソースファイルに表示されている通りのファイル列名を列ヘッダーとして指定してください。
    • マッピングエントリの対象テーブルのカラム名に一致するテーブル列名を入力してください。
    注:
    • 列マッピングは任意です。
    • 列マッピングが追加されていない場合、ソースファイルのすべての列がターゲットテーブルのすべての列にマッピングされます。
    • 対象テーブルが必要なカラムを持ってデータベース内に存在していることを確認してください。 また、フィールドの一対一対応のために、カラム名の大文字と小文字の区別も確認してください。

    • このactionは高スループットのシナリオ向けに最適化されており、行ごとの挿入と比較して大きなパフォーマンスのメリットを提供します。

    • 小規模なデータ量の場合、標準の挿入操作（例えば、Loop actionの使用）がより適切で、設定も簡単です。

  • バッチサイズ フィールドで、バッチごとに挿入する行数を指定します。
    注: デフォルトのバッチサイズは1000です。 200～500000の間でなければなりません
  • 各バッチの最大待機時間を指定するタイムアウト値を入力してください。 デフォルト値は1800です。 1秒以上3600秒以内でなければなりません。
    注: バッチがタイムアウトした場合、action は正常に挿入された行数の合計を返します。 処理を再開するには、このカウントに1を加え、その値を次回の開始行番号として使用してください。

結果: このactionを使用すると、レコードを一括で挿入でき、挿入されたレコードの合計数が数値として返されます。

全体として、このactionはLoopを必要とせずにバルクインサートを実行し、すべての行が挿入されるかエラーが発生するまで同期的に処理を継続します。これにより、大規模なデータセットに対して1行ずつ挿入する場合と比べて、著しく優れたパフォーマンスが得られます。