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

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

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

PQL支援以下常值類型：

常值	定義	範例
字串	由雙引號圍繞的字元組成的資料類型。	`"pizza"`, `"jobs"`, `"antidisestablishmentarianism"`
布林值	True或false的資料類型。	`true`, `false`
整數	表示整數的資料類型。可以是正面、負面或零。	`-201`, `0`, `412`
雙倍	表示任何實數的資料類型。可以是正面、負面或零。	`-51.24`, `3.14`, `0.6942058`
日期	一種資料類型，可用來根據年、月和日建立日期作為整數參數。 It is formatted as `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元素執行基本算術。有關這些函式的更多資訊，請參閱算術函數檔案
彙總	用於將陣列的結果組合為單一結果。有關聚合函式的詳細資訊，請參見聚合函數文檔。
日期和時間	與日期、時間和日期時間對象一起使用。有關這些函式的更多資訊，請參閱日期／時間函式檔案。
篩選	用於篩選陣列內的資料。有關這些函式的更多資訊，請參閱篩選函式文檔。
邏輯量詞	用於斷言陣列中的條件。在邏輯量詞文檔中可以找到更多資訊。
其他	不適用於上述任何類別的函式可在其他函式文件中找到。

現在您已學會如何使用，您 Profile Query Language可以在建立和修改區段時使用PQL。如需細分的詳細資訊，請閱讀分段概觀。