教程:使用适用于 NoSQL 的 API 查询 Azure Cosmos DB

适用范围: NoSQL

NoSQL 的 Azure Cosmos DB 支持使用内置查询语法查询文档。 本文提供了一个示例文档和两个示例查询和结果。

本文涵盖以下任务:

  • 使用内置查询语法查询 NoSQL 数据

先决条件

本教程假定你已拥有 Azure Cosmos DB 帐户、数据库和容器。

没有这些资源? 完成快速入门:从 Azure 门户创建 Azure Cosmos DB 帐户、数据库、容器和项

可以使用 REST API各种 SDK 来运行查询。

有关查询的详细信息,请参阅开始使用查询

示例文档

本文中的查询使用下面的示例文档。

{
  "id": "WakefieldFamily",
  "parents": [
    { "familyName": "Wakefield", "givenName": "Robin" },
    { "familyName": "Miller", "givenName": "Ben" }
  ],
  "children": [
    {
      "familyName": "Merriam", 
      "givenName": "Jesse", 
      "gender": "female", "grade": 1,
      "pets": [
          { "givenName": "Goofy" },
          { "givenName": "Shadow" }
      ]
    },
    { 
      "familyName": "Miller", 
        "givenName": "Lisa", 
        "gender": "female", 
        "grade": 8 
    }
  ],
  "address": { "state": "NY", "county": "Manhattan", "city": "NY" },
  "creationDate": 1431620462,
  "isRegistered": false
}

选择所有字段并应用筛选器

在示例家庭文档中,以下查询返回 ID 字段匹配 WakefieldFamily 的文档。 由于它是 SELECT * 语句,因此该查询的输出为完整的 JSON 文档:

查询:

SELECT * 
FROM Families f 
WHERE f.id = "WakefieldFamily"

结果:

{
  "id": "WakefieldFamily",
  "parents": [
    { "familyName": "Wakefield", "givenName": "Robin" },
    { "familyName": "Miller", "givenName": "Ben" }
  ],
  "children": [
    {
      "familyName": "Merriam", 
      "givenName": "Jesse", 
      "gender": "female", "grade": 1,
      "pets": [
          { "givenName": "Goofy" },
          { "givenName": "Shadow" }
      ]
    },
    { 
      "familyName": "Miller", 
        "givenName": "Lisa", 
        "gender": "female", 
        "grade": 8 
    }
  ],
  "address": { "state": "NY", "county": "Manhattan", "city": "NY" },
  "creationDate": 1431620462,
  "isRegistered": false
}

选择子集合字段的叉积

下一查询返回家族中所有 ID 匹配 WakefieldFamily 的子女的名字。

查询:

SELECT c.givenName 
FROM Families f 
JOIN c IN f.children 
WHERE f.id = 'WakefieldFamily'

结果:

[
  {
    "givenName": "Jesse"
  },
  {
    "givenName": "Lisa"
  }
]

后续步骤

在本教程中,已完成以下任务:

  • 了解了如何使用内置查询语法进行查询

现可继续学习下一教程,了解如何多区域分发数据。