查询 - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

查询

本节介绍了使用 Amazon DocumentDB 进行查询的所有方面。

查询文档

有时,您可能需要查看在线商店的库存,这样客户就能看到并购买您销售的物品。查询集合相对容易,无论您想要集合中的所有文档,还是仅需要那些满足特定标准的文档。

要查询文档,请使用 find() 操作。find() 命令具有单个文档参数,该参数定义了在选择要返回的文档时要使用的标准。find() 的输出是一个文档,其格式为一行文本,不含换行符。要格式化输出文档,从而更加轻松地读取,请使用 find().pretty()。本主题中的所有示例都使用 .pretty() 设置输出的格式。

以下代码示例使用您插入到example前两个练习中的收藏 —insertOne()insertMany()位于的 “添加文档” 部分使用文档.

检索集合中的所有文档

要检索集合中的所有文档,请将 find() 操作和空查询文档结合使用。

以下查询返回 example 集合中的所有文档。

db.example.find( {} ).pretty()

检索与字段值匹配的文档

要检索与字段和值匹配的所有文档,请将 find() 操作和查询文档(标识要匹配的字段和值)结合使用。

通过使用前述文档,此查询将返回其中“Item”字段等于“Pen”的所有文档。

db.example.find( { "Item": "Pen" } ).pretty()

检索与嵌入文档匹配的文档

要查找与嵌入文档匹配的所有文档,请将 find() 操作和查询文档(指定嵌入文档名称和嵌入文档的所有字段和值)结合使用。

在与嵌入文档匹配时,该文档的嵌入文档的名称必须与查询中的名称相同。此外,嵌入文档中的字段和值必须与查询匹配。

以下查询仅返回“Poster Paint”文档。这是因为“Pen”具有不同的“OnHand”和“MinOnHand”值,并且“Spray Paint”比查询文档多一个字段 (OrderQnty)。

db.example.find({"Inventory": { "OnHand": 47, "MinOnHand": 50 } } ).pretty()

检索与嵌入文档中的字段值匹配的文档

要查找与嵌入文档匹配的所有文档,请将 find() 操作和查询文档(指定嵌入文档名称和嵌入文档的所有字段和值)结合使用。

考虑到上述文档,以下查询使用“点表示法”来指定嵌入文档和感兴趣的字段。将返回所有与这些内容匹配的文档,而不管嵌入文档中可能存在哪些其他字段。此查询将返回“Poster Paint”和“Spray Paint”,因为它们与指定的字段和值匹配。

db.example.find({"Inventory.OnHand": 47, "Inventory.MinOnHand": 50 }).pretty()

检索与数组匹配的文档

要查找所有与数组匹配的文档,请将 find() 操作和您感兴趣的数组名称以及数组中的所有值结合使用。此查询将返回所有包含带该名称的数组(其中数组值和顺序与查询中的完全相同)的文档。

以下查询仅返回“Pen”,因为“Poster Paint”具有其他颜色 (White),并且“Spray Paint”具有顺序不同的颜色。

db.example.find( { "Colors": ["Red","Green","Blue","Black"] } ).pretty()

检索与数组中的值匹配的文档

要查找所有具有特定数组值的文档,请将 find() 操作与您感兴趣的数组名称和值结合使用。

db.example.find( { "Colors": "Red" } ).pretty()

上述操作将返回所有三个文档,因为它们都有一个名为 Colors 的数组,并且此数组中的某个位置具有“Red”值。如果您指定值“White”,则查询将仅返回“Poster Paint”。

使用运算符检索文档

以下查询返回“Inventory.OnHand”值小于 50 的所有文档。

db.example.find( { "Inventory.OnHand": { $lt: 50 } } )

有关支持的查询运算符的列表,请参阅 查询和投影运算符

查询计划

如何查看查询计划的 executionStats

在确定查询的执行速度低于预期速度的原因时,了解查询计划的 executionStats 会很有用。executionStats 提供从特定阶段返回的文档数量 (nReturned)、在每个阶段花费的执行时间 (executionTimeMillisEstimate) 以及生成查询计划所需的时间长度 (planningTimeMillis)。您可以确定查询中最耗时的阶段,以帮助您根据 executionStats 的输出集中精力完成优化工作,如以下查询示例所示。executionStats 参数当前不支持 updatedelete 命令。

注意

Amazon DocumentDB 在利用分布式、容错、自修复的存储系统的专用数据库引擎上模拟 MongoDB 3.6 API。因此,查询计划和的输出explain()Amazon DocumentDB 和 MongoDB 之间可能有所不同。希望控制其查询计划的客户可以使用 $hint 运算符强制选择首选索引。

explain() 命令下运行要改进的查询,如下所示。

db.runCommand({explain: {query document}}). explain("executionStats").executionStats;

以下是操作示例。

db.fish.find({}).limit(2).explain("executionStats");

此操作的输出将类似于下文。

{ "queryPlanner" : { "plannerVersion" : 1, "namespace" : "test.fish", "winningPlan" : { "stage" : "SUBSCAN", "inputStage" : { "stage" : "LIMIT_SKIP", "inputStage" : { "stage" : "COLLSCAN" } } } }, "executionStats" : { "executionSuccess" : true, "executionTimeMillis" : "0.063", "planningTimeMillis" : "0.040", "executionStages" : { "stage" : "SUBSCAN", "nReturned" : "2", "executionTimeMillisEstimate" : "0.012", "inputStage" : { "stage" : "LIMIT_SKIP", "nReturned" : "2", "executionTimeMillisEstimate" : "0.005", "inputStage" : { "stage" : "COLLSCAN", "nReturned" : "2", "executionTimeMillisEstimate" : "0.005" } } } }, "serverInfo" : { "host" : "enginedemo", "port" : 27017, "version" : "3.6.0" }, "ok" : 1 }

如果您只想看到上面查询的 executionStats,您可以使用以下命令。对于较小的集合,如果性能增益微乎其微,Amazon DocumentDB 查询处理器可以选择不使用索引。

db.fish.find({}).limit(2).explain("executionStats").executionStats;

查询计划缓存

为了优化性能并缩短规划持续时间,Amazon DocumentDB 在内部缓存查询计划。这样就可以使用缓存的计划直接执行形状相同的查询。

但是,此缓存有时可能会导致同一查询的随机延迟;例如,运行通常需要一秒钟的查询偶尔需要十秒钟。这是因为随着时间的推移,读取器实例缓存了各种形状的查询,从而消耗内存。如果您遇到这种随机缓慢,则无需执行任何操作即可释放内存 —— 系统将为您管理内存使用情况,一旦内存达到一定阈值,它将自动释放。

EXplain 结果

如果您想返回有关查询计划的信息,Amazon DocumentDB 支持详细模式queryPlanner. 这些区域有:explain结果以类似于以下格式返回优化程序选择的选定查询计划:

{ "queryPlanner" : { "plannerVersion" : <int>, "namespace" : <string>, "winningPlan" : { "stage" : <STAGE1>, ... "inputStage" : { "stage" : <STAGE2>, ... "inputStage" : { ... } } } } }

以下各节将定义常见explain结果。

扫描和筛选阶段

优化程序可以选择下列扫描之一:

COLSCAN

这个阶段是顺序收藏扫描。

{ "stage" : "COLLSCAN" }

IXSCAN

此阶段将扫描索引键。优化程序可能会在此阶段内检索文档,这可能会导致稍后追加 FETCH 阶段。

db.foo.find({"a": 1}) { "stage" : "IXSCAN", "direction" : "forward", "indexName" : <idx_name> }

FETCH

如果优化程序在 IXSCAN 以外的阶段中检索文档,则结果将包括 FETCH 阶段。例如,上面的 IXSCAN 查询可能会导致 FETCH 和 IXSCAN 阶段的组合:

db.foo.find({"a": 1}) { "stage" : "FETCH", "inputStage" : { "stage" : "IXSCAN", "indexName" : <idx_name> } }

IXONLYSAN 仅扫描索引键。创建复合索引不会避免 FETCH。

索引交叉

IXAND

如果 Amazon DocumentDB 可以利用索引交叉点,则可能包括一个具有 IXSCAN InputStage 数组的 IXAND 舞台。例如,我们可能会看到如下输出:

{ "stage" : "FETCH", "inputStage" : { "stage" : "IXAND", "inputStages" : [ { "stage" : "IXSCAN", "indexName" : "a_1" }, { "stage" : "IXSCAN", "indexName" : "b_1" } ] } }

索引

IXOR

与索引交叉点类似,Amazon DocumentDB 可能包括IXOR阶段inputStages数组$or运算符。

db.foo.find({"$or": [{"a": {"$gt": 2}}, {"b": {"$lt": 2}}]})

对于上述查询,解释输出可能如下所示:

{ "stage" : "FETCH", "inputStage" : { "stage" : "IXOR", "inputStages" : [ { "stage" : "IXSCAN", "indexName" : "a_1" }, { "stage" : "IXSCAN", "indexName" : "b_1" } ] } }

多指数交口/联盟

Amazon DocumentDB 可以将多个索引交集或联合阶段组合在一起,然后获取结果。例如:

{ "stage" : "FETCH", "inputStage" : { "stage" : "IXOR", "inputStages" : [ { "stage" : "IXSCAN", ... }, { "stage" : "IXAND", "inputStages" : [ { "stage" : "IXSCAN", ... }, { "stage" : "IXSCAN", ... } ] } ] } }

索引交集或联合阶段的使用不受索引类型(稀疏、复合等)的影响。

复合索引

Amazon DocumentDB 复合索引索引的使用不受限于索引字段的开头子集;它可以使用带有后缀部分的索引,但可能不是很有效。

例如,的复合索引{ a: 1, b: -1 }可以支持以下所有三个查询:

db.orders.find( { a: 1 } } )

db.orders.find( { b: 1 } } )

db.orders.find( { a: 1, b: 1 } } )

排序阶段

如果请求的排序键上有索引,DocumentDB 可以使用索引来获取订单。在这种情况下,结果将不会包含SORT舞台,而是IXSCAN阶段。如果优化程序倾向于普通的排序,它将包括这样的阶段:

{ "stage" : "SORT", "sortPattern" : { "a" : 1, "b" : -1 } }

阶段

Amazon DocumentDB 支持两种不同的群组策略:

  • SORT_AGGREGATE: On disk sort aggregate.
  • HASH_AGGREGATE: In memory hash aggregate.