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`
日期	一種資料類型，可用來根據年、月和日建立日期，作為整數參數。格式為 `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。如需分段的詳細資訊，請參閱細分概述.