Query an Array of Embedded Documents查询嵌入文档的数组¶

Specify a Query Condition on a Field Embedded in an Array of Documents对嵌入在文档数组中的字段指定查询条件¶

If you do not know the index position of the document nested in the array, concatenate the name of the array field, with a dot (.) and the name of the field in the nested document.如果不知道嵌套在数组中的文档的索引位置，请将数组字段的名称与点（.）和嵌套文档中的字段名称连接起来。

The following example selects all documents where the instock array has at least one embedded document that contains the field qty whose value is less than or equal to 20:以下示例选择instock数组中至少有一个嵌入文档的所有文档，其中包含字段qty其值小于或等于20：

• Mongo Shell
• Compass
• Python
• Java (Sync)
• Node.js
• Other
  • PHP
  • Motor
  • Java (Async)
  • C#
  • Perl
  • Ruby
  • Scala
  • Go

db.inventory.find( { 'instock.qty': { $lte: 20 } } )

Copy the following filter into the Compass query bar and click Find:将以下筛选器复制到Compass查询栏中，然后单击“查找”：

{ 'instock.qty': { $lte: 20 } }

cursor = db.inventory.find({'instock.qty': {"$lte": 20}})

findIterable = collection.find(lte("instock.qty", 20));

const cursor = db.collection('inventory').find({
  'instock.qty': { $lte: 20 }
});

$cursor = $db->inventory->find(['instock.qty' => ['$lte' => 20]]);

cursor = db.inventory.find({'instock.qty': {"$lte": 20}})

findPublisher = collection.find(lte("instock.qty", 20));

var filter = Builders<BsonDocument>.Filter.Lte("instock.qty", 20);
var result = collection.Find(filter).ToList();

$cursor = $db->coll("inventory")->find( { 'instock.qty' => { '$lte' => 20 } } );

client[:inventory].find('instock.qty' => { '$lte' => 20 })

findObservable = collection.find(lte("instock.qty", 20))

cursor, err := coll.Find(
	context.Background(),
	bson.D{
		{"instock.qty", bson.D{
			{"$lte", 20},
		}},
	})

Use the Array Index to Query for a Field in the Embedded Document使用数组索引查询嵌入文档中的字段¶

Using dot notation, you can specify query conditions for field in a document at a particular index or position of the array. 使用点表示法，可以为文档中特定索引或数组位置的字段指定查询条件。The array uses zero-based indexing.该数组使用基于零的索引。

The following example selects all documents where the instock array has as its first element a document that contains the field qty whose value is less than or equal to 20:以下示例选择instock数组的第一个元素为包含字段qty（其值小于或等于20）的文档的所有文档：

• Mongo Shell
• Compass
• Python
• Java (Sync)
• Node.js
• Other
  • PHP
  • Motor
  • Java (Async)
  • C#
  • Perl
  • Ruby
  • Scala
  • Go

db.inventory.find( { 'instock.0.qty': { $lte: 20 } } )

Copy the following filter into the Compass query bar and click Find:将以下筛选器复制到Compass查询栏中，然后单击“查找”：

{ 'instock.0.qty': { $lte: 20 } }

cursor = db.inventory.find({'instock.0.qty': {"$lte": 20}})

findIterable = collection.find(lte("instock.0.qty", 20));

const cursor = db.collection('inventory').find({
  'instock.0.qty': { $lte: 20 }
});

$cursor = $db->inventory->find(['instock.0.qty' => ['$lte' => 20]]);

cursor = db.inventory.find({'instock.0.qty': {"$lte": 20}})

findPublisher = collection.find(lte("instock.0.qty", 20));

var filter = Builders<BsonDocument>.Filter.Lte("instock.0.qty", 20);
var result = collection.Find(filter).ToList();

$cursor = $db->coll("inventory")->find( { 'instock.0.qty' => { '$lte' => 20 } } );

client[:inventory].find('instock.0.qty' => { '$lte' => 20 })

findObservable = collection.find(lte("instock.0.qty", 20))

cursor, err := coll.Find(
	context.Background(),
	bson.D{
		{"instock.0.qty", bson.D{
			{"$lte", 20},
		}},
	})

A Single Nested Document Meets Multiple Query Conditions on Nested Fields单个嵌套文档满足嵌套字段的多个查询条件¶

Use $elemMatch operator to specify multiple criteria on an array of embedded documents such that at least one embedded document satisfies all the specified criteria.使用$elemMatch运算符在嵌入文档数组上指定多个条件，以便至少一个嵌入文档满足所有指定条件。

The following example queries for documents where the instock array has at least one embedded document that contains both the field qty equal to 5 and the field warehouse equal to A:以下示例查询instock数组中至少有一个包含字段qty等于5和字段warehouse等于A的嵌入文档的文档：

• Mongo Shell
• Compass
• Python
• Java (Sync)
• Node.js
• Other
  • PHP
  • Motor
  • Java (Async)
  • C#
  • Perl
  • Ruby
  • Scala
  • Go

db.inventory.find( { "instock": { $elemMatch: { qty: 5, warehouse: "A" } } } )

Copy the following filter into the Compass query bar and click Find:将以下筛选器复制到Compass查询栏中，然后单击“查找”：

{ "instock": { $elemMatch: { qty: 5, warehouse: "A" } } }

cursor = db.inventory.find(
    {"instock": {"$elemMatch": {"qty": 5, "warehouse": "A"}}})

findIterable = collection.find(elemMatch("instock", Document.parse("{ qty: 5, warehouse: 'A' }")));

const cursor = db.collection('inventory').find({
  instock: { $elemMatch: { qty: 5, warehouse: 'A' } }
});

$cursor = $db->inventory->find(['instock' => ['$elemMatch' => ['qty' => 5, 'warehouse' => 'A']]]);

cursor = db.inventory.find(
    {"instock": {"$elemMatch": {"qty": 5, "warehouse": "A"}}})

findPublisher = collection.find(elemMatch("instock", Document.parse("{ qty: 5, warehouse: 'A' }")));

var filter = Builders<BsonDocument>.Filter.ElemMatch<BsonValue>("instock", new BsonDocument { { "qty", 5 }, { "warehouse", "A" } });
var result = collection.Find(filter).ToList();

$cursor = $db->coll("inventory")->find(
    { instock => { '$elemMatch' => { qty => 5, warehouse => "A" } } }
);

client[:inventory].find(instock: { '$elemMatch' => { qty: 5,
                                                     warehouse: 'A' } })

findObservable = collection.find(elemMatch("instock", Document("qty" -> 5, "warehouse" -> "A")))

cursor, err := coll.Find(
	context.Background(),
	bson.D{
		{"instock", bson.D{
			{"$elemMatch", bson.D{
				{"qty", 5},
				{"warehouse", "A"},
			}},
		}},
	})

The following example queries for documents where the instock array has at least one embedded document that contains the field qty that is greater than 10 and less than or equal to 20:以下示例查询instock数组中至少有一个嵌入文档包含字段qty其值大于10且小于或等于20的文档：

• Mongo Shell
• Compass
• Python
• Java (Sync)
• Node.js
• Other
  • PHP
  • Motor
  • Java (Async)
  • C#
  • Perl
  • Ruby
  • Scala
  • Go

db.inventory.find( { "instock": { $elemMatch: { qty: { $gt: 10, $lte: 20 } } } } )

Copy the following filter into the Compass query bar and click Find:将以下筛选器复制到Compass查询栏中，然后单击“查找”：

{ "instock": { $elemMatch: { qty: { $gt: 10, $lte: 20 } } } }

cursor = db.inventory.find(
    {"instock": {"$elemMatch": {"qty": {"$gt": 10, "$lte": 20}}}})

findIterable = collection.find(elemMatch("instock", Document.parse("{ qty: { $gt: 10, $lte: 20 } }")));

const cursor = db.collection('inventory').find({
  instock: { $elemMatch: { qty: { $gt: 10, $lte: 20 } } }
});

$cursor = $db->inventory->find(['instock' => ['$elemMatch' => ['qty' => ['$gt' => 10, '$lte' => 20]]]]);

cursor = db.inventory.find(
    {"instock": {"$elemMatch": {"qty": {"$gt": 10, "$lte": 20}}}})

findPublisher = collection.find(elemMatch("instock", Document.parse("{ qty: { $gt: 10, $lte: 20 } }")));

var filter = Builders<BsonDocument>.Filter.ElemMatch<BsonValue>("instock", new BsonDocument { { "qty", new BsonDocument { { "$gt", 10 }, { "$lte", 20 } } } });
var result = collection.Find(filter).ToList();

$cursor = $db->coll("inventory") ->find(
    { instock => { '$elemMatch' => { qty => { '$gt' => 10, '$lte' => 20 } } } }
);

client[:inventory].find(instock: { '$elemMatch' => { qty: { '$gt'  => 10,
                                                            '$lte' => 20 } } })

findObservable = collection.find(elemMatch("instock", Document("""{ qty: { $gt: 10, $lte: 20 } }""")))

cursor, err := coll.Find(
	context.Background(),
	bson.D{
		{"instock", bson.D{
			{"$elemMatch", bson.D{
				{"qty", bson.D{
					{"$gt", 10},
					{"$lte", 20},
				}},
			}},
		}},
	})

Combination of Elements Satisfies the Criteria元素的组合满足标准¶

If the compound query conditions on an array field do not use the $elemMatch operator, the query selects those documents whose array contains any combination of elements that satisfies the conditions.如果数组字段上的复合查询条件不使用$elemMatch运算符，则查询将选择其数组包含满足条件的任何元素组合的文档。

For example, the following query matches documents where any document nested in the instock array has the qty field greater than 10 and any document (but not necessarily the same embedded document) in the array has the qty field less than or equal to 20:例如，以下查询匹配instock数组中嵌套的任何文档的qty字段大于10且数组中嵌套的任何文档（但不一定是同一嵌入文档）的qty字段小于或等于20的文档：

• Mongo Shell
• Compass
• Python
• Java (Sync)
• Node.js
• Other
  • PHP
  • Motor
  • Java (Async)
  • C#
  • Perl
  • Ruby
  • Scala
  • Go

db.inventory.find( { "instock.qty": { $gt: 10,  $lte: 20 } } )

Copy the following filter into the Compass query bar and click Find:将以下筛选器复制到Compass查询栏中，然后单击“查找”：

{ "instock.qty": { $gt: 10,  $lte: 20 } }

cursor = db.inventory.find({"instock.qty": {"$gt": 10, "$lte": 20}})

findIterable = collection.find(and(gt("instock.qty", 10), lte("instock.qty", 20)));

const cursor = db.collection('inventory').find({
  'instock.qty': { $gt: 10, $lte: 20 }
});

$cursor = $db->inventory->find(['instock.qty' => ['$gt' => 10, '$lte' => 20]]);

cursor = db.inventory.find({"instock.qty": {"$gt": 10, "$lte": 20}})

findPublisher = collection.find(and(gt("instock.qty", 10), lte("instock.qty", 20)));

var builder = Builders<BsonDocument>.Filter;
var filter = builder.And(builder.Gt("instock.qty", 10), builder.Lte("instock.qty", 20));
var result = collection.Find(filter).ToList();

$cursor = $db->coll("inventory")->find(
    { "instock.qty" => { '$gt' => 10, '$lte' => 20 } }
);

client[:inventory].find('instock.qty' => { '$gt' => 10, '$lte' => 20 })

findObservable = collection.find(and(gt("instock.qty", 10), lte("instock.qty", 20)))

cursor, err := coll.Find(
	context.Background(),
	bson.D{
		{"instock.qty", bson.D{
			{"$gt", 10},
			{"$lte", 20},
		}},
	})

The following example queries for documents where the instock array has at least one embedded document that contains the field qty equal to 5 and at least one embedded document (but not necessarily the same embedded document) that contains the field warehouse equal to A:以下示例查询instock数组中至少有一个包含字段qty等于5的嵌入文档和至少一个包含字段warehouse等于A的嵌入文档（但不一定是同一个嵌入文档）的文档：

• Mongo Shell
• Compass
• Python
• Java (Sync)
• Node.js
• Other
  • PHP
  • Motor
  • Java (Async)
  • C#
  • Perl
  • Ruby
  • Scala
  • Go

db.inventory.find( { "instock.qty": 5, "instock.warehouse": "A" } )

Copy the following filter into the Compass query bar and click Find:将以下筛选器复制到Compass查询栏中，然后单击“查找”：

{ "instock.qty": 5, "instock.warehouse": "A" }

cursor = db.inventory.find(
    {"instock.qty": 5, "instock.warehouse": "A"})

findIterable = collection.find(and(eq("instock.qty", 5), eq("instock.warehouse", "A")));

const cursor = db.collection('inventory').find({
  'instock.qty': 5,
  'instock.warehouse': 'A'
});

$cursor = $db->inventory->find(['instock.qty' => 5, 'instock.warehouse' => 'A']);

cursor = db.inventory.find(
    {"instock.qty": 5, "instock.warehouse": "A"})

findPublisher = collection.find(and(eq("instock.qty", 5), eq("instock.warehouse", "A")));

var builder = Builders<BsonDocument>.Filter;
var filter = builder.And(builder.Eq("instock.qty", 5), builder.Eq("instock.warehouse", "A"));
var result = collection.Find(filter).ToList();

$cursor = $db->coll("inventory")->find(
    { "instock.qty" => 5, "instock.warehouse" => "A" }
);

client[:inventory].find('instock.qty' => 5,
                        'instock.warehouse' => 'A')

findObservable = collection.find(and(equal("instock.qty", 5), equal("instock.warehouse", "A")))

cursor, err := coll.Find(
	context.Background(),
	bson.D{
		{"instock.qty", 5},
		{"instock.warehouse", "A"},
	})