Bulkデータ書き込み(INSERT)処理(旧)
オペレーション名
Bulkデータ書き込み(INSERT)
機能概要
入力データを元に、Bulk APIを使用したINSERT処理を行います。
ジョブ作成、バッチ作成、バッチ結果の取得、ジョブのクローズまで一括で行います。
-
本オペレーションが使用するAPI仕様については、コネクションリソースで選択したバージョンのAPIドキュメントを以下のリンク先ページより参照してください。
-
「Salesforce Developer Documentation」-(https://developer.salesforce.com/docs)
-
Bulk API Developer's Guide
-
-
データモデル
本コンポーネントのデータモデルはテーブルモデル型です。
プロパティ
変数の使用については、「変数」を参照してください。
基本設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
名前 |
必須 |
使用不可 |
スクリプトキャンバス上での名前を入力します。 |
|
|
入力データ |
必須 |
使用不可 |
スクリプトキャンバス上にあるコンポーネントを選択します。 |
|
必須設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
接続先 |
必須 |
使用不可 |
コネクションリソースを選択します。
|
|
|
テーブル名 |
必須 |
使用不可 |
Salesforceのテーブル名を選択します。 |
|
|
ソート |
必須 |
使用不可 |
項目一覧を選択した方法で並び替えます。
|
|
|
項目一覧 |
必須 |
- |
[テーブル名]で選択したSalesforceテーブル内の項目一覧を表示します。 |
追加可能な項目のみ表示されます。 |
|
項目一覧/選択 |
省略可 |
使用不可 |
[スキーマ定義]として選択する列のチェックボックスにチェックを入れます。 |
|
|
項目一覧/ラベル |
必須 |
使用不可 |
[テーブル名]で選択したテーブルの列のラベル名を表示します。 |
|
|
項目一覧/API |
必須 |
使用不可 |
[テーブル名]で選択したテーブルの列のAPI名を表示します。 |
|
|
項目一覧/型 |
必須 |
使用不可 |
[テーブル名]で選択したテーブルの列のデータ型を表示します。 |
|
|
項目一覧/外部ID |
- |
- |
外部IDの設定が表示されます。
|
|
|
項目一覧/Null許可 |
- |
- |
NULL値の設定を許可するかどうかが表示されます。
|
|
|
スキーマ定義 |
必須 |
- |
スキーマ定義として選択したテーブルの列の一覧が表示されます。 各列は以下のボタンで操作することができます。
|
|
|
スキーマ定義/ラベル |
必須 |
使用不可 |
スキーマ定義として選択したテーブルの列のラベル名を表示します。 |
|
|
スキーマ定義/API |
必須 |
使用不可 |
スキーマ定義として選択したテーブルの列のAPI名を表示します。 |
|
|
スキーマ定義/型 |
必須 |
使用不可 |
スキーマ定義として選択したテーブルの列のデータ型を表示します。 |
|
|
スキーマ定義/外部ID |
- |
- |
外部IDの設定が表示されます。
|
|
|
スキーマ定義/Null許可 |
- |
- |
NULL値の設定を許可するかどうかが表示されます。
|
|
|
スキーマ定義(外部ID) |
省略可 |
- |
スキーマ定義にリレーション項目が存在する場合、外部キーによる更新を行うための項目を設定します。 |
|
|
スキーマ定義(外部ID)/元項目API |
必須 |
使用不可 |
[テーブル名]で指定したテーブルのリレーション項目の列のAPI名を表示します。 |
|
|
スキーマ定義(外部ID)/リレーションシップ名 |
必須 |
使用不可 |
[テーブル名]で指定したテーブルのリレーション項目の列のリレーションシップ名を表示します。 |
|
|
スキーマ定義(外部ID)/オブジェクトAPI |
省略可 |
使用不可 |
[テーブル名]で指定したテーブルのリレーション項目の列のリレーション先のオブジェクトのAPI名を選択します。 |
|
|
スキーマ定義(外部ID)/リレーション用項目API |
省略可 |
使用不可 |
[テーブル名]で指定したテーブルのリレーション項目の列のリレーション先オブジェクトの外部キー項目を選択します。 |
|
> プロパティアクション
|
項目名 |
説明 |
備考 |
|---|---|---|
|
↓選択 |
[項目一覧/選択]列にチェックがある項目を[スキーマ定義]に設定します。 |
|
オプション設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
カラム名タイプ |
必須 |
使用不可 |
マッピングでスキーマを表示する際のカラム名の表示タイプを選択します。
|
|
|
Null/空文字を"#N/A"へ置き換える |
必須 |
使用不可 |
入力データがnullまたは空文字であった場合、文字列「#N/A」に置き換えるかどうかを選択します。
|
注意
APIの仕様として、nullで更新する場合は文字列「#N/A」を指定する必要があります。 |
|
バッチサイズ |
必須 |
使用可 |
1つのバッチに登録するレコード件数の上限を入力します。 |
注意
本コネクターの仕様として、100,000件のデータを書き込むケースで、バッチサイズを2,000と設定した場合、50のバッチを作成します。 ただし、1つのバッチがAPIの制限値である10MBを超えてしまう場合は、指定したバッチサイズ以下でバッチを作成します。 |
|
同時実行モード |
必須 |
使用不可 |
ジョブの同時実行モードを選択します。
|
注意
並列処理を行うと、データベースの競合が生じる可能性があります。競合が激しいと、読み込みが失敗することがあります。 順次モードを使用すれば、バッチは1つずつ確実に処理されます。ただし、このオプションを使用すると、読み込みの処理時間が大幅に増える場合があります。 |
|
処理完了を待ちバッチ結果を取得する |
必須 |
使用不可 |
作成したバッチが完了するまで状況を監視し、バッチ結果を取得するかどうかを選択します。
|
|
|
監視開始までの待機時間(秒) |
省略可 |
使用可 |
バッチ状況の監視を開始するまでの待機時間を、秒で入力します。 |
|
|
バッチ状況監視間隔(秒) |
省略可 |
使用可 |
バッチ情報を取得し処理が完了しているか判断する間隔を、秒で入力します。 |
|
|
最大監視時間(秒) |
省略可 |
使用不可 |
バッチ状況の最大監視時間を、秒で入力します。 |
|
コメント
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
コメント |
省略可 |
使用不可 |
このコネクターの簡単な説明を記述することができます。 |
|
[スキーマ定義]で設定されたカラムに、バッチ結果の情報が付与されます。
(以下、「ラベル/API」という形式で表記)
<?xml version="1.0" encoding="UTF-8" ?>
<table>
<row>
<column>[スキーマ定義]で設定されたラベル/API</column>
:
<column>結果情報_入力行番号/RESULT_inputRowNumber</column>
<column>結果情報_バッチ_ID/RESULT_BATCH_id</column>
<column>結果情報_バッチ_状況/RESULT_BATCH_state</column>
<column>結果情報_バッチ_状態メッセージ/RESULT_BATCH_stateMessage</column>
<column>結果情報_レコード_ID/RESULT_ROW_id</column>
<column>結果情報_レコード_成功フラグ/RESULT_ROW_success</column>
<column>結果情報_レコード_作成フラグ/RESULT_ROW_created</column>
<column>結果情報_レコード_エラーメッセージ/RESULT_ROW_error</column>
</row>
<row>
:
</row>
</table>
|
要素名 |
列名(ラベル/API) |
説明 |
備考 |
|---|---|---|---|
|
row |
|
入力スキーマに渡されたデータ件数分繰り返します。 |
|
|
column |
結果情報_入力行番号/RESULT_inputRowNumber |
入力スキーマに渡されたデータ内のノードの位置に基づいて番号を出力します。 |
|
|
結果情報_バッチ_ID/RESULT_BATCH_id |
レコードが処理されたバッチのIDを出力します。 |
|
|
|
結果情報_バッチ_状況/RESULT_BATCH_state |
レコードが処理されたバッチの状況を出力します。
|
|
|
|
結果情報_バッチ_状態メッセージ/RESULT_BATCH_stateMessage |
レコードが処理されたバッチの状態メッセージを出力します。 |
|
|
|
結果情報_レコード_ID/RESULT_ROW_id |
レコードのIDを出力します。 |
|
|
|
結果情報_レコード_成功フラグ/RESULT_ROW_success |
レコードの成功フラグを出力します。
|
|
|
|
結果情報_レコード_作成フラグ/RESULT_ROW_created |
レコードの新規作成フラグを出力します。
|
|
|
|
結果情報_レコード_エラーメッセージ/RESULT_ROW_error |
レコードのエラーメッセージを出力します。バッチ結果が取得できない場合、レコードが処理されたバッチの状態メッセージを出力します。 |
|
大容量データ処理
大容量データ処理に対応していません。
トランザクション
トランザクションはサポートしていません。
PSPでの使用について
PSPでは使用できません。
使用できるコンポーネント変数
|
コンポーネント変数名 |
説明 |
備考 |
|---|---|---|
|
job_id |
作成したジョブのIDが格納されます。 |
|
|
read_count |
入力データの件数が格納されます。 |
|
|
created_batch_count |
作成したバッチの件数が格納されます。 |
|
|
get_result_success_count |
処理に成功したデータの件数が格納されます。 |
|
|
get_result_error_count |
処理に失敗したデータの件数が格納されます。 |
|
|
server_url |
ログイン後のエンドポイントURLが格納されます。 |
|
|
session_id |
セッションIDが格納されます。 |
|
|
message_category |
エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。 |
|
|
message_code |
エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。 |
|
|
message_level |
エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。 |
|
|
operation_api_exception_code |
APIエラー発生時、発生したエラーのExceptionCodeが格納されます。 |
|
|
operation_error_message |
エラー発生時、発生したエラーのメッセージが格納されます。 |
|
|
operation_error_trace |
エラー発生時、発生したエラーのトレース情報が格納されます。 |
|
メッセージコード、例外メッセージ、制限事項
|
コネクター |
メッセージコード |
エラーメッセージ |
制限事項 |
|---|---|---|---|
|
|
|
|
