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

Data Cloud のクエリプロファイルパラメーター

Data Cloud のクエリおよび統合プロファイルパラメーターにより、Salesforce REST API クエリエンドポイントを活用して組織内の統合プロファイル、データ取得元オブジェクト、またはデータモデルオブジェクトに対する SOQL クエリを実行できます。この機能は API バージョン 51.0 以降でサポートされています。

Query REST コールの使用の一般的な情報については、「SOQL クエリを実行する」および「クエリ」を参照してください。

サポート対象 SOQL パラメーター

次の SOQL パラメーターは Data Cloud での使用がサポートされています。

単一オブジェクトでの SELECT ステートメント
SELECT 句: count()
SOQL WHERE 句: contains (次の文字列を含む) 演算子
SOQL LIKE
SOQL LIMIT 句
デフォルトの制限は 100 に設定されています。1 回のコールの最大制限は 2,000 レコードです。
SOQL OFFSET 句
SOQL ORDER BY 句

SOQL の制限

次のクエリは Data Cloud での使用がサポートされていません。

SOQL サブクエリ
SELECT 句: 集計関数
SELECT 句: 日付関数
SOQL HAVING 句

サンプルクエリ

使用事例	クエリ
データプレビュー: データレークオブジェクトに取り込まれたデータを調べます。	メールのクリックイベントを取得する `SELECT` SubscriberKey__c, EngagementChannel__c, EmailName__c, SubjectLine__c `FROM` sfmc_email_engagement_click_{EID}__dll `LIMIT` =100
同意の参照: メールアドレス、電話番号、名および姓に基づいて、連絡先データモデルから個人 ID を取得します。	メールアドレスによって個人 ID を取得する `SELECT` PartyId__c `FROM` ContactPointEmail__dlm `WHERE` EmailAddress__c=’jjones@email.com’ `LIMIT` =100 電話番号によって個人 ID を取得する `SELECT` PartyId__c `FROM` ContactPointPhone__dlm `WHERE` TelephoneNumber__c=’555-123-4567’ `LIMIT` =100 名前によって個人 ID を取得する `SELECT` IndividualId__c `FROM` Individual__dlm `WHERE` FirstName__c=’Jimmy’ AND LastName__c=’Smith’ `LIMIT` =100
統合プロファイルの参照: 取得元レコード ID によって統合個人と統合連絡先を取得します。	ステップ 1: 取得元レコード ID によって統合レコードを取得する `SELECT` UnifiedRecordId__c `FROM` IndividualIdentityLink__dlm `WHERE` SourceRecordID__c='{sourceID}' `LIMIT` =100 ステップ 2: 統合プロファイル ID によって統合個人を照会する `SELECT` FirstName__c, LastName__c `FROM` UnifiedIndividual__dlm `WHERE` Id__c='{UnifiedRecordId__c}' `LIMIT` =100 ステップ 3: 統合プロファイル ID によって統合連絡先の詳細を照会する統合連絡先メール `SELECT` EmailAddress__c `FROM` UnifiedContactPointEmail__dlm `WHERE` PartyId__c={UnifiedRecordId__c} `LIMIT` =100 統合連絡先電話 `SELECT` TelephoneNumber__c `FROM` UnifiedContactPointPhone__dlm `WHERE` PartyId__c={UnifiedRecordId__c} `LIMIT` =100

使用事例

クエリ

データプレビュー:

データレークオブジェクトに取り込まれたデータを調べます。

メールのクリックイベントを取得する SELECT SubscriberKey__c, EngagementChannel__c, EmailName__c, SubjectLine__c FROM sfmc_email_engagement_click_{EID}__dll LIMIT =100

同意の参照:

メールアドレス、電話番号、名および姓に基づいて、連絡先データモデルから個人 ID を取得します。

メールアドレスによって個人 ID を取得する

SELECT PartyId__c FROM ContactPointEmail__dlm WHERE EmailAddress__c=’jjones@email.com’ LIMIT =100

電話番号によって個人 ID を取得する SELECT PartyId__c FROM ContactPointPhone__dlm WHERE TelephoneNumber__c=’555-123-4567’ LIMIT =100

名前によって個人 ID を取得する SELECT IndividualId__c FROM Individual__dlm WHERE FirstName__c=’Jimmy’ AND LastName__c=’Smith’ LIMIT =100

統合プロファイルの参照:

取得元レコード ID によって統合個人と統合連絡先を取得します。

ステップ 1:

取得元レコード ID によって統合レコードを取得する

SELECT UnifiedRecordId__c FROM IndividualIdentityLink__dlm WHERE SourceRecordID__c='{sourceID}' LIMIT =100

ステップ 2:

統合プロファイル ID によって統合個人を照会する

SELECT FirstName__c, LastName__c FROM UnifiedIndividual__dlm WHERE Id__c='{UnifiedRecordId__c}' LIMIT =100

ステップ 3:

統合プロファイル ID によって統合連絡先の詳細を照会する

統合連絡先メール SELECT EmailAddress__c FROM UnifiedContactPointEmail__dlm WHERE PartyId__c={UnifiedRecordId__c} LIMIT =100

統合連絡先電話 SELECT TelephoneNumber__c FROM UnifiedContactPointPhone__dlm WHERE PartyId__c={UnifiedRecordId__c} LIMIT =100

REST API 開発者ガイド

Data Cloud のクエリプロファイルパラメーター

サポート対象 SOQL パラメーター

SOQL の制限

サンプルクエリ