Mongo官方文档翻译 (三)

官方文档地址：http://docs.mongodb.org/manual/applications/read/

读操作

在数据库的四种基础操作中，读操作是指那些从MongoDB聚集中检索记录或文档的操作。

你可以通过以下任意一种方法从MongoDB中检索文档：

1.find

2.findOne

Find

find方法是从聚集中检索众多文档的基础方法，find()方法返回包含若干文档的cursor。大多数的

驱动程序都向应用程序开发者提供了一种本地的可遍历借口来处理cursor和遍历文档。find()方法

包含如下句法：

db.collection.find( <query>, <projection> )

SQL中类似的操作:find()方法类似于SQL中的SELECT语句。

1.<query>参数类似于WHERE字句，而且

2.<projection>参数类似于将要从结果集合中检索的目标字段。

通过下面的示例来阐述find()方法的使用:

这个示例相关于一个bios的聚集，该聚集中有如下文档原型:

{

"_id" : 1,

"name" : {

"first" : "John",

"last" :"Backus"

},

"birth" : ISODate("1924-12-03T05:00:00Z"),

"death" : ISODate("2007-03-17T04:00:00Z"),

"contribs" : [ "Fortran", "ALGOL", "Backus-Naur Form", "FP" ],

"awards" : [

{

"award" : "W.W. McDowellAward",

"year" : 1967,

"by" : "IEEE Computer Society"

},

{

"award" : "National Medal of Science",

"year" : 1975,

"by" : "National Science Foundation"

},

{

"award" : "Turing Award",

"year" : 1977,

"by" : "ACM"

},

{

"award" : "Draper Prize",

"year" : 1993,

"by" : "National Academy of Engineering"

}

]

}

注意：在mongo shell中,你可以通过在find()后面添加.pertty()来格式化输出。

1.如果没有<query>参数，find()方法会返回聚集中的所有文档，

下面的操作返回bios聚集中的所有文档，（更精确的说法,返回一个cursor）

db.bios.find()

2.如果有<query>参数，find()方法会从聚集的所有文档中选择满足query标准的。

下面的扫做返回bios聚集中所有_id字段为5或者ObjectId("507c35dd8fada716c89d0013")

db.bios.find(

{

_id: { $in: [ 5, ObjectId("507c35dd8fada716c89d0013") ] }

}

)



下面的操作返回bios聚集中array字段contribs中包含unix的文档：



db.bios.find(

{

contribs: 'UNIX'

}

)

下面操作返回bios聚集中array字段awards包含一个子文档，该子文档包含award字段里有T如ing Arard

而且year字段大于1980：

db.bios.find(

{

awards: {

$elemMatch: {

award: 'Turing Award',

year: { $gt: 1980 }

}

}

}

)

下面的操作返回bios聚集中一个子文档“name"中包含字段first值为”Yukihiro“而且

last字段值为”Matsumoto“，quer通过.操作符来访问子文档的字段：

db.bios.find(

{

'name.first': 'Yukihiro',

'name.last': 'Matsumoto'

}

)

实际上，上面的操作对于下面连各种情况都会匹配：

{

first: 'Yukihiro',

aka: 'Matz',

last: 'Matsumoto'

}

{

last: 'Matsumoto',

first: 'Yukihiro'

}

下面的操作会返回bios聚集中子文档name字段确切的{ first: 'Yukihiro', last: 'Matsumoto' }，并且顺序

也一致：

db.bios.find(

{

name: {

first: 'Yukihiro',

last: 'Matsumoto'

}

}

)

上面的操作会严格的匹配子文档中的数值包括顺序，二下面的语句就不会了：

{

first: 'Yukihiro',

aka: 'Matz',

last: 'Matsumoto'

}

{

last: 'Matsumoto',

first: 'Yukihiro'

}

下面的操作会返回bios聚集中name子文档下first字段值为字母G开头或者birth字段的值

小于new Date('01/01/1945')：

db.bios.find(

{ $or: [

{ 'name.first' : /^G/ },

{ birth: { $lt: new Date('01/01/1945') } }

]

}

)

下面的操作会返回bios聚集中name子文档下first字段值为字母K开头并且contribs字段中

包含UNIX值得文档：

db.bios.find(

{

'name.first': /^K/,

contribs: 'UNIX'

}

)

在上面的查询中，参数（两个参数）通过一个隐式的AND在两个不同的字段之间进行连接，如果

AND之间连接的字段是相同的，则需要用$and操作符！

如果存在<projection>参数，那么find()方法只会返回<projection>参数中指定的要包含

或者排除的字段!

注意：_id字段默认的被包含在<projection>参数中，在projection中所有明确指出包含的

字段中，_id字段是你可以明确排除的，否则，你将不能使包含字段与排除字段的说明！

（原文：The _id field is implicitly included in the <projection> argument.

In projections that explicitly include fields,

_id is the only field that you can explicitly exclude.

Otherwise, you cannot mix include field and

exclude field specifications.)

下面的操作将会返回bios聚集的所有文档的name字段，contribs字段，以及_id字段：

db.bios.find(

{ },

{ name: 1, contribs: 1 }

)

下面的操作会返回bios聚集的所有文档中的name字段和congribs字段：

db.bios.find(

{ },

{ name: 1, contribs: 1, _id: 0 }

)

下面的操作会返回bios聚集的所有文档中contribs字段中包含元素：”OOP“并且从结果文档中返回所有字段但是排除：

_id，name中first字段，birth字段！

db.bios.find(

{ contribs: 'OOP' },

{ _id: 0, 'name.first': 0, birth: 0 }

)

下面的操作会返回bios聚集的所有文档中name子文档的last字段，以及contribs字段中的前两项内容！

db.bios.find(

{ },

{

_id: 0,

'name.last': 1,

contribs: { $slice: 2 }

}

)

游标

find()方法返回一个结果的cursor，在mongo shell中，如果返回的cursor没有被赋值给

一个变量，那么这个cursor会被自动的遍历20次来打印cursor中的前20个文档，示例如下：

db.bios.find( { _id: 1 } );

当你把find()赋值到一个变量的时候：

1.你可以输入变量的名字来显示匹配的文档中的前20条。如下所示：

var myCursor = db.bios.find( { _id: 1 } );

myCursor

2.你可以使用cursor的next()方法来访问文档，如下所示：

var myCursor = db.bios.find( { _id: 1 } );

var myDocument = myCursor.hasNext() ? myCursor.next() : null;

if (myDocument) {

var myName = myDocument.name;

print (tojson(myName));

}

为了输出，你也可以使用pringjson()方法来代替print(tojson()):

if (myDocument) {

var myName = myDocument.name;

printjson(myName);

}

你也可以使用cursor的forEach()方法来遍历游标并访问文档，如下所示：

var myCursor = db.bios.find( { _id: 1 } );

myCursor.forEach(printjson);

注意：你可以使用DBQuary.shellBatchSize来改变cursor中的默认值20.

修改游标行为：

除了<query>和<projection>参数之外，mongo shell和drivers提供了其他的方法

所以你可以在find()方法返回的cursor上调用这些方法来改变cursor的行为，这些方法是：

1.sort，通过method指定的一个或多个字段来对结果集中的文档排序！

下面的操作会对bios聚集中返回的cursor进行按照name的升序排列:

db.bios.find().sort( { name : 1 } )

sort()类似于SQL中的ORDER BY子句！

2.limit()方法用来限制结果集中文档的数量。

下面的操作会返回bios聚集中最多5条文档：

db.bios.find().limit(5)

limit()方法类似于SQL中的LIMIT子句！

3.skip()方法控制着结果集的起点！

下面的操作返回bios聚集的所有文档中返回的cursor，跳过前5条：

db.bios.find().skip(5)

你可以像下面一样连接这几个cursor方法：

db.bios.find().sort( {name:1} ).limit(5)

db.bios.find().limit( 5 ).sort( {name:1} )

Find One

findOne()方法从聚集中返回一个单独的文档并且不会返回cursor。

findOne()方法有如下句法：

db.collection.findOne( <query>,<projection> )

除了返回值，findOne()方法非常类似于find()方法。事实上，在内部中，

findOne()方法就是带limit(1)的find()!

通过下面的示例来理解findOne()方法的使用：

1.如果没有<query>参数，findOne()方法仅仅从聚集中攒则一个文档。

下面的操作从bios聚集中返回一个单独的文档。

db.bios.findOne()

2.如果有<query>参数，findOne()方法从满足<query>条件的集合中选择一个文档！

下面的操作会在bios聚集的文档中选择第一条（first matching）满足子文档name中的first字段以G字母开头或者birth字段小于new Date('01/01/1945')的记录：

db.bios.findOne(

{

$or: [

{ 'name.first' : /^G/ },

{ birth: { $lt: new Date('01/01/1945') } }

]

}

)

3.你可以向findOne()方法传递一个<projection>参数来控制结果集中的字段：

下面的操作返回bios聚集的所有文档中的一条，且只包含name字段，contribs字段，当然，还有_id字段：

db.bios.findOne(

{ },

{ name: 1, contribs: 1 }

)

下面的操作返回bios聚集的所有文档中满足contribs字段包含”OOP“的记录，但是返回的字段中排除_id,name.first,birth:

db.bios.findOne(

{ contribs: 'OOP' },

{ _id: 0, 'name.first': 0, birth: 0 }

)

尽管于find()方法很相似，由于findOne()方法返回的是文档而并不是cursor，所以你并不能把cursor上的方法诸如：sort(),skip(),limit()等，但是你可以直接访问文档，如下所示：

var myDocument = db.bios.findOne();

if (myDocument) {

var myName = myDocument.name;

print (tojson(myName));

}