Mongo官方文檔翻譯 (二)

官方文檔位址：http://docs.mongodb.org/manual/applications/create/

建立

在資料庫中的四個基本操作(CRUD),建立操作是指那些把記錄或文檔集合添加到

MongoDB中的聚集中的操作。

概述：

你可以利用下面的任一基本操作在MongoDB中建立文檔集合：

insert

create with save

create with upsert

下列是MongoDB中所有的insert操作：

1.如果你試圖插入一條沒有_id字段的文檔，用戶端庫或mongod執行個體會自動添加_id字段并設定

将其填充給一個唯一的ObjectId字段！

2.對于寫相關的操作，如果你指定一個_id字段，那麼該_id字段在聚集中必須是唯一的；否則，

mongod會傳回一個duplicate key exception。

3.BSON文檔的最大大小事16MB。

文檔類型的最大值有助于确定一個單獨的文檔不能占用過多的記憶體以及在傳輸過程中占用過多的帶寬。

為了儲存大于最大值的文檔，MongoDB提供了GridFSB API。

4.文檔在字段名稱上有如下的限制：

1.字段_id是預留的用作主鍵的字段，字段的值必須是在聚集中唯一的，不變的，并且可以使除了數組

的其他任何類型。

2.字段名不能以$開始。

3.字段名稱不能包含.。

注意：以下的驅動版本中，所有的寫相關操作都會發出一個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

{getLastError:1}

1.插入操作

insert()是将一個或多個文檔插入到MongoDB聚集中的基本方法,該方法有如下的句式：

db.collection.insert( <document> )

SQL中類似的操作：insert()類似于INSERT操作!

下面的示例示範了insert()的用法：

1.如果聚集并不存在（你可以在mongo shell中通過show collections 操作來列出存在的聚集),

insert()方法會在第一次插入資料的時候建立聚集。如下所示:如果聚集bios不存在，insert操作

會建立這個聚集:

db.bios.insert(

{

_id: 1,

birth: new Date('Dec 03, 1924'),

death: new Date('Mar 17, 2007'),

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

awards: [

{

award: 'W.W. McDowell Award',

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'

}

]

}

)

你可以通過查詢bios來确認insert的操作結果：

db.bios.find()

操作會傳回如下資料：

{

"_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. McDowell Award",

"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"

}

]

}

2.如果新的文檔不包含_id字段，insert會添加這個字段并且為其生成一個唯一的ObjectId：

db.bios.insert(

{

birth: new Date('Sep 04, 1927'),

death: new Date('Dec 24, 2011'),

contribs: [ 'Lisp', 'Artificial Intelligence', 'ALGOL' ],

awards: [

{

award: 'Turing Award',

year: 1971,

by: 'ACM'

{

award: 'Kyoto Prize',

year: 1988,

by: 'Inamori Foundation'

{

award: 'National Medal of Science',

year: 1990,

by: 'National Science Foundation'

}

]

}

)

你可以通過以下操作核實insert的行為：

db.bios.find({name:{first:'John',last:'McCarthy'}})

傳回的結果中自動産生了一個唯一的_id字段：

{

"_id" : ObjectId("50a1880488d113a4ae94a94a"),

"name" : { "first" : "John", "last" : "McCarthy" },

"birth" : ISODate("1927-09-04T04:00:00Z"),

"death" : ISODate("2011-12-24T05:00:00Z"),

"contribs" : [ "Lisp", "Artificial Intelligence", "ALGOL" ],

"awards" : [

{

"award" : "Turing Award",

"year" : 1971,

"by" : "ACM"

{

"award" : "Kyoto Prize",

"year" :1988,

"by" : "Inamori Foundation"

{

"award" : "National Medal of Science",

"year" : 1990,

"by" : "National Science Foundation"

}

]

}

3.如果你傳遞一個數組到insert(),insert()會對聚集産生一個批量的插入！

接下來的操作向bios聚集中插入了3個文檔，這個操作同樣也闡述了MongoDB中

動态模式的特性，盡管_id:3的文檔中有一個title字段是其他2個文檔中沒有的，

MongoDB也不多強制要求其他文檔包含次屬性：

db.bios.insert(

[

{

_id: 3,

title: 'Rear Admiral',

birth: new Date('Dec 09, 1906'),

death: new Date('Jan 01, 1992'),

contribs: [ 'UNIVAC', 'compiler', 'FLOW-MATIC', 'COBOL' ],

awards: [

{

award: 'Computer Sciences Man of the Year',

year: 1969,

by: 'Data Processing Management Association'

{

award: 'Distinguished Fellow',

year: 1973,

by: ' British Computer Society'

{

award: 'W. W. McDowell Award',

year: 1976,

by: 'IEEE Computer Society'

{

award: 'National Medal of Technology',

year: 1991,

by: 'United States'

}

]

{

_id: 4,

birth: new Date('Aug 27, 1926'),

death: new Date('Aug 10, 2002'),

contribs: [ 'OOP', 'Simula' ],

awards: [

{

award: 'Rosing Prize',

year: 1999,

by: 'Norwegian Data Association'

{

award: 'Turing Award',

year: 2001,

by: 'ACM'

{

award: 'IEEE John von Neumann Medal',

year: 2001,

by: 'IEEE'

}

]

{

_id: 5,

birth: new Date('Oct 12, 1931'),

death: new Date('Jun 29, 2002'),

contribs: [ 'OOP', 'Simula' ],

awards: [

{

award: 'Rosing Prize',

year: 1999,

by: 'Norwegian Data Association'

{

award: 'Turing Award',

year: 2001,

by: 'ACM'

{

award: 'IEEE John von Neumann Medal',

year: 2001,

by: 'IEEE'

}

]

}

]

)

2.通過save建立

save()方法是一個特殊的方法，它使用<document>的_id字段來決定插入或者更新一個文檔。

1.如果<document>參數不包含_id字段或者包含的_id字段的值并不在聚集中，save()方法會表現

插入操作。

2.否則，save()方法會表現為更新操作。

save()方法的句法如下：

db.collection.save( <document> )

通過下面的示例來思考save()方法在插入操作方面的用法：

1.如果<document>不包含_id字段，save()方法會表現為插入.

具體實作參照“插入操作“中對于不包含_id字段文檔的插入操作的詳細說明。

下面的操作展示了<document>不包含_id字段的時候save()方法表現出來的插入行為:

db.bios.save(

{

birth: new Date('Jan 31, 1956'),

contribs: [ 'Python' ],

awards: [

{

award: 'Award for the Advancement of Free Software',

year: 2001,

by: 'Free Software Foundation'

{

award: 'NLUUG Award',

year: 2003,

by: 'NLUUG'

}

]

}

)

2.如果<document>包含_id字段但是字段的值在聚集中沒有找到，save()方法也會表現出插入操作。

具體實作參照“插入操作“中插入操作的詳細說明。

下面的操作展示了将一個文檔插入到bios聚集中，但是該文檔所包含的_id字段的數值10在bios聚集中

無法找到的情況：

db.bios.save(

{

_id: 10,

birth: new Date('Apr 14, 1965'),

contribs: [ 'Ruby' ],

awards: [

{

award: 'Award for the Advancement of Free Software',

year: '2011',

by: 'Free Software Foundation'

}

]

}

)

3.通過upsert建立

一個upsert消除了一條在一個獨立資料庫中的記錄在插入或更新之前調用檢查其是否存在的需要。（原文：

An upsert eliminates the need to perform a separate database call to check for the existence of a record before performing either an update or an insert operation.）

傳統的update操作會更新已存在的文檔模型，但是在MongoDB中，update()操作可以接受<upsert>操作作為一個參數

，upsert是一個調用<query>參數來決定寫操作的混合操作：

1.如果query比對到一個或多個已然存在的文檔，upsert會表現為更新操作。

2.如果query在聚集中沒有比對到文檔，則erpsert會插入一個獨立的文檔。

通過下面的句法思考upsert的操作：

db.collection.update( <query>,

<update>,

{ upsert: true } )

接下來的例子闡述了upsert表現為create的操作：

1.如果沒有文檔比對到<query>參數，upsert表現為插入操作，如果<update>參數僅包含字段和數值對，則新文檔

包含<update>參數中指定的所有字段和值，如果_id字段被省略了，那麼添加操作會自動産生一個

唯一的ObjectId來填充_id字段（唯一的哦）!

下面的upsert操作箱bios聚集中插入了一個新的文檔：

db.bios.update(

{ name: { first: 'Dennis', last: 'Ritchie'} },

{

birth: new Date('Sep 09, 1941'),

died: new Date('Oct 12, 2011'),

contribs: [ 'UNIX', 'C' ],

awards: [

{

award: 'Turing Award',

year: 1983,

by: 'ACM'

{

award: 'National Medal of Technology',

year: 1998,

by: 'United States'

{

award: 'Japan Prize',

year: 2011,

by: 'The Japan Prize Foundation'

}

]

{ upsert: true }

)

2.如果<query>參數沒有比對到文檔，upsert操作會插入一個新的文檔，如果<update>參數隻是

包含對已有文檔對象的修改，那麼新誕生的文檔會包含<query>參數中已有的字段和<update>

參數中更新的字段！

下面的操作在bios聚集中插入了一個新文檔：

db.bios.update(

{

_id: 7,

{

$set: {

birth: new Date('Feb 04, 1943'),

contribs: [ 'UNIX', 'C', 'B', 'UTF-8' ],

awards: [

{

award: 'Turing Award',

year: 1983,

by: 'ACM'

{

award: 'IEEE Richard W. Hamming Medal',

year: 1990,

by: 'IEEE'

{

award: 'National Medal of Technology',

year: 1998,

by: 'United States'

{

award: 'Tsutomu Kanai Award',

year: 1999,

by: 'IEEE'

{

award: 'Japan Prize',

year: 2011,

by: 'The Japan Prize Foundation'

}

]

}

{ upsert: true }

)

Mongo官方文檔翻譯 (二)

繼續閱讀

mongo資料庫的操作(安裝和配置)

MongoDB+GridFS存儲檔案方案

「資料庫」全方位對比 Postgres 和 MongoDB (2023 版)

mongoDB的安裝和使用（ubuntu）

pymongo中AutoReconnect異常的正确避免方式

MongoDB學習筆記一:下載下傳安裝MongoDB

mongo Shell方法mongo Shell方法

mongodb源碼分析之mongo shell

mysql與mongo資料庫---環境搭建

MongoDB在Linux環境下安裝

mongodb實戰--單節點轉叢集

MongoDB線上、離線及docker方式安裝

Springboot MongoDB 事務

tp5中 mongo的聚合查詢

Python3安裝 PyMongo、連接配接、建立資料庫，增删改查（42）

阿裡P8架構師親授一心多用，帶你左手MongoDB,右手Redis，純幹貨MongodbRedis第1篇基礎知識第2篇快速入門第3篇進階應用第4篇商業實戰