このページはAIで翻訳されています。コミュニティによるレビューはまだ行われていません。 英語で読む

ブログ · 2023年9月15日 · Steve Simpson · 統合

Salesforce Bulk API の手順:荷積み場でデータをインポートする

はじめに:

この記事では、大量のデータセットを Salesforce に効率よくインポートするために設計された強力なツール、Salesforce Bulk API を探ります。1回の呼び出しで200レコードまでに制限される REST API と違い、Bulk API なら合理化されたプロセスで何百万ものレコードを挿入できます。

セクション1:Bulk API のプロセスを理解する

Salesforce Bulk API は、大量のデータをスムーズにインポートするために五つの手順で動きます。

図:外部クライアントが REST API で1回200レコードずつ1,000,000レコードを読み込むには、5,000回の API 呼び出しが必要 図:外部クライアントと Salesforce の間の Bulk API の五つの手順。ジョブを開く、ファイルをアップロードする、処理を開始する、状態を確認する、成功と失敗をダウンロードする

  1. ジョブを開く(手順1):ジョブを開いてプロセスを始めると、一意のジョブ ID が与えられます。この手順は、荷積み場に入るための整理券を受け取るようなものです。
  2. ファイルをアップロードする(手順2):ジョブ ID を使って、CSV 形式のデータファイルのアップロードを始められます。各ファイルにはサイズの制限内で最大10,000レコードを入れられます。同じジョブ ID の下に複数のファイルをアップロードできます。
  3. 処理を開始する(手順3):アップロードが終わったら、たとえるなら「大きな青いボタン」を押して、Salesforce にデータの処理開始を伝えます。すると Salesforce がアップロードされたファイルの処理を始めます。
  4. ジョブの状態を確認する(手順4):処理中は、ジョブ ID を使ってジョブの状態を問い合わせられます。この手順でデータインポートの進み具合を監視できます。
  5. 結果をダウンロードする(手順5):処理が終わったら結果をダウンロードできます。新しく挿入または更新されたレコードの Salesforce ID を含む成功レコードか、発生したエラーの詳細を示す失敗レコードのどちらかを選べます。

セクション2:Postman で Bulk API を実演する

Bulk API のプロセスを示すために、Postman を使って Salesforce の Sandbox とやり取りします。

  1. 認証:まず認証してアクセストークンを受け取ります。
  2. 新しいジョブを作る:ジョブ作成のリクエストを送って新しいジョブを始めます。これでジョブ ID が得られます。
  3. データをアップロードする:URL にジョブ ID を入れてデータをアップロードします。この例では「Bart Buildings」という新しい取引先を作ります。
  4. 処理を開始する:ジョブ ID とステータス「Upload Complete」を付けたリクエストを送り、Salesforce に処理開始を伝えます。
  5. ジョブの状態を確認する:ジョブ ID を使って状態を確認し、ジョブの進み具合を監視します。ジョブが完了したら次の手順に進めます。
  6. 成功レコードをダウンロードする:ジョブ ID を使って成功レコードをダウンロードし、新しく作られたレコードの Salesforce ID を取得します。

Postman のスクリーンショット、手順1:Bulk API の取り込みジョブを作る POST。レスポンスに新しいジョブ ID が表示される Postman のスクリーンショット、手順2:CSV データをジョブにアップロードする PUT。201 Created が返る Postman のスクリーンショット、手順3:ジョブの状態を UploadComplete に設定して処理を開始する PATCH Postman のスクリーンショット、手順4:ジョブの状態を確認する GET。JobComplete と表示される Postman のスクリーンショット、手順5:成功した結果を CSV でダウンロードする GET。新しいレコード ID が見える

セクション3:まとめ

Salesforce Bulk API は、最小限の API 呼び出しで大量のデータセットを Salesforce にインポートする効率的な方法です。わかりやすい五つの手順で、何百万ものレコードを効率よく挿入、更新、さらには削除できます。扱うのが1レコードでも何百万レコードでも、Bulk API はデータインポートのニーズに速く確実に応えます。

お楽しみに

Salesforce Bulk API の探索にお付き合いいただきありがとうございました。Salesforce の強力な機能を活用するためのさらなるコンテンツをお楽しみに!

www.SteveTechArc.com と YouTube チャンネル @SteveTechArc (opens in a new tab) に参加してください。チャンネル登録して、Salesforce と、それをほかのシステムとどう統合できるかの理解を深めてください。

アーキテクト仲間やアーキテクトを目指す人たちと統合の知識を共有して、世界を変える手助けを!

文字起こしには AI を活用

STA 1.7