如何让Couchbase N1QL查询返回扁平化itemID数组？

要得到你想要的扁平化数组格式，可以用N1QL的ARRAY_AGG()聚合函数结合DISTINCT实现去重并合并结果，具体有两种写法：

写法1：直接返回包含数组的对象 #

SELECT ARRAY_AGG(DISTINCT itemID) AS itemIDs
FROM main_bucket._default._default
WHERE createdDateTime > "2023-01-01T00:00:00";

返回结果格式：

{
  "itemIDs": ["515000", "514900", ...]
}

写法2：直接返回扁平化数组 #

用SELECT RAW可以跳过外层对象，直接输出数组：

SELECT RAW ARRAY_AGG(DISTINCT itemID)
FROM main_bucket._default._default
WHERE createdDateTime > "2023-01-01T00:00:00";

返回结果格式：

["515000", "514900", ...]

• 字段名空格问题：你提供的结果里有"itemID "（带末尾空格）的字段，说明部分文档字段名不一致。如果是输入失误，建议统一字段名为itemID；如果确实存在两种字段名，用COALESCE兼容：

  SELECT RAW ARRAY_AGG(DISTINCT COALESCE(itemID, `itemID `))
  FROM main_bucket._default._default
  WHERE createdDateTime > "2023-01-01T00:00:00";
  

  （注：带空格的字段名必须用反引号`包裹）

• 大数据量性能优化：数十万文档全表扫描会很慢，必须创建覆盖索引：

  CREATE INDEX idx_created_itemid ON main_bucket._default._default(createdDateTime) INCLUDE (itemID);
  

  这个索引包含查询需要的createdDateTime（过滤条件）和itemID（返回字段），查询时无需访问原文档，速度会大幅提升。

• ARRAY_AGG()：N1QL聚合函数，把多行值合并成一个数组，加DISTINCT自动去重。
• SELECT RAW：跳过默认的键值对包装，直接返回原始值，适合扁平化结果场景。
• 索引的必要性：Couchbase是分布式数据库，无索引的全表扫描在大数据量下性能极差，过滤条件字段一定要建索引，覆盖索引能进一步减少IO开销。

内容的提问来源于stack exchange，提问作者ciaran haines