CSV ファイルの準備

CSV ファイル内のレコードは、すべて同一オブジェクトのレコードである必要があります。オブジェクトは、バッチに関連付けられたジョブで指定します。

Bulk API 2.0 で CSV ファイルを使用する場合は、次の点に注意します。

• レコードを作成するときは、必須項目はもれなく含める必要があります。その他の項目は、必要に応じて含めることができます。
• レコードの更新では、CSV ファイルで定義されていない項目は無視されます。
• ファイルでは UTF-8 形式を使用します。ファイルは Salesforce で受信されるときに base64 に変換されます。この変換により、データサイズが約 50% 増加する可能性があります。base64 変換による増加を考慮し、アップロードするデータは 100 MB 以下にします。
• Bulk API 2.0 では、複数の項目区切り文字 (バッククォート (`)、キャレット (^)、カンマ、パイプ (|)、セミコロン、タブ) がサポートされます。デフォルトの区切り文字はカンマです。使用する区切り文字は、ジョブの作成時に columnDelimiter 要求項目を使用して指定します。
• Bulk API 2.0 では、複数の行末形式 (改行、行頭復帰と改行) がサポートされます。デフォルトの行末は改行です。使用する行末は、ジョブの作成時に lineEnding 要求項目を使用して指定します。
• 項目区切り文字または行末と解釈される項目値内の文字は、二重引用符を使用してエスケープします。たとえば、項目値にカンマが含まれていて、カンマがそのジョブの現在の列区切り文字である場合、CSV データ内の項目値を二重引用符で囲む必要があります。たとえば、"Director, Marketing" のようにします。
• 値は切り詰められることはありません。区切り文字の前後に空白文字が挿入されている場合、それらも項目値の一部とみなされます。ただし、二重引用符の前後に空白文字が挿入されている場合は、その行がエラーになります。たとえば、John,Smith は有効な値です。John, Smith も、空白文字が含まれていますが有効です。一方、" Smith"、"John", "Smith" は無効な値となります。
• 項目の値が空である場合、レコードの更新時にはその項目は無視されます。値を null に設定するには、項目値 #N/A を使用します。
• double 型の項目には、小数値を含めることができます。W3C XML Schema Part 2: Datatypes Second Editionに記載されているとおり、相応に大きな数値の場合は、値を科学的記数法で保存できます。