教程:使用适用于 NoSQL 的 API 查询 Azure Cosmos DB
适用范围: NoSQL
NoSQL 的 Azure Cosmos DB 支持使用内置查询语法查询文档。 本文提供了一个示例文档和两个示例查询和结果。
本文涵盖以下任务:
- 使用内置查询语法查询 NoSQL 数据
先决条件
本教程假定你已拥有 Azure Cosmos DB 帐户、数据库和容器。
没有这些资源? 完成快速入门:从 Azure 门户创建 Azure Cosmos DB 帐户、数据库、容器和项。
有关查询的详细信息,请参阅开始使用查询。
示例文档
本文中的查询使用下面的示例文档。
{
"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"
}
]
后续步骤
在本教程中,已完成以下任务:
- 了解了如何使用内置查询语法进行查询
现可继续学习下一教程,了解如何多区域分发数据。