この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Bulk API 2.0 および Bulk API 開発者ガイド

Bulk API の概要 2.0
Bulk API 2.0 と Bulk API の違いは?
要求の処理方法
制限
API の有効期限
はじめよう
Bulk API 2.0
Bulk API
用語集
PDF

要求の処理方法

一括取り込みジョブでは、CSV ファイル表現を使用してレコードを組織にアップロードできます。一括クエリジョブは、指定されたクエリに基づいてレコードを返します。Bulk API ジョブでは、処理するオブジェクト (取引先、商談など) と、使用するアクションのタイプ (挿入、更新/挿入、更新、削除) を指定します。レコードセットを処理するには、1 つ以上のバッチを含むジョブを作成します。取得ジョブを作成するのか、それともクエリジョブを作成するのかにかかわらず、Salesforce は、要求を最適化して、ジョブが可能な限り速く処理され、タイムアウトやその他の障害が最小限に抑えられるようにします。

ジョブの状況

Bulk API 2.0 Older Documentation でジョブ要求を作成すると、Salesforce は、ジョブの進行状況や結果を示すジョブ「状態」を提供します。手動でジョブの状況を確認することも、Salesforce UI 内にジョブの状況を表示することもできます。[設定] から [クイック検索] ボックスに「一括データ読み込みジョブ」と入力し、[一括データ読み込みジョブ] を選択します。次の表は、ジョブの作成時および処理時の Bulk API 2.0 ジョブの状況を要約したものです。

ジョブのフェーズ 状態 説明
作成 Open 取得ジョブが作成され、データアップロードを開始できる状態です。
作成 UploadComplete

(取得) すべてのジョブデータがアップロードされました。ジョブがキューに追加され、処理の準備が整っています。

(クエリ) Salesforce がクエリジョブをキューに追加しました。
処理 InProgress ジョブは Salesforce によって処理中です。操作には、ジョブデータの自動最適一括処理またはチャンク化とジョブ操作の処理が含まれます。
��果 JobComplete ジョブが処理されました。
結果 Failed ジョブを正常に処理できませんでした。
結果 Aborted ジョブは、ジョブ作成者、または「データインテグレーションの管理」権限を持つユーザによってキャンセルされました。

取得ジョブ

取得ジョブの処理時、Salesforce Bulk API 2.0 は、パフォーマンス向上のため、ジョブのデータを複数のバッチに自動的に分割します。

1 日につき 150,000,000 レコードを上限として、ジョブデータから 10,000 レコードごとに別個のバッチが作成されます。ジョブデータの処理中に制限を超えた場合、残りのデータは処理されません。取得ジョブは失敗したとマークされます。

ジョブが失敗する場合があるのと同様、個々のバッチも失敗する場合があります。Salesforce がバッチ内のすべてのレコードを 10 分以内に処理できない場合は、バッチが失敗します。Salesforce は失敗したバッチの処理を最大 10 回まで自動的に再試��します。10 回再試行してもバッチを処理できなかった場合、その取得ジョブ全体の状況が Failed に変わり、残りのジョブデータは処理されません。

失敗が発生した場合は、新しい取得ジョブを作成して、処理されなかったレコードを処理します。

メモ

処理されなかったレコードと発生したエラーを確認するには、失敗レコードの結果および未処理レコードの結果リソースを使用します。

クエリジョブ

Bulk API 2.0 クエリジョブでは、SOQL クエリを非同期で処理できます。バッチを手動で設定する代わりに Bulk API 2.0 クエリジョブは、クエリジョブを小さなチャンクに分割するための最良の方法を自動的に決定します。これにより、失敗やタイムアウトが回避されます。再試行は API が自動的に処理します。API の再試行が 15 回を超えたというメッセージを受け取った場合は、検索条件を適用してもう一度実行してください。

Bulk API 2.0 は次のオブジェクトを持つ大きなクエリジョブをチャンクするように最適化されています。

  • Account
  • AccountContactRelation
  • AccountTeamMember
  • AiVisitSummary
  • Asset
  • B2BMktActivity
  • B2BMktProspect
  • Campaign
  • CampaignMember
  • CandidateAnswer
  • Case
  • CaseArticle
  • CaseComment
  • Claim
  • ClaimParticipant
  • Contact
  • ContractLineItem
  • ConversationEntry
  • CustomerProperty
  • EinsteinAnswerFeedback
  • EmailMessage
  • EngagementScore
  • Event
  • EventRelation
  • FeedItem
  • Individual
  • InsurancePolicy
  • InsurancePolicyAsset
  • InsurancePolicyParticipant
  • Lead
  • LeadInsight
  • LiveChatTranscript
  • LoginHistory
  • LoyaltyLedger
  • LoyaltyMemberCurrency
  • LoyaltyMemberTier
  • LoyaltyPartnerProduct
  • LoyaltyProgramMember
  • LoyaltyProgramPartner
  • Note
  • ObjectTerritory2Association
  • Opportunity
  • OpportunityContactRole
  • OpportunityHistory
  • OpportunityLineItem
  • OpportunitySplit
  • OpportunityTeamMember
  • Pricebook2
  • PricebookEntry
  • Product2
  • ProductConsumed
  • ProductRequired
  • QuickText
  • Quote
  • QuoteLineItem
  • ReplyText
  • ScoreIntelligence
  • ServiceContract
  • Task
  • TermDocumentFrequency
  • TransactionJournal
  • User
  • UserRole
  • VoiceCall
  • WorkOrder
  • WorkOrderLineItem

この最適化には、カスタムオブジェクトと、標準オブジェクトをサポートする共有テーブルおよび履歴テーブルも含まれます。