数组、列表和设置函数
Profile Query Language (PQL)优惠函数可使与数组、列表和字符串的交互更简单。有关其他PQL函数的详细信息，请参阅Profile Query Language overview。
入
in函数用于确定项目是否是数组或列表的成员。
格式
{VALUE} in {ARRAY}
示例
以下PQL查询定义三月、六月或九月的生日。
person.birthMonth in [3, 6, 9]
不在
notIn函数用于确定项目是否不是数组或列表的成员。
notIn函数还确保这两个值均不等于null。 因此，结果不是对in函数的精确取反。
格式
{VALUE} notIn {ARRAY}
示例
以下PQL查询定义生日不在3月、6月或9月的人。
person.birthMonth notIn [3, 6, 9]
Intersects
intersects函数用于确定两个阵列或列表是否具有至少一个公共成员。
格式
{ARRAY}.intersects({ARRAY})
示例
以下PQL查询定义其最喜爱的颜色至少包括红色、蓝色或绿色之一的人。
person.favoriteColors.intersects(["red", "blue", "green"])
交集
intersection函数用于确定两个阵列或列表的公用成员。
格式
{ARRAY}.intersection({ARRAY})
示例
以下PQL查询定义人物1和人物2是否都具有最喜爱的红色、蓝色和绿色。
person1.favoriteColors.intersection(person2.favoriteColors) = ["red", "blue", "green"]
子集
subsetOf函数用于确定特定阵列（阵列A）是否是另一阵列（阵列B）的子集。 换句话说，数组A中的所有元素都是数组B的元素。
格式
{ARRAY}.subsetOf({ARRAY})
示例
以下PQL查询定义访问过其所有喜爱城市的人员。
person.favoriteCities.subsetOf(person.visitedCities)
超集
supersetOf函数用于确定特定阵列（阵列A）是否是另一阵列（阵列B）的超集。 换句话说，数组A包含数组B中的所有元素。
格式
{ARRAY}.supersetOf({ARRAY})
示例
以下PQL查询定义了至少吃过一次寿司和比萨的人。
person.eatenFoods.supersetOf(["sushi", "pizza"])
包括
includes函数用于确定数组或列表是否包含给定项。
格式
{ARRAY}.includes({ITEM})
示例
以下PQL查询定义其喜爱颜色包含红色的人。
person.favoriteColors.includes("red")
Distinct
distinct函数用于从数组或列表中删除重复值。
格式
{ARRAY}.distinct()
示例
以下PQL查询指定在多个商店中下订单的人员。
person.orders.storeId.distinct().count() > 1
分组依据
groupBy函数用于根据列表的值将数组或表达式的值划分到组中。
格式
{ARRAY}.groupBy({EXPRESSION)
| 参数 | 描述 |
|---|---|
{ARRAY} |
要分组的数组或列表。 |
{EXPRESSION} |
映射数组或列表中每个项的表达式返回。 |
示例
以下PQL查询将存储订单的所有订单分组。
orders.groupBy(storeId)
过滤器
filter函数用于根据表达式过滤数组或列表。
格式
{ARRAY}.filter({EXPRESSION})
| 参数 | 描述 |
|---|---|
{ARRAY} |
要筛选的数组或列表。 |
{EXPRESSION} |
要筛选的表达式。 |
示例
以下PQL查询定义所有21岁或以上的人。
person.filter(age >= 21)
地图
map函数用于通过对给定数组中的每个项应用表达式来创建新数组。
格式
array.map(expression)
示例
以下PQL查询将创建一个新的数字数组，并将原始数字的值用正方形表示。
numbers.map(square)
数组中的第一个n
topN函数用于返回数组中的前一个N项，当这些项基于给定的数字表达式按升序排序时。
格式
{ARRAY}.topN({VALUE}, {AMOUNT})
| 参数 | 描述 |
|---|---|
{ARRAY} |
要排序的数组或列表。 |
{VALUE} |
对数组或列表排序的属性。 |
{AMOUNT} |
要返回的项目数。 |
示例
以下PQL查询返回价格最高的前5个订单。
orders.topN(price, 5)
数组中最后一个n
bottomN函数用于返回数组中最后的N项，当这些项根据给定的数字表达式按升序排序时。
格式
{ARRAY}.bottomN({VALUE}, {AMOUNT})
| 参数 | 描述 |
|---|---|
{ARRAY} |
要排序的数组或列表。 |
{VALUE} |
对数组或列表排序的属性。 |
{AMOUNT} |
要返回的项目数。 |
示例
以下PQL查询返回价格最低的前5个订单。
orders.bottomN(price, 5)
第一项
head函数用于返回数组或列表中的第一个项。
格式
{ARRAY}.head()
示例
以下PQL查询返回价格最高的前五个订单中的第一个。 有关topN函数的详细信息，请参阅数组🔗部分的第一个n。
orders.topN(price, 5).head()
后续步骤
您已经了解了阵列、列表和设置函数，现在可以在PQL查询中使用它们。 有关其他PQL函数的详细信息，请阅读用户档案查询语言概述。
Business.Adobe.com资源
