mongodb 常用操作符

最近常用mongodb数据库，但是很多操作符不清楚或不知道，所有抽空根据手册整理下，以便于以后查阅(基于3.4版本)

1.查询和投影操作符

1.1比较操作符

$eq
匹配字段值等于指定值的文档

{ <field>: { $eq: <value> } }

$gt
匹配字段值大于指定值的文档

{ <field>: { $gt: <value> } }

$gte
匹配字段值大于等于指定值的文档

{ <field>: { $gte: <value> } }

$lt
匹配字段值小于指定值的文档

{ <field>: { $gte: <value> } }

$lte
匹配字段值小于等于指定值的文档

{ <field>: { $lte: <value> } }

$ne
匹配字段值不等于指定值的文档，包括没有这个字段的文档

{ <field>: { $ne: <value> } }

$in
匹配字段值等于指定数组中的任何值

{ field: { $in: [<value1>, <value2>, ... <valueN> ] } }

字段值为数组类型时，数组中至少有一个元素在指定数组中

{ _id: 1, item: "abc", qty: 10, tags: [ "school", "clothing" ], sale: false }db.inventory.update(                     { tags: { $in: ["appliances", "school"] } },                     { $set: { sale:true } }                   )sale值被成功改为true                   

$nin
字段值不在指定数组或者不存在

{ field: { $nin: [ <value1>, <value2> ... <valueN> ]} }

字段值为数组类型时，数组中没有一个元素与指定数组中元素相等

1.2逻辑操作符

$or
文档至少满足其中的一个表达式

{ $or: [ { <expression1> }, { <expression2> }, ... , { <expressionN> } ] }

$and

{ $and: [ { <expression1> }, { <expression2> } , ... , { <expressionN> } ] }

$not
字段值不匹配表达式或者字段值不存在

{ field: { $not: { <operator-expression> } } }

$nor
字段值不匹配所有的表达式的文档，包括那些不包含这些字段的文档

{ $nor: [ { <expression1> }, { <expression2> }, ...  { <expressionN> } ] }

1.3元素操作符

$exists
<boolean> 等于true时，字段存在，包括字段值为null的文档
<boolean> 等于false时，字段不存在

 { field: { $exists: <boolean> } }

$type
匹配字段值为指定数据类型的文档

{ field: { $type: <BSON type number> | <String alias> } }

Type Number Alias Notes Double 1 “double” String 2 “string” Object 3 “object” Array 4 “array” Binary data 5 “binData” Undefined 6 “undefined” Deprecated. ObjectId 7 “objectId” Boolean 8 “bool” Date 9 “date” Null 10 “null” Regular Expression 11 “regex” DBPointer 12 “dbPointer” Deprecated. JavaScript 13 “javascript” Symbol 14 “symbol” Deprecated. JavaScript (with scope) 15 “javascriptWithScope” 32-bit integer 16 “int” Timestamp 17 “timestamp” 64-bit integer 18 “long” Decimal128 19 “decimal” New in version 3.4. Min key -1 “minKey” Max key 127 “maxKey”

举例如下：

db.addressBook.insertMany(   [      { "_id" : 1, address : "2030 Martian Way", zipCode : "90698345" },      { "_id" : 2, address: "156 Lunar Place", zipCode : 43339374 },      { "_id" : 3, address : "2324 Pluto Place", zipCode: NumberLong(3921412) },      { "_id" : 4, address : "55 Saturn Ring" , zipCode : NumberInt(88602117) }   ])db.addressBook.find( { "zipCode" : { $type : 2 } } );db.addressBook.find( { "zipCode" : { $type : "string" } } );查询结果为：{ "_id" : 1, "address" : "2030 Martian Way", "zipCode" : "90698345" }

1.4评估操作符

$mod
匹配字段值被除有指定的余数的文档

{ field: { $mod: [ divisor(除数), remainder(余数) ] } }

{ "_id" : 1, "item" : "abc123", "qty" : 0 }{ "_id" : 2, "item" : "xyz123", "qty" : 5 }{ "_id" : 3, "item" : "ijk123", "qty" : 12 }db.inventory.find( { qty: { $mod: [ 4, 0 ] } } )查询结果为：{ "_id" : 1, "item" : "abc123", "qty" : 0 }{ "_id" : 3, "item" : "ijk123", "qty" : 12 }

$regex
正则表达式可以匹配到的文档

{ <field>: { $regex: /pattern/, $options: '<options>' } }{ <field>: { $regex: 'pattern', $options: '<options>' } }{ <field>: { $regex: /pattern/<options> } }

Option Description Syntax Restrictions i 对大小写不敏感 m 多行匹配 x 忽略空格 s 使点号可以匹配换行符

$text
针对创建了全文索引的字段进行文本搜索

{  $text:    {      $search: <string>,      $language: <string>,      $caseSensitive: <boolean>,      $diacriticSensitive: <boolean>    }}

$where
可以通过js表达式或js函数来查询文档

1.5数组操作符

$all
字段值是包含所有指定元素的数组的文档

{ <field>: { $all: [ <value1> , <value2> ... ] } }

举例如下：

{   _id: ObjectId("5234cc89687ea597eabee675"),   code: "xyz",   tags: [ "school", "book", "bag", "headphone", "appliance" ],}{   _id: ObjectId("5234cc8a687ea597eabee676"),   code: "abc",   tags: [ "appliance", "school", "book" ],}{   _id: ObjectId("5234ccb7687ea597eabee677"),   code: "efg",   tags: [ "school", "book" ],}{   _id: ObjectId("52350353b2eff1353b349de9"),   code: "ijk",   tags: [ "electronics", "school" ],}db.inventory.find( { tags: { $all: [ "appliance", "school", "book" ] } } )查询结果：{   _id: ObjectId("5234cc89687ea597eabee675"),   code: "xyz",   tags: [ "school", "book", "bag", "headphone", "appliance" ],}{   _id: ObjectId("5234cc8a687ea597eabee676"),   code: "abc",   tags: [ "appliance", "school", "book" ],}

$elemMatch
数组字段至少一个元素满足所有指定查询条件的文档

{ <field>: { $elemMatch: { <query1>, <query2>, ... } } }

$size
匹配数组字段元素个数等于指定数量的文档

db.collection.find( { field: { $size: 2 } } );

1.6投影操作符

$ (projection)
限定查询结果中指定数组字段返回满足条件的第一个元素
举例如下：

文档集合{ "_id" : 1, "semester" : 1, "grades" : [ 70, 87, 90 ] }{ "_id" : 2, "semester" : 1, "grades" : [ 90, 88, 92 ] }{ "_id" : 3, "semester" : 1, "grades" : [ 85, 100, 90 ] }{ "_id" : 4, "semester" : 2, "grades" : [ 79, 85, 80 ] }{ "_id" : 5, "semester" : 2, "grades" : [ 88, 88, 92 ] }{ "_id" : 6, "semester" : 2, "grades" : [ 95, 90, 96 ] }查询语句db.students.find( { semester: 1, grades: { $gte: 85 } },                  { "grades.$": 1 } )查询结果{ "_id" : 1, "grades" : [ 87 ] }{ "_id" : 2, "grades" : [ 90 ] }{ "_id" : 3, "grades" : [ 85 ] }

$elemMatch (projection)
限定查询结果中指定数组字段返回满足条件的第一个元素
举例如下

文档集合：{ _id: 1, zipcode: "63109", students: [              { name: "john", school: 102, age: 10 },              { name: "jess", school: 102, age: 11 },              { name: "jeff", school: 108, age: 15 }           ]}{ _id: 2, zipcode: "63110", students: [              { name: "ajax", school: 100, age: 7 },              { name: "achilles", school: 100, age: 8 },           ]}{ _id: 3, zipcode: "63109", students: [              { name: "ajax", school: 100, age: 7 },              { name: "achilles", school: 100, age: 8 },           ]}{ _id: 4, zipcode: "63109", students: [              { name: "barney", school: 102, age: 7 },              { name: "ruth", school: 102, age: 16 },           ]}查询语句：db.schools.find( { zipcode: "63109" },                 { students: { $elemMatch: { school: 102 } } } )查询结果：{ "_id" : 1, "students" : [ { "name" : "john", "school" : 102, "age" : 10 } ] }{ "_id" : 3 }{ "_id" : 4, "students" : [ { "name" : "barney", "school" : 102, "age" : 7 } ] }

$slice (projection)
控制指定数组字段返回元素个数

db.collection.find( { field: value }, { array: {$slice: count } } );

2.更新操作符

2.1字段更新

$inc
给一个字段增加指定值

{ $inc: { <field1>: <amount1>, <field2>: <amount2>, ... } }

$mul

{ $mul: { field: <number> } }

$rename

{$rename: { <field1>: <newName1>, <field2>: <newName2>, ... } }

$setOnInsert
upsert为true时，有插入文档操作时插入指定字段值

db.collection.update(   <query>,   { $setOnInsert: { <field1>: <value1>, ... } },   { upsert: true })

$set

{ $set: { <field1>: <value1>, ... } }

$unset
删除指定字段

{ $unset: { <field1>: "", ... } }

$min
指定值小于当前值则更新为指定值

{ $min: { <field1>: <value1>, ... } }

$max
指定值大于当前值则更新为指定值

{ $max: { <field1>: <value1>, ... } }

$currentDate
设置字段值为当前日期
指定值为true设置为当前日期, 或者{ $type: “timestamp” }或{ $type: “date” }的形式”timestamp”和”date”必须是小写的

{ $currentDate: { <field1>: <typeSpecification1>, ... } }

2.2数组更新

$
更新指定数组的第一个元素

 { "<array>.$" : value } 

$addToSet
数组字段增加一个值

{ $addToSet: { <field1>: <value1>, ... } }

$pop
删除数组字段中的第一个或最后一个元素

{ $pop: { <field>: <-1 | 1>, ... } }

$pullAll
删除数组字段中所有指定值，如果指定值为数组，则删除匹配数组内的元素

{ $pullAll: { <field1>: [ <value1>, <value2> ... ], ... } }

$pull
符合条件的值将被删除

{ $pull: { <field1>: <value|condition>, <field2>: <value|condition>, ... } }

$pushAll
向数组中追加多个指定值

{ $pushAll: { <field>: [ <value1>, <value2>, ... ] } }

$push
向数组中追加值

{ $push: { <field1>: <value1>, ... } }

$each
用于 $addToSet添加多个值到数组中

{ $addToSet: { <field>: { $each: [ <value1>, <value2> ... ] } } }

追加多个值到数组中

{ $push: { <field>: { $each: [ <value1>, <value2> ... ] } } }

$slice
限定$push操作时数组元素的个数
必须和$each一起使用

{  $push: {     <field>: {       $each: [ <value1>, <value2>, ... ],       $slice: <num>     }  }}

$sort
与$each一起使用

{  $push: {     <field>: {       $each: [ <value1>, <value2>, ... ],       $sort: <sort specification>     }  }}

$position
与$each一起使用
<num>从0开始的索引值

{  $push: {    <field>: {       $each: [ <value1>, <value2>, ... ],       $position: <num>    }  }}

3.聚合管道操作符

$project
管道中字段的增加、删除和重命名

{ $project: { <specification(s)> } }

$match

{ $match: { <query> } }

$limit

{ $limit: <positive integer> }

$skip

{ $skip: <positive integer> }

$unwind
文档按照数组字段进行拆分
举例如下：

文档：{ "_id" : 1, "item" : "ABC1", sizes: [ "S", "M", "L"] }管道语句：db.inventory.aggregate( [ { $unwind : "$sizes" } ] )结果：{ "_id" : 1, "item" : "ABC1", "sizes" : "S" }{ "_id" : 1, "item" : "ABC1", "sizes" : "M" }{ "_id" : 1, "item" : "ABC1", "sizes" : "L" }

$group

{ $group: { _id: <expression>, <field1>: { <accumulator1> : <expression1> }, ... } }

举例如下

文档集合：{ "_id" : 8751, "title" : "The Banquet", "author" : "Dante", "copies" : 2 }{ "_id" : 8752, "title" : "Divine Comedy", "author" : "Dante", "copies" : 1 }{ "_id" : 8645, "title" : "Eclogues", "author" : "Dante", "copies" : 2 }{ "_id" : 7000, "title" : "The Odyssey", "author" : "Homer", "copies" : 10 }{ "_id" : 7020, "title" : "Iliad", "author" : "Homer", "copies" : 10 }分组：db.books.aggregate(   [     { $group : { _id : "$author", books: { $push: "$title" } } }   ])结果：{ "_id" : "Homer", "books" : [ "The Odyssey", "Iliad" ] }{ "_id" : "Dante", "books" : [ "The Banquet", "Divine Comedy", "Eclogues" ] }分组：db.books.aggregate(   [     { $group : { _id : "$author", books: { $push: "$$ROOT" } } }   ])结果：{  "_id" : "Homer",  "books" :     [       { "_id" : 7000, "title" : "The Odyssey", "author" : "Homer", "copies" : 10 },       { "_id" : 7020, "title" : "Iliad", "author" : "Homer", "copies" : 10 }     ]}{  "_id" : "Dante",  "books" :     [       { "_id" : 8751, "title" : "The Banquet", "author" : "Dante", "copies" : 2 },       { "_id" : 8752, "title" : "Divine Comedy", "author" : "Dante", "copies" : 1 },       { "_id" : 8645, "title" : "Eclogues", "author" : "Dante", "copies" : 2 }     ]}

$sort

{ $sort: { <field1>: <sort order>, <field2>: <sort order> ... } }

$lookup
两个集合之间的关联

{   $lookup:     {       from: <collection to join>,       localField: <field from the input documents>,       foreignField: <field from the documents of the "from" collection>,       as: <output array field>     }}

$count

{ $count: <string> }