如何使用N1QL查询Couchbase顶层数组中符合条件的元素

你的集合内单文档为顶层数组结构，要筛选数组中customerId等于指定值的元素，可根据返回需求选择以下两种写法：

1. UNNEST语法（返回独立的匹配元素） #

UNNEST是N1QL处理数组的标准语法，会将顶层数组的每个元素拆分为独立行，直接按元素属性过滤即可，适合需要拿到单个匹配元素结构化结果的场景：

-- 替换以下内容：
-- your_collection 替换为实际集合名
-- 1561 替换为你要匹配的目标值xyz
SELECT element
FROM your_collection
UNNEST your_collection AS element
WHERE element.customerId = 1561;

如果需要同时返回元素所属的原文档ID，可以把SELECT子句改成SELECT META(your_collection).id AS doc_id, element。

2. ARRAY_FILTER函数（返回匹配元素组成的子数组） #

如果你不需要拆分行，只需要从每个文档的顶层数组里筛出符合条件的元素、组装成子数组返回，可以用内置数组函数实现：

SELECT ARRAY_FILTER(your_collection, func(item) { item.customerId = 1561 }) AS matched_items
FROM your_collection
WHERE ANY item IN your_collection SATISFIES item.customerId = 1561 END;

语句中WHERE子句的作用是提前过滤掉完全不包含目标customerId的文档，减少无效计算。

性能优化提示 #

当集合数据量较大时，建议创建数组索引避免全文档扫描，索引语句如下：

CREATE INDEX idx_array_customerid ON your_collection(
  DISTINCT ARRAY item.customerId FOR item IN your_collection END
);

索引创建完成后上述两种查询均可自动命中索引，查询速度会有明显提升。

内容的提问来源于stack exchange，提问作者Debabrato Giri