一括挿入のウォークスルー
このウォークスルーでは、Bulk API を使用してレコードを読み込む手順について説明します。
開始する前に、取り込み API の設定に必要な前提条件を完了していることを確認します。
- 取り込み API コネクタを設定する
- データストリームを作成およびリリースする
- 接続アプリケーションを設定する
-
定義したデータストリームに一致するデータを含む CSV ファイルを作成します。例: orders.csv
- Salesforce CDP アクセストークンを要求します。トークン交換応答の access_token プロパティには、認証ヘッダーで使用するベアラートークンが含まれます。instance_url は、API をホストしている Salesforce CDP インスタンスです。
-
データをアップロードするには、ジョブを作成します。この例では、ecomm 取り込み API コネクタから Orders データをアップロードします。レコードを削除する場合は、代わりに delete 操作を使用します。ジョブの状況が Open のジョブ ID を含む JSON 応答が返されます。このジョブ ID は次のステップで必要です。
-
CSV データをアップロードします。ジョブを作成したら、データをアップロードできます。前に作成した CSV ファイルを使用してレコードデータを指定します。ジョブの一環として最大 100 個の CSV ファイルを送信できます。各ファイルは 150 MB を超えることはできません。
-
アップロードが完了します。データの送信が完了したら、ジョブを終了して Salesforce CDP にジョブの処理準備ができたことを伝達できます。
-
ジョブの状況と結果を確認します。全体的なジョブの状況や処理されたレコード数など、ジョブに関する基本的な状況情報を取得するには、ジョブ情報の取得要求を使用します。ファイルがデータレイクに読み込まれるとジョブの状況は UploadComplete から JobComplete または Failed に変わります。