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

Query API V2 を使用したデータの照会:

Query API V2 は ANSI 標準の SQL クエリをサポートしています。結果はレコードの配列として返されます。この API をコールするときに想定される入力は、自由形式の SQL です。入力オブジェクトには、データストリーム、プロファイルおよびエンゲージメントデータモデルオブジェクト、統合データモデルオブジェクトがあります。Query API V2 を使用して、大量データの参照、外部アプリケーションの統合、データレイクに対するインタラクティブなオンデマンド照会など、さまざまな使用事例に対応できます。

小規模な抽出クエリには Query API V1 を使用することをお勧めします。オフセットと制限を指定して限られたデータセットを取得する場合もこの API を使用できます。

メモ

主なプロパティ

  • カーソルのページ設定がサポートされます。
  • GET および POST API コールがサポートされます。
  • POST エンドポイントは最初の要求を行うために使用されます。POST エンドポイントでは、カーソルのページ設定を活用する次のバッチの batchId と一緒にデータを返します。
  • GET エンドポイントは同じクエリの後続の要求に使用されます。
  • GET エンドポイントには、パラメータとして batchId が必要です。
  • ページ設定は順方向カーソルのみです。つまり、同じ batchId を 2 回以上使用することはできません。
  • 後続の GET コールには最後のコールの nextBatchId 値が必要なため、クエリの実行は順次実行されます。
  • ネストされたサブクエリ数には明示的な制限はありません。
  • 結合の数には明示的な制限はありません。
  • 検索条件の数には明示的な制限はありません。
  • 列投影の数には明示的な制限はありません。
  • データ型には明示的な制限はありません。
  • 応答では完了済み Boolean フラグが公開されます。フラグが true に設定されている場合、照会するレコードはもうありません。フラグが false に設定されている場合、次の batchId を使用して次のページを取得できます。
  • 応答データサイズは最大 8 MB に制限されています。
  • 次のバッチコールは最大 1 時間まで可能です。
  • 集計関数を使用している場合、計算結果は文字列型ではなく数値型になります。

応答には queryId が含まれます。POST および GET コールに関係なく、ID は同じままになります。

メモ

接続アプリケーションの設定

接続アプリケーションを設定する前に、「Customer Data Platform のユーザロールと権限セット」を参照することをお勧めします。組織に Customer Data Platform ライセンスをプロビジョニングし、また、ユーザに適切なロールを割り当てて Customer Data Platform のオブジェクトにフルアクセスできるようにする必要があります。

重要

顧客に関する新しいインサイトを見つけるように接続アプリケーションを設定します。

Customer Data Platform のアクセストークンの取得と交換

CDP トークンの取得方法については、「使用開始」ページをご参照ください。

コールリファレンス