mongodb 常用操作符总结

谁借莪１个温暖的怀抱￠ 2021-11-10 05:16 399阅读 0赞

# **最近常用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> }