SQL Server - オンプレミスファイルからの一括ロードアクション
このアクションは、オンプレミスのCSVデータファイルをSQL Serverのテーブルに読み込みます。ソースCSVデータファイルは、オンプレミスファイルコネクターからアクセスできる必要があります。
OPAが必要
このアクションを使用するには、Workatoのオンプレミスエージェントを使用するコネクションが必要です。詳細については、オンプレミス接続を参照してください。
Match columns by、If a row fails、Columns to identify failed rows フィールドを使用するには、オンプレミスエージェント(OPA)バージョン34.0以降が必要です。
入力
| 入力フィールド | 説明 |
|---|---|
| テーブル名 | 必須。データの読み込み先となる対象テーブルの名前。 |
| ファイルURL | 必須。オンプレミスエージェント上にあるCSVファイルを参照する、オンプレミスファイルURL。 Match columns by が Column order に設定されている場合、CSVの列順は対象テーブルの列順と同じである必要があります。 |
| 詳細設定 | アクションの詳細設定を構成します。詳細については、詳細設定セクションを参照してください。 |
文字数制限
ソースCSVファイルは、最大100,000,000文字をサポートしています。
詳細設定
次のフィールドを使用して、アクションが列の対応付け、失敗した行の処理、ソースファイルの読み取りと読み込みをどのように行うかを制御します。
| 入力フィールド | 説明 |
|---|---|
| 列の照合方法 | CSV列をテーブル列にどのようにマッピングするかを選択します。 Column order は、位置に基づいてテーブル列を埋めます。 Column name (from CSV header) は、各CSVヘッダーをテーブル列に完全一致の名前で対応付け、First row number が 2 以上であることを要件とします。デフォルトは Column order です。詳細については、Match columns by を参照してください。 |
| 行が失敗した場合 | 行の読み込みに失敗した場合にアクションがどのように処理するかを選択します。デフォルトは Stop and load nothing, fail job です。詳細については、If a row fails を参照してください。 |
| 失敗した行を特定するための列 | Failed rows file 出力に含めるテーブル列(たとえば顧客ID)を選択します。これを使用して、各失敗行を元のレコードにさかのぼって特定します。行番号は常に含まれます。このフィールドは、If a row fails が Load valid rows, skip the failed rows に設定されている場合にのみ表示されます。 |
| 最初の行番号 | 必須。処理対象となるファイル内の最初の行のインデックス。データにヘッダー行が含まれている場合は、ヘッダー行をスキップするために 2 を設定します。デフォルトは1です。 |
| フィールド引用符 | 必須。ソースCSV内のフィールドに使用される引用符文字。デフォルトはダブルクオーテーションです。 |
| フィールド終端文字 | 必須。ソースCSVでフィールドを区切る記号。デフォルトはカンマです。 |
| バッチサイズ | 各トランザクションの行数を設定します。行は、複数のトランザクションに分けて、バッチ単位で順次挿入されます。上級ユーザーはこれをカスタマイズして、メモリ使用量を制御し、ロードを最適化できます。デフォルトは 10,000 です。 |
| 最後の行番号 | ファイルの先頭から数えた、処理対象となるファイル内の最後の行のインデックス。これを使用して、ファイルの末尾に到達する前に読み込みを停止します。デフォルトは 0 で、最後の行までのすべての行を処理します。 |
| トリガーを起動 | データ挿入時にテーブルのトリガーを起動するかどうかを指定します。デフォルトはいいえです。 |
| NULL値を保持 | ファイル内の空の値の処理方法を指定します。 Yes を選択すると NULL 値を挿入し、No を選択するとデフォルトの列値を挿入します。デフォルトはYesです。 |
| データファイルタイプ | データファイルの文字エンコーディングを定義します。デフォルトは Char です。 |
| エラー時に部分挿入を許可 | エラーが発生したときにデータを一切挿入しない場合は No を選択し、エラーが発生した行までのすべてのデータを挿入する場合は Yes を選択します。デフォルトはいいえです。このフィールドは、バージョン34.0より前のOPAでのみ表示されます。 |
| 単一バッチで挿入 | すべての行を単一バッチで挿入し、Batch size を無視する場合は Yes を選択します。デフォルトはいいえです。このフィールドは、バージョン34.0より前のOPAでのみ表示されます。 |
列の照合方法
Column order では、ソースCSVファイルに対象テーブルと同じ列が同じ順序で含まれている必要があります。これはデフォルト設定です。
Column name (from CSV header) は、各CSVヘッダーをテーブル列に対して大文字と小文字を区別した完全一致の名前で対応付けます。 CSVファイル内の列順は問いません。このオプションでは、First row number が 2 以上である必要があります。 CSVファイルを生成する任意のクエリ内で列にエイリアスを付け、テーブル列名と一致させてください。
- CSVファイルに存在しないテーブル列は
NULLに設定され、Unmapped destination columns 出力に一覧表示されます。デフォルト値を持つ列は、Keep null values が No に設定されている場合、そのデフォルト値を受け取ります。 - 列がNULL不可でデフォルト値を持たない場合、その列が欠落しているというエラーとともにバッチは失敗します。
- どのテーブル列とも一致しないCSV列は無視され、Unmapped source columns 出力に一覧表示されます。
- 対象テーブルに列を追加しても、Column name (from CSV header) を使用するレシピは動作しなくなりません。新しい列は、CSVファイルに存在しない列として扱われます。
行が失敗した場合
If a row fails フィールドは、行の読み込みに失敗した場合にどの行が挿入されるか、およびジョブが失敗するかどうかを決定します。
| オプション | 動作 |
|---|---|
| 中止して何も読み込まず、ジョブを失敗させる | いずれかの行が失敗した場合、バッチをキャンセルします。ジョブは失敗します。これはデフォルト設定です。 |
| 中止して何も読み込まず、ジョブを継続する | いずれかの行が失敗した場合、バッチをキャンセルします。ジョブは継続します。 Status 出力を使用して結果を確認します。 |
| 最初の不正な行で中止し、ジョブを継続する | 最初の失敗行までのすべての行を挿入し、その後処理を停止します。ジョブは継続します。 |
| 有効な行を読み込み、失敗した行をスキップする | すべての有効な行を挿入し、その後、失敗したすべての行を Failed rows file 出力に返します。ジョブは継続し、一部の行が失敗した場合、Status 出力は Partially Loaded を返します。 Rows failed 出力には、失敗した行の合計件数が含まれます。 |
Failed rows file 出力にはサイズ制限がなく、バッチ内のすべての行が失敗した場合でも、失敗したすべての行が含まれます。各失敗行には、その行番号、エラーの詳細、Columns to identify failed rows で選択した列の値が含まれます。
If a row fails フィールドは、不正な形式のソースファイルなど、CSVの解析エラーに対してアクションがどのように処理するかは変更しません。
出力
| 出力フィールド | 説明 |
|---|---|
| 宛先テーブル | 行が挿入されたテーブルの名前。 |
| 解析された行 | ソースファイルから読み取られた行数。 |
| ロードされた行 | 読み込まれた行数。 |
| Status | Loaded: すべての行が正常に読み込まれました。 Load failed: 読み込みに失敗し、何も読み込まれませんでした。 Partially Loaded: 読み込みは失敗し、一部の行のみが読み込まれました。 Timeout: 実行がタイムアウトしました(24時間のタイムアウト)。 |
| 最初のエラー行 | エラーが発生した最初の行(存在する場合)。 |
| 最初のエラーの詳細 | 最初に発生したエラーの説明(存在する場合)。 |
| 最初のエラー文字 | エラーが発生した文字のインデックス(存在する場合)。 |
| 最初のエラー列名 | エラーが発生したフィールドの列名(存在する場合)。 |
| 失敗した行数 | 読み込みに失敗した行数。 If a row fails が Load valid rows, skip the failed rows に設定されている場合に設定されます。 |
| 失敗した行のファイル | 読み込みに失敗したすべての行を一覧表示するCSVファイル。 If a row fails が Load valid rows, skip the failed rows に設定されている場合に設定されます。ファイルの内容については、If a row fails を参照してください。 |
| マッピングされていないソース列 | 対象テーブルのいずれの列とも一致しないCSV列。これらの列は読み込まれません。 Match columns by が Column name (from CSV header) に設定されている場合に設定されます。 |
| マッピングされていない宛先列 | CSVファイルに存在しないテーブル列。これらの列がどのような値を受け取るかについては、Match columns by を参照してください。 Match columns by が Column name (from CSV header) に設定されている場合に設定されます。 |
最終更新日: