Loading
ただいま大変多くのお問い合わせをいただいており、ご連絡までにお時間を頂戴しております続きを読む

Data 360: Query Service v2 - Connect API および Direct API における nextBatchId 形式の変更について

公開日: May 20, 2026
説明

Salesforce は、Connect API と Direct API の両方について、Data 360 Query Service v2 から返される nextBatchId の形式と長さを更新します。現在の UUID ベースの nextBatchId の構造をパースするか、またはその構造に依存しているクライアントアプリケーションは、後続のデータバッチを取得する際のエラーを回避するために、この値を不透明な文字列 (opaque string) として扱うように更新する必要があります。

Data 360 Query Service v2 は、次の 2 つのエンドポイントを介してページ分割されたデータ取得をサポートしています。

 

顧客がデータ取得のために POST コールを開始し、追加のチャンク (情報の塊) が利用可能である場合、API レスポンスには nextBatchId が含まれます。その後、この ID は後続のデータバッチを取得するための後続の GET コールで渡されます。

 

何が変更されますか？

現在、nextBatchId は UUID (Universally Unique Identifier: 汎用一意識別子) です。今回のアップデートにより、nextBatchId の形式はクエリ ID とチャンク ID を組み合わせたものに変更され、長さが増加します。新しい形式は query-id_chunkCount のような構造になります。

従来の形式: 2c55b4dc-df7e-e1bd-d346-e1395085d5d9 

新しい形式: MTAuMjIuNDguODY6NzQ4NA_2c55b4dc-df7e-e1bd-d346-e1395085d5d9_1 (第 1 チャンクの場合)

 

なぜ Salesforce はこの変更を行うのですか？

現在の実装では、分散キャッシュを使用して nextBatchId に対するバッチの詳細を保存しています。これにより、オペレーショナルオーバーヘッドと Cost to Serve (サービス提供コスト) が大幅に増加します。nextBatchId の形式を更新することで、Salesforce はステートレスなパースモデルへと移行し、このフローからキャッシュを排除します。

解決策

データ取得への影響を回避するために、お客様はこの変更が有効になる前にお客様のクライアントアプリケーションを確認し、更新する必要があります。

 

必要なアクション

  1. nextBatchId を不透明な文字列 (opaque string) として扱う。nextBatchId 値の形式、長さ、または構造について、パース、検査、または想定を行わない。 
  2. 以下に依存する既存のロジックがないかコードを確認する。 
    1. nextBatchId の特定の形式または長さ
    2. nextBatchId の従来の UUID 構造
  3. このような依存関係をすべて削除する。nextBatchId の形式または構造に依存するアプリケーションは、この変更がリリースされたときに破損する (動作しなくなる) ことが予想される。

 

対策が講じられない場合はどうなりますか？

お客様が対策を講じない場合、アプリケーションが新しい nextBatchId の構造を解決できないため、後続のデータチャンク (情報の塊) を取得しようとする際にエラーが発生します。これにより、完全なデータセットを取得できなくなり、データの不一致が生じる原因となります。

注意：nextBatchId 値を読み取る、またはパースするカスタムロジックが組み込まれたアプリケーションのみが影響を受けます。アプリケーションがすでに nextBatchId を不透明な文字列 (opaque string) として扱っている場合は、変更は不要です。

ナレッジ記事番号

005384667

 
読み込み中
Salesforce Help | Article