Profile Query Language (PQL)總覽

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

使用者

Profile Query Language (PQL)是符合Experience Data Model (XDM)的查詢語言，其設計可支援Real-Time Customer Profile資料的定義及分段查詢的執行。

本指南提供PQL的一般概述，涵蓋格式化指引，並提供PQL運算式範例。

PQL查詢格式

PQL查詢具有下列簽章：

({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}

輸入引數可以是簡單基本值（例如布林值或字串），或是更複雜的型別（例如物件、陣列或對應）。

在PQL運算式內文中，有三種不同的參考輸入引數方式：

第一個引數的隱含參照

在下列範例中，由於第一個引數一律在內容中，因此可以直接對其產生屬性參考(homeAddress)。

homeAddress.stateProvince = workAddress.stateProvince

第一個引數的明確參照

在下列範例中，$1參考第一個引數。因此，$2會參考第二個引數等。

$1.homeAddress.stateProvince = $1.homeAddress.stateProvince

使用具名變數，使用Lambda標籤法

在下列範例中，Profile是變數名稱，可由查詢作者選擇。

(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince

PQL文字

PQL支援下列常值型別：

常值

定義

範例

字串

由雙引號包住的字元所組成的資料型別。

"pizza"、"jobs"、"antidisestablishmentarianism"

布林值

為true或false的資料型別。

true、false

整數

代表整數的資料型別。可以是正數、負數或零。

-201、0、412

雙精度

代表任何實數的資料型別。可以是正數、負數或零。

-51.24、3.14、0.6942058

日期

一種資料型別，可用來依據年、月和日建立整數引數的日期。格式為date(year, month, day)

date(2020, 3, 14)

陣列

一種資料型別，由一組其他常值組成。它使用方括弧將不同值分組，並使用逗號分隔不同值。
注意： 您無法直接存取陣列中專案的屬性。因此，如果您需要存取陣列中的屬性，支援的方法是select X from array where X.item = ...。
PQL會保留xEvent這個字，以參照連結至設定檔的體驗事件陣列。

[1, 4, 7]、["US", "CA"]

相對時間參照

可用來形成時間戳記和時間間隔參照的保留字。

現在、今天、昨天、明天
這個、最後一個、下一個
之前、之後、從
毫秒、秒、分鐘、小時、天、周、月、年、十年、世紀/世紀、千年/千年

X.timestamp occurs before today、X.timestamp occurs last month、X.timestamp occurs <= 3 days before now

PQL函式

下表概述支援的PQL函式不同類別，包括其他檔案的連結，以取得詳細資訊。

類別

定義

布林值

用來在PQL中實作布林代數。在布林函式檔案中找到有關這些函式的詳細資訊。

比較

用來比較不同的PQL元素。您可以在比較函式檔案中找到有關這些函式的詳細資訊。

陣列、清單和設定

用於與陣列、清單和集合互動。在陣列、清單和設定函式檔案中可以找到有關這些函式的詳細資訊。

地圖

用於與地圖互動。在對應函式檔案中可以找到有關這些函式的詳細資訊。

字串

用於和字串互動。您可以在字串函式檔案中找到有關這些函式的詳細資訊。

物件

用於與物件互動。您可以在物件函式檔案中找到有關這些函式的詳細資訊。

算術

用來對PQL元素執行基本算術。您可以在算術函式檔案中找到有關這些函式的詳細資訊

彙總

用於將陣列的結果組合成單一結果。您可以在彙總函式檔案中找到彙總函式的詳細資訊。

日期和時間

與日期、時間和日期時間物件搭配使用。有關這些函式的詳細資訊，請參閱日期/時間函式檔案。

篩選器

用於篩選陣列中的資料。在篩選函式檔案中可以找到有關這些函式的詳細資訊。

邏輯數量詞

用來判斷陣列中的條件。在邏輯數量詞檔案中可以找到更多資訊。

其他

在雜項函式檔案中找到不符合上述任何類別的函式。

後續步驟

現在您已瞭解如何使用Profile Query Language，您可以在建立和修改區段定義時使用PQL。如需分段的詳細資訊，請參閱分段總覽。

recommendation-more-help

770bc05d-534a-48a7-9f07-017ec1e14871