Profile Query Language (PQL)總覽

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的資料型別。
truefalse
整數
代表整數的資料型別。 可以是正數、負數或零。
-2010412
雙精度
代表任何實數的資料型別。 可以是正數、負數或零。
-51.243.140.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 todayX.timestamp occurs last monthX.timestamp occurs <= 3 days before now

PQL函式

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

類別
定義
布林值
用來在PQL中實作布林代數。 在布林函式檔案中找到有關這些函式的詳細資訊。
比較
用來比較不同的PQL元素。 您可以在比較函式檔案中找到有關這些函式的詳細資訊。
陣列、清單和設定
用於與陣列、清單和集合互動。 在陣列、清單和設定函式檔案中可以找到有關這些函式的詳細資訊。
地圖
用於與地圖互動。 在對應函式檔案中可以找到有關這些函式的詳細資訊。
字串
用於和字串互動。 您可以在字串函式檔案中找到有關這些函式的詳細資訊。
物件
用於與物件互動。 您可以在物件函式檔案中找到有關這些函式的詳細資訊。
算術
用來對PQL元素執行基本算術。 您可以在算術函式檔案中找到有關這些函式的詳細資訊
彙總
用於將陣列的結果組合成單一結果。 您可以在彙總函式檔案中找到彙總函式的詳細資訊。
日期和時間
與日期、時間和日期時間物件搭配使用。 有關這些函式的詳細資訊,請參閱日期/時間函式檔案
篩選器
用於篩選陣列中的資料。 在篩選函式檔案中可以找到有關這些函式的詳細資訊。
邏輯數量詞
用來判斷陣列中的條件。 在邏輯數量詞檔案中可以找到更多資訊。
其他
雜項函式檔案中找到不符合上述任何類別的函式。

後續步驟

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

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871