通配符索引（Wildcard Indexes）：MongoDB 4.2 版本中的新功能。
为了更高效地查询，MongoDB 支持在单字段或多字段上创建索引。由于 MongoDB 支持动态模式，应用程序可以查询那些无法事先知道名称的字段。
MongoDB 4.2 引入了通配符索引，以支撑针对未知或任意字段的查询。
设计一个应用程序，它在 userMetadata 字段下捕获用户定义的数据，并支持对这些数据进行查询：
{ "userMetadata" : { "likes" : [ "dogs", "cats" ] } }
{ "userMetadata" : { "dislikes" : "pickles" } }
{ "userMetadata" : { "age" : 45 } }
{ "userMetadata" : "inactive" }
管理员（Administrators）希望创建索引来支持对 userMetadata 的任何子字段的查询。
UserMetadata 上的通配符索引可以支持 userMetadata，userMetadata.likes，userMetadata.dislikes 和 userMetadata.age 的单字段查询，索引创建如下：
db.userData.createIndex( { "userMetadata.$**" : 1 } )
索引可以支持以下查询：
db.userData.find({ "userMetadata.likes" : "dogs" })
db.userData.find({ "userMetadata.dislikes" : "pickles" })
db.userData.find({ "userMetadata.age" : { $gt : 30 } })
db.userData.find({ "userMetadata" : "inactive" })
userMetadata 的非通配符索引（non-wildcard index）只能支持对 userMetadata 值的查询。
⚠️ 重要：
通配符索引（Wildcard indexes）不是用来替代传统索引的。有关创建索引的详细信息，请参阅创建支持查询的索引（Create Indexes to Support Your Queries）。有关通配符索引限制的完整文档，请参见通配符索引限制（Wildcard Index Restrictions）。
创建通配符索引
⚠️ 重要：
mongod 的功能兼容性版本（featureCompatibilityVersion）必须是 v4.2 才支撑创建通配符索引。有关设置 fCV 的说明，请参照如何在 MongoDB 6.0 部署中设置特性兼容版本（Set Feature Compatibility Version on MongoDB 6.0 Deployments.）
创建通配符索引，您可以使用 createIndex 数据库命令或它的 mongosh 方法： createIndex() 或 createIndexes()。
在字段上创建通配符索引
为指定字段的值创建索引：
db.collection.createIndex( { "fieldA.$**" : 1 } )
使用这个通配符索引，MongoDB 对 fieldA 的所有值进行索引。如果字段是嵌套的文档或数组，则通配符索引递归到文档/数组中，并存储文档/数组中所有字段的值。
例如，product_catalog 集合中的文档可能包含 product_attributes 字段。product_attributes 字段可以包含任意的嵌套字段、嵌入式文档和数组：
{
"product_name" : "Spy Coat",
"product_attributes" : {
"material" : [ "Tweed", "Wool", "Leather" ]
"size" : {
"length" : 72,
"units" : "inches"
}
}
}
{
"product_name" : "Spy Pen",
"product_attributes" : {
"colors" : [ "Blue", "Black" ],
"secret_feature" : {
"name" : "laser",
"power" : "1000",
"units" : "watts",
}
}
}
以下操作在 product_attributes 字段上创建通配符索引：
db.products_catalog.createIndex( { "product_attributes.$**" : 1 } )
通配符索引可以支持对 product_attributes 或其嵌入字段的任意单字段查询：
db.products_catalog.find( { "product_attributes.size.length" : { $gt : 60 } } )
db.products_catalog.find( { "product_attributes.material" : "Leather" } )
db.products_catalog.find( { "product_attributes.secret_feature.name" : "laser" } )
📒 注意：
特殊路径的通配符索引语法与通配符用法不兼容时，参照 Options for wildcard indexes 获取更多的帮助。
有关示例，参见文档内容：在单个字段路径上创建通配符索引（Create a Wildcard Index on a Single Field Path.）
在所有字段上创建通配符索引
以 "$**" 作为索引的关键字，对文档中所有字段（ _id 除外）的值进行索引：
db.collection.createIndex( { "$**" : 1 } )
使用此通配符索引，MongoDB 可以对集合中每个文档的所有字段进行索引。
如果给定的字段是嵌套的文档或数组，则通配符索引递归到文档/数组中，并存储文档/数组中所有字段的值。
有关示例，参见文档内容：在所有字段路径上创建通配符索引（Create a Wildcard Index on All Field Paths）。
📒 注意：
默认情况下，通配符索引忽略 _ id字段。要在通配符索引中包含 _ id 字段，必须在通配符投影文档中显式地包含它。更多有关信息，参见通配符索引（wildcard indexes）的选项（Options for wildcard indexes）。
在多个特定字段上创建通配符索引
对文档中指定多个字段的值创建索引：
db.collection.createIndex(
{ "$**" : 1 },
{ "wildcardProjection" :
{ "fieldA" : 1, "fieldB.fieldC" : 1 }
}
)
使用此通配符索引，MongoDB 对集合中每个文档的指定字段的所有值进行索引。
如果给定的字段是嵌套的文档或数组，则通配符索引递归到文档/数组中，并存储文档/数组中所有字段的值。
📒 注意：
通配符索引不支持在通配符投影文档中混合包含和写排除语句，想对 _ id 字段创建索引，只能显式包含。有关通配符投影（wildcardProjection）的更多信息，参见通配符索引的选项（Options for wildcard indexes）。
有关示例，参见在通配符索引中覆盖指定字段（Include Specific Fields in Wildcard Index Coverage）。
创建排除多个特定字段的通配符索引
对文档中不包括特定字段路径的所有字段创建索引：
db.collection.createIndex(
{ "$**" : 1 },
{ "wildcardProjection" :
{ "fieldA" : 0, "fieldB.fieldC" : 0 }
}
)
如此使用通配符索引，MongoDB 将对集合中的每个文档的所有字段（不包括指定的字段路径）进行索引。
如果给定的字段是嵌套的文档或数组，则通配符索引递归到文档/数组中，并存储文档/数组中所有字段的值。
请参照：从通配符索引覆盖中省略特定字段（Omit Specific Fields from Wildcard Index Coverage）。
📒 注意：
通配符索引不支持在通配符投影（wildcardProjection）文档中混合包含和排除语句，除非显式包含 _ id 字段。有关通配符投影（wildcardProjection）的更多信息，参见通配符索引的选项（Options for wildcard indexes）。
注意事项
通配符索引在任何指定的查询条件中最多只能支持一个字段。有关通配符索引查询的更多信息，参见 Wildcard Index Query/Sort Support。
mongd 的功能兼容版本（featureCompatibilityVersion）必须是4.2才能创建通配符索引。有关设置 fCV 的说明，参见 Set Feature Compatibility Version on MongoDB 6.0 Deployments。
默认情况下，通配符索引省略 _id 字段。要在通配符索引中包含 _id 字段，必须在通配符投影文档 wildcardProjection（即{“ _ id”: 1}）中显式包含它。
可以在集合（collection）中创建多个通配符索引。
通配符索引可以覆盖与集合（collection）中的其他索引相同的字段。
通配符索引是稀疏索引（Sparse Indexes），只包含具有索引字段的文档的条目，允许索引字段包含空值。
特性
通配符索引在索引对象（即嵌入式文档 embedded document）或数组字段时具有递归遍历的特性：
如果字段是一个对象（object），则通配符索引将递归到该对象的最后一层嵌套，并对其内容进行索引。
如果该字段是一个数组，则通配符索引将遍历该数组并对每个元素进行索引：
如果数组中的某个元素是一个对象，则通配符索引将深入到该对象中，以按照上面所述对其内容进行索引。
如果元素是一个数组——即直接嵌入在父数组中的数组——那么通配符索引不会遍历嵌入的数组，而是将整个数组作为单个值进行索引。
对于所有其他字段，将基础原语 primitive（非对象/数组）的值记录到索引中。
通配符索引持续遍历任何其他嵌套对象或数组，直到达到一个基本值（即不是对象或数组的字段）。然后对这个基本值以及该字段的完整路径进行索引。
例如：
{
"parentField" : {
"nestedField" : "nestedValue",
"nestedObject" : {
"deeplyNestedField" : "deeplyNestedValue"
},
"nestedArray" : [
"nestedArrayElementOne",
[ "nestedArrayElementTwo" ]
]
}
}
包含 parentField 的通配符索引记录下列条目：
"parentField.nestedField" : "nestedValue"
"parentField.nestedObject.deeplyNestedField" : "deeplyNestedValue"
"parentField.nestedArray" : "nestedArrayElementOne"
"parentField.nestedArray" : ["nestedArrayElementTwo"]
📒 注意：
parentField.nestedArray 的记录是无序的。通配符索引在将元素写到索引中时忽略数组元素的位置。通配符索引仍然可以支持含有显式数组索引的查询。参照 Queries with Explicit Array Indices 获取详情。
有关嵌套对象的通配符索引行为的更多信息，请参阅：Nested Objects。
有关嵌套数组的通配符索引行为的详细信息，请参阅：Nested Arrays。
嵌套对象（Nested Objects）
当通配符索引遇到嵌套对象时，它会遍历到对象中并对其内容进行索引。例如：
{
"parentField" : {
"nestedField" : "nestedValue",
"nestedArray" : ["nestedElement"]
"nestedObject" : {
"deeplyNestedField" : "deeplyNestedValue"
}
}
}
一个通配符索引，其中包含 parentField，它深入到对象中以遍历和索引其内容：
字段本身是一个对象（例如一个嵌入式文档） ，下降到该对象以索引其内容。
作为数组的字段，遍历数组并索引其内容。
其他字段，将基本元素（非对象/数组）值记录到索引中。
通配符索引继续遍历任何其他嵌套对象或数组，直到达到一个基本值（即不是对象或数组的字段）。然后对该基元值以及该字段的完整路径进行索引。
给定示例文档，通配符索引将以下记录添加到索引中：
"parentField.nestedField" : "nestedValue"
"parentField.nestedObject.deeplyNestedField" : "deeplyNestedValue"
"parentField.nestedArray" : "nestedElement"
有关嵌套数组的通配符索引行为的更多信息，请参阅：Nested Arrays。
嵌套数组（Nested Arrays）
当通配符索引遇到嵌套数组时，它尝试遍历数组以索引其元素。如果数组本身是父数组（即嵌入数组）中的一个元素，则通配符索引将整个数组记录为一个值，而不是遍历其内容。例如：
{
"parentArray" : [
"arrayElementOne",
[ "embeddedArrayElement" ],
"nestedObject" : {
"nestedArray" : [
"nestedArrayElementOne",
"nestedArrayElementTwo"
]
}
]
}
一个通配符索引，其中包含 parentField ，它深入到对象中以遍历和索引其内容：
字段本身是一个对象（例如一个嵌入式文档） ，下降到该对象以索引其内容。
作为数组的字段，遍历数组并索引其内容。
其他字段，将基本元素（非对象/数组）值记录到索引中。
通配符索引继续遍历任何其他嵌套对象或数组，直到达到一个基本值（即不是对象或数组的字段）。然后对该基元值以及该字段的完整路径进行索引。
给定示例文档，通配符索引将以下记录添加到索引中：
"parentArray" : "arrayElementOne"
"parentArray" : ["embeddedArrayElement"]
"parentArray.nestedObject.nestedArray" : "nestedArrayElementOne"
"parentArray.nestedObject.nestedArray" : "nestedArrayElementTwo"
注意，parentField.nestedArray 的记录不包括每个元素的数组位置。通配符索引在将元素记录到索引中时忽略数组元素的位置。通配符索引仍然可以支持包含显式数组索引的查询。请参阅：Queries with Explicit Array Indices
📒 TIP：
另见：BSON 文档的嵌套深度 Nested Depth for BSON Documents
限制条件
不能使用通配符索引分片集合。在要分片的一个或多个字段上创建非通配符索引。有关选择碎片键的详细信息，请参阅碎片键（Shard Keys）。
不能创建复合索引。
不能为通配符索引指定下列属性：
TTL
Unique
不能使用通配符语法创建下列索引类型：
2d（地理空间）
2dsphere（地理空间）
Hashed
⚠️ 重要：
通配符索引与通配符文本索引（Wildcard Text Indexes）不同且不兼容。通配符索引不支持使用 $Text 运算符的查询。
有关通配符索引创建限制的完整文档，参见不兼容索引类型或属性（Incompatible Index Types or Properties）。
通配符索引查询/排序支持
覆盖查询
通配符索引支持覆盖查询（covered query），必须满足以下所有条件：
满足查询条件的查询计划，可以利用通配符索引。
查询条件正好命中通配符索引所覆盖的一个字段。
排除了 _ id 字段，只包括查询字段。
指定的查询字段不能是数组。
例如 employees 集合上的以下通配符索引：
db.employees.createIndex( { "$**" : 1 } )
以下操作查询单个字段 lastName，并从结果文档中查询出所有其他字段：
db.employees.find(
{ "lastName" : "Doe" },
{ "_id" : 0, "lastName" : 1 }
)
如果 lastName 字段不是一个数组，则 MongoDB 可以使用 $* * 通配符索引来实现覆盖查询。
多字段查询语句
通配符索引最多只能支持一个查询谓词字段，即：
MongoDB 的查询条件不可以在使用通配符索引时还覆盖其他索引。
MongoDB 的查询条件不可以同时覆盖两个通配符索引。
一个通配符索引可以支持多个字段联合查询，也可以只使用通配符索引包含的其中一个字段查询。
但是，MongoDB 可以使用相同的通配符索引来满足 $or 聚合函数查询 或 $or 操作符查询。
查询排序
满足以下所有条件时，MongoDB 可以使用通配符索引来满足排序 sort ()：
查询条件对应的查询计划命中通配符索引。
只能针对查询条件中的字段 sort () 排序。
排序指定的字段不能是数组。
如果不满足上述条件，MongoDB 就不能使用通配符索引进行排序。有关详细信息，请参阅索引交集和排序（Index Intersection and Sort）。
例如 products 集合上的这个通配符索引：
db.products.createIndex( { "product_attributes.$**" : 1 } )
以下操作查询 product_attributes.price 字段， 并对其进行排序：
db.products.find(
{ "product_attributes.price" : { $gt : 10.00 } },
).sort(
{ "product_attributes.price" : 1 }
)
假设这个 price 字段不是数组，MongoDB 可以使用 product_attributes.$** 通配符索引，用于同时满足 find() 和 sort()。
不支持的查询模式
通配符索引不支持使用文档中不存在字段的查询。
通配符索引不支持检查字段是否等于文档或数组的查询条件。
通配符索引不支持检查字段是否为空的查询条件。
更多详细信息，参见不支持的查询和聚合模式（Unsupported Query and Aggregation Patterns）
使用显式数组索引的查询
MongoDB 通配符索引在索引期间不记录数组中任何元素的数组位置。
但是，MongoDB 仍然可以选择通配符索引来响应一个查询，该查询包含一个或多个具有显式数组索引的字段路径（例如，parentArray.0.nestedArray.0）。
由于为多层嵌套数组定义索引边界的复杂性日益增加，如果查询中的给定字段路径包含超过 8 个显式数组索引，MongoDB 不会利用通配符索引来响应该路径。
MongoDB 仍然可以使用通配符索引来响应查询中的其他字段路径。
例如：
{
"parentObject" : {
"nestedArray" : [
"elementOne",
{
"deeplyNestedArray" : [ "elementTwo" ]
}
]
}
}
MongoDB 可以选择一个包含 parentObject 的通配符索引来满足以下查询：
"parentObject.nestedArray.0" : "elementOne"
"parentObject.nestedArray.1.deeplyNestedArray.0" : "elementTwo"
如果查询条件中的给定字段路径使用了超过 8 个显式数组索引，MongoDB 不会利用通配符索引来响应该字段路径。
MongoDB 要么选择另一个符合条件的索引来响应查询，要么执行全表扫描。
注意，通配符索引本身并不限制它们遍历文档的深度，这种限制只适用于显式指定精确数组索引的查询。
在没有显式数组索引的情况下，发出相同的查询，MongoDB 可以选择通配符索引来响应查询：
"parentObject.nestedArray" : "elementOne
"parentObject.nestedArray.deeplyNestedArray" : "elementTwo"
上一条：Zemax OpticStudio2022安装教程
下一条：Zemax光学设计优化方法
沪公网安备31011302006932号