如何用单条CosmosDB查询获取含指定邮箱用户的完整记录

首先假设你的文档结构类似这样：

{
  "id": "team_001",
  "teamName": "Engineering",
  "Users": [
    {
      "email": "john.doe@example.com",
      "role": "Developer"
    },
    {
      "email": "jane.smith@example.com",
      "role": "Manager"
    }
  ]
}

要单条查询返回Users数组包含指定邮箱的完整文档，不需要二次查询，用CosmosDB内置的ARRAY_CONTAINS函数即可，这是最直接高效的写法：

SELECT *
FROM c
WHERE ARRAY_CONTAINS(c.Users, { "email": "john.doe@example.com" }, true)

说明： #

• 第三个参数true表示精确匹配对象，如果你的Users数组里直接存邮箱字符串（而非对象），可以去掉这个参数或设为false。
• 该查询会直接返回所有满足条件的完整文档，无需先查id再二次查询。

如果更习惯用EXISTS子查询（避免构造对象的写法），正确语法如下（可解决你之前遇到的SC1001语法错误）：

SELECT *
FROM c
WHERE EXISTS(
    SELECT VALUE u
    FROM u IN c.Users
    WHERE u.email = "john.doe@example.com"
)

常见语法错误排查（针对SC1001）： #

• 子查询必须用FROM u IN c.Users遍历数组元素，不能直接写FROM c.Users
• 子查询中若无需返回元素内容，用SELECT VALUE u比SELECT *更高效，也能避免语法问题

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