Data Cloud 開発者ガイド
j一括取り込み
Data Cloud 一括取り込み API を使用すると、大量のデータセットを更新/挿入または削除できます。CSV ファイルで表現されたアップロードデータを準備し、ジョブを作成して、ジョブデータをアップロードします。残りは Salesforce に処理させます。
一括の処理と操作
一括取り込み API は、ジョブを使用して Data Cloud のデータを更新または削除します。一括ジョブは、通常、次のような段階を経て実行されます。
- ジョブを作成して、処理するデータのオブジェクトタイプと、データに行う操作を指定します。サポートされる操作は、データの一括挿入または一括削除です。
- ジョブの作成後、CSV 形式のデータをジョブにアップロードします。
- データが処理できる状態になったことを示すために、ジョブを終了します。必要に応じて、ジョブを中止することができます。
- ジョブの進捗を監視し、失敗レコードに対応します。
- ジョブを削除します。
CSV ファイルの準備
処理しているオブジェクトの項目名を CSV ファイルの 1 行目でリストします。それ以降の行は、Data Cloud データレイクの各レコードに対応します。CSV ファイル内のレコードは、すべて同一オブジェクトのレコードである必要があります。ジョブを最初に作成するときにこのオブジェクトを指定します。
- レコードを作成する場合は、すべての必須項目を含めます。
- ファイルの各項目名ヘッダーはデータソースオブジェクトの項目名と同じである必要があります。結果には、一致した列のみが含まれます。
- レコードの更新は完全置換として機能します。パッチセマンティックはサポートされていません。
- ファイルでは UTF-8 形式を使用します。アップロードデータは 150 MB を超えることはできません。
- CSV ファイルは「RFC 4180 - CSV ファイルの一般書式および MIME タイプ」に従って書式設定されることが予期されています。
- カンマ項目区切り文字のみをサポートします。
- 空の項目値は null に設定されます。
例
1id,contact_name,created_date,tax_exempt,ship_address,total,tax_rate,modified_date
2f19cae7e-5cdb-41ce-92ba-539afea04f9d,Jadyn Kozey,2021-07-22T08:57:08.118Z,false,9818 Walter Course Apt. 811,77506,84,2021-07-05T09:31:44.457Z
348c8b6a6-8179-4a15-ba19-ec5c8206ce28,Kristina Jakubowski,2021-07-08T22:57:02.008Z,false,245 Schowalter Port Suite 245,16986,61,2021-07-03T06:20:52.886Z
456e005af-cc6c-4f9c-b628-ae6cbbc909cc,Aletha Wilkinson,2021-07-21T04:01:29.838Z,true,7494 Hudson Ports Apt. 123,23907,99,2021-07-18T23:21:43.240Z