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的数据类型。 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元素执行基本算术。 有关这些函数的更多信息可在算术函数 文档中找到
聚合 用于将数组结果合并为单个结果。 有关聚合函数的更多信息,请参阅聚 合函数文档
日期和时间 与date、time和datetime对象结合使用。 有关这些函数的详细信息,请参 阅日期/时间函数文档
过滤器 用于筛选数组中的数据。 有关这些函数的更多信息,请参 阅过滤器函数文档
逻辑量词 用于在数组中声明条件。 更多信息可在逻辑量化符 文档中找到
其他 在杂项函数类别中可以找到不符合以上任何文档 的函数

后续步骤

您已经学习了如何使用PQL Profile Query Language,现在可以在创建和修改区段时使用PQL。 有关分段的详细信息,请阅读分段 概述

在此页面上