Mongo官方文档翻译 (四)

更新操作！
官方文档地址：http://docs.mongodb.org/manual/applications/update/


更新


在数据库的四种基本操作中，更新操作是指那些在MongoDB聚集中修改现有记录或文档的操作。

修改操作用来修改聚集中已经存在的一个或多个文档。MongoDB提供了如下的方式来进行更新操作：

1.update
2.save

注意：仔细思考MongoDB中的update操作的下列行为：
1.当更新操作是的目标文档大小超出了文档原来的大小的时候，更新操作会
在磁盘上重新迁移文档，并且会影响到字段的顺序，这依赖于更新操作的类型！
2.对于如下的驱动版本，所有的写操作都会发出一个getLastError命令，来确认
写操作的结果！
C#, version 0.7
Java, version 2.10.0
Node.js, version 1.2
Perl, version 0.601.1
PHP, version 1.4
Python, version 2.4
Ruby, version 1.8

更新
update()方法是用来修改MongoDB聚集中文档的基础方法。默认情况下，update()方法更新一个文档，
如果使用了multi 操作，update()方法会更新聚集中所有符合query标准的文档。update()方法既可以
用新文档替换现有的文档，也可以对现有文档的指定字段进行修改。

update()方法有如下句法：

db.collection.update( <query>,<update>,<options> )

SQL中类似的操作：update()方法类似于SQL 中的UPDATE子句，并且：
1.<query>参数类似于WHERE子句，并且：
2.<update>参数类似于SET子句。
默认的update()方法更新一条文档类似于SQL中带有LIMIT 1子句的UPDATE。
带有multi操作的update方法类似于SQL中没有LIMIT限制的UPDATE子句!

通过下面的示例来思考update()方法的使用:
1.如果<update>参数只包含更新操作如：$set操作符，update()方法会更新类似的字段，如果要
更新子文档中的字段可以通过.操作符。

下面的操作查询了bios聚集的所有文档中_id字段等于1的文档的子文档name中maddle字段值为
Warner并且在awards字段中添加一个新元素。

db.bios.update(
  { _id: 1 },
  {
    $set: { 'name.middle': 'Warner' },
    $push: { awards: { award: 'IBM Fellow', year: 1963, by: 'IBM' } }
  }
)

2.如果<update>参数包含$unset操作，update()方法会将其中包含的字段从文档中移除。

下面的操作查询了bios聚集的文档中第一个_id字段等于3的文档，并且移除例如该文档的
birth字段：

db.bios.update(
  { _id: 3 },
  { $unset: { birth: 1 } }
)

3.如果<update>参数包含的字段并不存在于当前文档中，update()会把这些字段添加到当前文档
中。

下面的操作查询了bios聚集的文档中第一个拥有_id等于3的文档，而且在该文档的添加了mnranch字段以及子文档name中
添加了一个aka的字段：

db.bios.update(
  { _id: 3 },
  { $set: {
            mbranch: 'Navy',
            'name.aka': 'Amazing Grace'
          }
  }
)

4.如果<update>参数只包含字段和值的pairs，update()方法会利用<update>参数中的文档对象替换当前文档中
除了_id字段以外的全部字段。

下面的操作查询了bios聚集中第一个name字段等于{ first: 'John', last: 'McCarthy' } 的文档，并且利用
<update>中的文档替换了该文档除_id字段之外的所有字段：

db.bios.update(
  { name: { first: 'John', last: 'McCarthy' } },
  { name: { first: 'Ken', last: 'Iverson' },
    born: new Date('Dec 17, 1941'),
    died: new Date('Oct 19, 2004'),
    contribs: [ 'APL', 'J' ],
    awards: [
              { award: 'Turing Award',
                year: 1979,
                by: 'ACM' },
              { award: 'Harry H. Goode Memorial Award',
                year: 1975,
                by: 'IEEE Computer Society' },
              { award: 'IBM Fellow',
                year: 1970,
                by: 'IBM' }
    ]
  }
)
5.如果update操作要求更新一个数组字段中的元素：
1.update()方法会通过调用该元素的下表于.操作符来进行更新。
MongoDB中的数组下表是从0开始的！
2.下面的操作将bios聚集中_id字段为1的文档的contribs数组字段的第二个元素进行了更新：

db.bios.update(
  { _id: 1 },
  { $set: { 'contribs.1': 'ALGOL 58' } }
)
3.update()方法可以在目标数组字段的下标未知的情况下通过$操作符来更新。数组字段必须必须出现在quer参数中，
以便于update()方法决定对那个数组元素进行更新.

下面的操作将更新bios聚集中_id字段等于3的文档的contribs数组字段中包含“complier“的字段，如果找到，update()
方法会将第一个比配的文档的属性更新为A compiler:

db.bios.update(
  { _id: 3, 'contribs': 'compiler' },
  { $set: { 'contribs.$': 'A compiler' } }
)


6.如果<options>参数中multi属性值为true或1，则update()方法会修改查询结果中所有匹配的文档。

下面的操作会查询bios聚集的所有文档中名为awards的子文档中award属性为“Turing”的文档，并设置该文档的
属性为true，并且multi属性为ture！

db.bios.update(
  { 'awards.award': 'Turing' },
  { $set: { turing: true } },
  { multi: true }
)
7.如果把<options>参数中upsert属性设置为true或1，并且没有能匹配<query>参数的文档存在，那么update()方法会在聚集
中插入一个新的文档！

下面的操作会查询bios聚集中文档_id字段值为11而且name字段值为{ first: 'James', last: 'Gosling'}的文档，如果检索
能找到一个文档，update()方法会表现为updage操作，如果没有匹配到文档，update()会插入一个新文档，该文档由<query>中的
字段和值以及<update>参数中指定对相应字段的更新操作！

db.bios.update(
  { _id:11, name: { first: 'James', last: 'Gosling' } },
  {
    $set: {
             born: new Date('May 19, 1955'),
             contribs: [ 'Java' ],
             awards: [
                       { award: 'The Economist Innovation Award',
                         year: 2002,
                         by: 'The Economist' },
                       { award: 'Officer of the Order of Canada',
                         year: 2007,
                         by: 'Canada' }
            ]
         }
  },
  { upsert: true }
)

注意：如果<update>参数仅包含字段-值的数据对，则新文档中会包含<update>参数中指定的字段-值 数据对信息。如果<update>参数
只是包含一些update operators，那么，新的文档会从<query>参数中取得字段-值信息以及<update>参数中对相关字段所定义的操作（set，unset等）！


保存
save()方法会根据文档中的_id字段来更新或者新建一个文档。save()方法和update()方法在对于_id字段在upsert操作和<query>参数上是很相似的。

save()方法有如下的句法：

db.collection.save( <document> )

通过下面的例子思考save()方法的用法:
1.如果<document>参数包含的_id字段可以再聚集中找到，则save()方法会用<document>文档替换已存在的文档。

下面的操作会查询bios聚集的文档中_id字段值为：ObjectId("507c4e138fada716c89d0014")的文档，并且用<document>参数去更新和替换匹配到的文档！

db.bios.save(
  {
    _id: ObjectId("507c4e138fada716c89d0014"),
    name: { first: 'Martin', last: 'Odersky' },
    contribs: [ 'Scala' ]
  }
)

2.如果<document>参数中_id字段不存在或者存在_id字段但是没有找到匹配的文档，则save()函数会表现为一个insert操作！

下面的操作会自动的为<document>参数添加_id字段，并且赋值一个唯一的ObjectId，然后插入这个构造好的新文档！

db.bios.save(
  {
    name: { first: 'Larry', last: 'Wall' },
    contribs: [ 'Perl' ]
  }
)

更新操作：
字段的操作：
1.$inc
2.$rename
3.$set
4.$unset

数组的操作
1.$
2.$addToSet
3.$pop
4.$pullAll
5.$pull
6.$pushAll
7.$push
位操作
1.$bit
隔离操作
1.$isolated