CloudantDB数组查询如何仅返回单个元素？

嘿，我来帮你搞定在CloudantDB里查询数组字段时只提取单个元素的问题，下面结合示例文档、查询语句和期望结果一步步说明，保证清晰易懂～

先看示例文档 #

我们用一个典型的订单文档来演示：

{
  "_id": "order_123",
  "customer_id": "cust_456",
  "order_date": "2024-05-20",
  "items": [
    {
      "product_id": "prod_001",
      "name": "Wireless Headphones",
      "price": 199.99,
      "quantity": 1
    },
    {
      "product_id": "prod_002",
      "name": "USB-C Charger",
      "price": 29.99,
      "quantity": 2
    }
  ]
}

方法1：按数组索引提取（已知位置） #

如果你明确知道要取的元素在数组中的位置（比如第一个元素，索引为0），可以直接在Mango查询的投影（fields）里指定索引。

查询语句 #

{
  "selector": {
    "_id": "order_123"
  },
  "fields": [
    "_id",
    "customer_id",
    "items[0]"
  ]
}

期望结果 #

返回的结果里，items字段只会包含索引0的元素，仍然以数组形式呈现：

{
  "_id": "order_123",
  "customer_id": "cust_456",
  "items": [
    {
      "product_id": "prod_001",
      "name": "Wireless Headphones",
      "price": 199.99,
      "quantity": 1
    }
  ]
}

如果想把元素直接作为单个对象（而非数组）返回，可以用聚合管道结合$arrayElemAt操作符：

聚合查询语句 #

{
  "aggregate": [
    {
      "$match": {
        "_id": "order_123"
      }
    },
    {
      "$project": {
        "_id": 1,
        "customer_id": 1,
        "first_item": { "$arrayElemAt": ["$items", 0] }
      }
    }
  ]
}

聚合查询结果 #

这里first_item就是单个对象了，非常直观：

{
  "_id": "order_123",
  "customer_id": "cust_456",
  "first_item": {
    "product_id": "prod_001",
    "name": "Wireless Headphones",
    "price": 199.99,
    "quantity": 1
  }
}

小贴士：如果要取数组的最后一个元素，把索引改成-1就行：{ "$arrayElemAt": ["$items", -1] }

方法2：按条件匹配提取（未知位置） #

如果不知道元素的索引，但知道匹配条件（比如要找某个product_id的商品），可以用$elemMatch或者聚合管道的$filter来实现。

用$elemMatch的Mango查询 #

查询语句

{
  "selector": {
    "_id": "order_123"
  },
  "fields": [
    "_id",
    "customer_id",
    { "items": { "$elemMatch": { "product_id": "prod_002" } } }
  ]
}

期望结果

items字段会返回数组中第一个符合条件的元素，仍然是数组形式：

{
  "_id": "order_123",
  "customer_id": "cust_456",
  "items": [
    {
      "product_id": "prod_002",
      "name": "USB-C Charger",
      "price": 29.99,
      "quantity": 2
    }
  ]
}

用聚合管道提取单个对象 #

如果想要直接得到单个对象而非数组，结合$filter和$arrayElemAt：

聚合查询语句

{
  "aggregate": [
    {
      "$match": {
        "_id": "order_123"
      }
    },
    {
      "$project": {
        "_id": 1,
        "customer_id": 1,
        "matching_item": {
          "$arrayElemAt": [
            { "$filter": {
                "input": "$items",
                "as": "item",
                "cond": { "$eq": ["$$item.product_id", "prod_002"] }
              }
            },
            0
          ]
        }
      }
    }
  ]
}

聚合查询结果

这里matching_item就是单个匹配的对象：

{
  "_id": "order_123",
  "customer_id": "cust_456",
  "matching_item": {
    "product_id": "prod_002",
    "name": "USB-C Charger",
    "price": 29.99,
    "quantity": 2
  }
}

总结一下 #

• 已知元素索引：用投影的array[index]快速获取（返回数组），或聚合$arrayElemAt获取单个对象
• 按条件匹配：用$elemMatch返回数组形式的匹配元素，或聚合$filter+$arrayElemAt返回单个对象

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