定义
MongoDB Search 中的 in 操作符在给定路径中搜索 BSON number、date、boolean、objectId、uuid 或 string 值的数组,并返回字段值等于指定数组中的任何值的文档。如果字段包含一个数组,则 in 操作符选择字段包含数组的文档,并且该数组至少包含一个与指定数组中的任何值匹配的元素。
语法
in操作符的语法如下:
{ $search: { "index": <index name>, // optional, defaults to "default" "in": { "path": "<field-to-search>", "score": <options>, "value": <single-or-array-of-values-to-search>, "doesNotAffect": "<facet-to-exclude>" | [<array-of-facets>] } }}字段
字段 | 类型 | 说明 | 必要性 |
|---|---|---|---|
| 字符串或字符串数组 | 必需 | |
| 对象 | 分配给匹配搜索词结果的分数。使用以下选项之一修改分数:
| Optional |
| 必需 | ||
| 字符串或字符串数组 | 要从基于此查询的计数重新计算中排除的分面(Facet)或分面(Facet)列表。值必须是 | Optional |
示例
以下示例使用 in 操作符查询 sample_analytics.customers 集合中的集合。如果您在集群上加载示例数据并创建一个名为 default 的 MongoDB Search 索引,该索引使用集合上的静态映射,则可以对集合运行以下查询。
样本索引
示例索引定义指定了以下操作,以支持针对集合中索引字段的 in 操作员查询:
自动索引集合中所有可动态索引的字段。
将
name字段静态索引为词元类型,并将字段中的文本转换为小写。
{ "mappings": { "index": "default", "dynamic": true, "fields": { "name": { "normalizer": "lowercase", "type": "token" } } }}要学习;了解如何创建MongoDB搜索索引,请参阅管理MongoDB搜索索引。
样本查询
以下查询使用 in 操作符在Atlas Search birthdate 字段(包含单个值)中查找出生在给定日期的客户。 该查询使用$project阶段执行以下操作:
省略结果中的
_id字段。在结果中仅包含
name和birthdate字段。
db.customers.aggregate([ { "$search": { "in": { "path": "birthdate", "value": [ISODate("1977-03-02T02:20:31.000+00:00"), ISODate("1977-03-01T00:00:00.000+00:00"), ISODate("1977-05-06T21:57:35.000+00:00")] } } }, { "$project": { "_id": 0, "name": 1, "birthdate": 1 } }])[ { name: 'Elizabeth Ray', birthdate: ISODate("1977-03-02T02:20:31.000Z") }, { name: 'Brad Cardenas', birthdate: ISODate("1977-05-06T21:57:35.000Z") }]MongoDB Search 会返回与查询中指定的日期相匹配的两个文档。
以下查询使用in操作符查询accounts字段,其中包含一个数字数组,查找帐号为371138 、 371139或371140的客户。 该查询使用$project阶段执行以下操作:
省略结果中的
_id字段。在结果中仅包含
name和accounts字段。
db.customers.aggregate([ { "$search": { "in": { "path": "accounts", "value": [371138, 371139, 371140] } } }, { "$project": { "_id": 0, "name": 1, "accounts": 1 } }])[ { name: 'Elizabeth Ray', accounts: [ 371138, 324287, 276528, 332179, 422649, 387979 ] }]MongoDB Search 仅返回一个与查询中指定的帐号 371138 匹配的文档。
以下查询使用text操作符查询name字段中名字为James的客户。 该查询使用in操作符为与_id字段中给定 objectId 关联的客户指定偏好。 查询使用$limit阶段将输出限制为5个结果,并使用$project阶段限制输出:
在结果中仅包含
_id和name字段。将名为
score的字段添加到结果中。
db.customers.aggregate([ { "$search": { "compound": { "must": [{ "in": { "path": "name", "value": ["james sanchez", "jennifer lawrence"] } }], "should": [{ "in": { "path": "_id", "value": [ObjectId("5ca4bbcea2dd94ee58162a72"), ObjectId("5ca4bbcea2dd94ee58162a91")] } }] } } }, { "$limit": 5 }, { "$project": { "_id": 1, "name": 1, "score": { $meta: "searchScore" } } }])[ { _id: ObjectId("5ca4bbcea2dd94ee58162a72"), name: 'James Sanchez', score: 2 }, { _id: ObjectId("5ca4bbcea2dd94ee58162a71"), name: 'Jennifer Lawrence', score: 1 }]MongoDB Search 返回在 name字段中包含 James Sanchez 和 Jennifer Lawrence 的文档。MongoDB搜索对包含 name: 'James Sanchez' 的文档评分较高,因为它与 should 子句中指定的 ObjectId 匹配。
分面查询
以下查询使用 in 操作符在 active 字段中搜索包含布尔值的活跃客户。该查询返回出生日期属于以下区间的活跃客户数量:
1970-01-01,包括此存储桶的下限
1980-01-01,1970-01-01 存储桶的不含上限以及此存储桶的包含下限
1990-01-01,1980-01-01 存储桶的不含上限以及此存储桶的包含下限
2000-01-01,作为 1990-01-01 分段的排除性上界
db.customers.aggregate([ { "$searchMeta": { "facet": { "operator": { "in": { "path": "active", "value": null } }, "facets": { "birthdateFacet": { "type": "date", "path": "birthdate", "boundaries": [ISODate("1970-01-01"), ISODate("1980-01-01"), ISODate("1990-01-01"), ISODate("2000-01-01")], "default": "other" } } } } }])[ { count: { lowerBound: Long('1') }, facet: { birthdateFacet: { buckets: [ { _id: ISODate('1970-01-01T00:00:00.000Z'), count: Long('1') }, { _id: ISODate('1980-01-01T00:00:00.000Z'), count: Long('0') }, { _id: ISODate('1990-01-01T00:00:00.000Z'), count: Long('0') } ] } } }]