Node.js 连接 MongoDB

MongoDB是一种文档导向数据库管理系统，由C++撰写而成。

本章节我们将为大家介绍如何使用 Node.js 来连接 MongoDB，并对数据库进行操作。

如果你还没有 MongoDB 的基本知识，可以参考我们的教程：MongoDB 教程。

安装驱动

本教程使用了淘宝定制的 cnpm 命令进行安装：

$ cnpm install mongodb

接下来我们来实现增删改查功能。

---

创建数据库

要在 MongoDB 中创建一个数据库，首先我们需要创建一个 MongoClient 对象，然后配置好指定的 URL 和 端口号。

如果数据库不存在，MongoDB 将创建数据库并建立连接。

创建连接

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/runoob
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
console
.
log
(
"
数据库已创建!
"
)
;
db
.
close
(
)
;
}
)
;

---

创建集合

我们可以使用 createCollection() 方法来创建集合：

创建集合

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
'
mongodb://localhost:27017/runoob
'
;
MongoClient
.
connect
(
url
,
function

(
err
,
db
)

{

if

(
err
)

throw

err
;
console
.
log
(
'
数据库已创建
'
)
;
var

dbase
=
db
.
db
(
"
runoob
"
)
;
dbase
.
createCollection
(
'
site
'
,
function

(
err
,
res
)

{

if

(
err
)

throw

err
;
console
.
log
(
"
创建集合!
"
)
;
db
.
close
(
)
;
}
)
;
}
)
;

---

数据库操作( CURD )

与 MySQL 不同的是 MongoDB 会自动创建数据库和集合，所以使用前我们不需要手动去创建。

插入数据

以下实例我们连接数据库 runoob 的 site 表，并插入一条数据条数据，使用 insertOne()：

插入一条数据

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
var

myobj
=
{

name
:
"
菜鸟教程
"
,
url
:
"
www.runoob
"

}
;
dbo
.
collection
(
"
site
"
)
.
insertOne
(
myobj
,
function
(
err
,
res
)

{

if

(
err
)

throw

err
;
console
.
log
(
"
文档插入成功
"
)
;
db
.
close
(
)
;
}
)
;
}
)
;

执行以下命令输出就结果为：

$ node test.js
文档插入成功

从输出结果来看，数据已插入成功。

我们也可以打开 MongoDB 的客户端查看数据，如：

> show dbs
runoob  0.000GB          # 自动创建了 runoob 数据库
> show tables
site                     # 自动创建了 site 集合（数据表）
> db.site.find()
{ "_id" : ObjectId("5a794e36763eb821b24db854"), "name" : "菜鸟教程", "url" : "www.runoob" }
> 

如果要插入多条数据可以使用 insertMany()：

插入多条数据

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
var

myobj
=
[

{

name
:
'
菜鸟工具
'
,
url
:
'
https://c.runoob.com
'
,
type
:
'
cn
'
}
,
{

name
:
'
Google
'
,
url
:
'
https://www.google.com
'
,
type
:
'
en
'
}
,
{

name
:
'
Facebook
'
,
url
:
'
https://www.google.com
'
,
type
:
'
en
'
}

]
;
dbo
.
collection
(
"
site
"
)
.
insertMany
(
myobj
,
function
(
err
,
res
)

{

if

(
err
)

throw

err
;
console
.
log
(
"
插入的文档数量为:
"
+
res
.
insertedCount
)
;
db
.
close
(
)
;
}
)
;
}
)
;

res.insertedCount 为插入的条数。

查询数据

可以使用 find() 来查找数据, find() 可以返回匹配条件的所有数据。 如果未指定条件，find() 返回集合中的所有数据。

find()

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
dbo
.
collection
(
"
site
"
)
.
find
(
{
}
)
.
toArray
(
function
(
err
,
result
)

{

//
返回集合中所有数据


if

(
err
)

throw

err
;
console
.
log
(
result
)
;
db
.
close
(
)
;
}
)
;
}
)
;

以下实例检索 name 为 "菜鸟教程" 的实例：

查询指定条件的数据

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
var

whereStr
=
{
"
name
"
:
'
菜鸟教程
'
}
;
//
查询条件


dbo
.
collection
(
"
site
"
)
.
find
(
whereStr
)
.
toArray
(
function
(
err
,
result
)

{

if

(
err
)

throw

err
;
console
.
log
(
result
)
;
db
.
close
(
)
;
}
)
;
}
)
;

执行以下命令输出就结果为：

[ { _id: 5a794e36763eb821b24db854,
    name: '菜鸟教程',
    url: 'www.runoob' } ]

更新数据

我们也可以对数据库的数据进行修改，以下实例将 name 为 "菜鸟教程" 的 url 改为 https://www.runoob.com：

更新一条数据

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
var

whereStr
=
{
"
name
"
:
'
菜鸟教程
'
}
;
//
查询条件


var

updateStr
=
{
$
set
:
{

"
url
"
:
"
https://www.runoob.com
"

}
}
;
dbo
.
collection
(
"
site
"
)
.
updateOne
(
whereStr
,
updateStr
,
function
(
err
,
res
)

{

if

(
err
)

throw

err
;
console
.
log
(
"
文档更新成功
"
)
;
db
.
close
(
)
;
}
)
;
}
)
;

执行成功后，进入 mongo 管理工具查看数据已修改：

> db.site.find().pretty()
{
    "_id" : ObjectId("5a794e36763eb821b24db854"),
    "name" : "菜鸟教程",
    "url" : "https://www.runoob.com"     // 已修改为 https
}

如果要更新所有符合条的文档数据可以使用 updateMany()：

更新多条数据

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
var

whereStr
=
{
"
type
"
:
'
en
'
}
;
//
查询条件


var

updateStr
=
{
$
set
:
{

"
url
"
:
"
https://www.runoob.com
"

}
}
;
dbo
.
collection
(
"
site
"
)
.
updateMany
(
whereStr
,
updateStr
,
function
(
err
,
res
)

{

if

(
err
)

throw

err
;
console
.
log
(
res
.
result
.
nModified
+
"
条文档被更新
"
)
;
db
.
close
(
)
;
}
)
;
}
)
;

result.nModified 为更新的条数。

删除数据

以下实例将 name 为 "菜鸟教程" 的数据删除 :

删除一条数据

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
var

whereStr
=
{
"
name
"
:
'
菜鸟教程
'
}
;
//
查询条件


dbo
.
collection
(
"
site
"
)
.
deleteOne
(
whereStr
,
function
(
err
,
obj
)

{

if

(
err
)

throw

err
;
console
.
log
(
"
文档删除成功
"
)
;
db
.
close
(
)
;
}
)
;
}
)
;

执行成功后，进入 mongo 管理工具查看数据已删除：

> db.site.find()
> 

如果要删除多条语句可以使用 deleteMany() 方法

以下实例将 type 为 en 的所有数据删除 :

删除多条数据

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
var

whereStr
=
{

type
:
"
en
"

}
;
//
查询条件


dbo
.
collection
(
"
site
"
)
.
deleteMany
(
whereStr
,
function
(
err
,
obj
)

{

if

(
err
)

throw

err
;
console
.
log
(
obj
.
result
.
n
+
"
条文档被删除
"
)
;
db
.
close
(
)
;
}
)
;
}
)
;

obj.result.n 删除的条数。

排序

排序 使用 sort() 方法，该方法接受一个参数，规定是升序(1)还是降序(-1)。

例如：

{ type: 1 }  // 按 type 字段升序
{ type: -1 } // 按 type 字段降序

按 type 升序排列:

排序

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
var

mysort
=
{

type
:
1

}
;
dbo
.
collection
(
"
site
"
)
.
find
(
)
.
sort
(
mysort
)
.
toArray
(
function
(
err
,
result
)

{

if

(
err
)

throw

err
;
console
.
log
(
result
)
;
db
.
close
(
)
;
}
)
;
}
)
;

查询分页

如果要设置指定的返回条数可以使用 limit() 方法，该方法只接受一个参数，指定了返回的条数。

limit()：读取两条数据

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
dbo
.
collection
(
"
site
"
)
.
find
(
)
.
limit
(
2
)
.
toArray
(
function
(
err
,
result
)

{

if

(
err
)

throw

err
;
console
.
log
(
result
)
;
db
.
close
(
)
;
}
)
;
}
)
;

如果要指定跳过的条数，可以使用 skip() 方法。

skip(): 跳过前面两条数据，读取两条数据

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
dbo
.
collection
(
"
site
"
)
.
find
(
)
.
skip
(
2
)
.
limit
(
2
)
.
toArray
(
function
(
err
,
result
)

{

if

(
err
)

throw

err
;
console
.
log
(
result
)
;
db
.
close
(
)
;
}
)
;
}
)
;

连接操作

mongoDB 不是一个关系型数据库，但我们可以使用 $lookup 来实现左连接。

例如我们有两个集合数据分别为：

集合1：orders

[
  { _id: 1, product_id: 154, status: 1 }
]

集合2：products

[
  { _id: 154, name: '笔记本电脑' },
  { _id: 155, name: '耳机' },
  { _id: 156, name: '台式电脑' }
]

$lookup 实现左连接

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://127.0.0.1:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
dbo
.
collection
(
'
orders
'
)
.
aggregate
(
[

{
$
lookup
:
{

from
:
'
products
'
,
//
右集合


localField
:
'
product_id
'
,
//
左集合 join 字段


foreignField
:
'
_id
'
,
//
右集合 join 字段


as
:
'
orderdetails
'

//
新生成字段（类型array）


}

}

]
)
.
toArray
(
function
(
err
,
res
)

{

if

(
err
)

throw

err
;
console
.
log
(
JSON
.
stringify
(
res
)
)
;
db
.
close
(
)
;
}
)
;
}
)
;

删除集合

我们可以使用 drop() 方法来删除集合：

drop()

var

MongoClient
=
require
(
'
mongodb
'
)
.
MongoClient
;
var

url
=
"
mongodb://localhost:27017/
"
;
MongoClient
.
connect
(
url
,
function
(
err
,
db
)

{

if

(
err
)

throw

err
;
var

dbo
=
db
.
db
(
"
runoob
"
)
;
//
删除 test 集合


dbo
.
collection
(
"
test
"
)
.
drop
(
function
(
err
,
delOK
)

{

//
执行成功 delOK 返回 true，否则返回 false


if

(
err
)

throw

err
;
if

(
delOK
)

console
.
log
(
"
集合已删除
"
)
;
db
.
close
(
)
;
}
)
;
}
)
;

---

使用 Promise

Promise 是一个 ECMAScript 6 提供的类，目的是更加优雅地书写复杂的异步任务。

如果你还不了解 Promise，可以参考 JavaScript Promise。

以下实例使用 Promise 创建集合：

实例

const

MongoClient
=
require
(
"
mongodb
"
)
.
MongoClient
;
const

url
=
"
mongodb://localhost/runoob
"
;
MongoClient
.
connect
(
url
)
.
then
(
(
conn
)
=>
{

console
.
log
(
"
数据库已连接
"
)
;
var

dbase
=
conn
.
db
(
"
runoob
"
)
;
dbase
.
createCollection
(
"
site
"
)
.
then
(
(
res
)
=>
{

console
.
log
(
"
已创建集合
"
)
;
}
)
.
catch
(
(
err
)
=>
{

console
.
log
(
"
数据库操作错误
"
)
;
}
)
.
finally
(
(
)
=>
{

conn
.
close
(
)
;
}
)
;
}
)
.
catch
(
(
err
)
=>
{

console
.
log
(
"
数据库连接失败
"
)
;
}
)
;

Promise 数据操作

现在我们在一个程序中实现四个连续操作：增加 、查询 、更改 、删除。

实例

const

MongoClient
=
require
(
"
mongodb
"
)
.
MongoClient
;
const

url
=
"
mongodb://localhost/
"
;
MongoClient
.
connect
(
url
)
.
then
(
(
conn
)
=>
{

console
.
log
(
"
数据库已连接
"
)
;
const

test
=
conn
.
db
(
"
testdb
"
)
.
collection
(
"
test
"
)
;
//
增加


test
.
insertOne
(
{

"
site
"
:
"
runoob.com
"

}
)
.
then
(
(
res
)
=>
{

//
查询


return

test
.
find
(
)
.
toArray
(
)
.
then
(
(
arr
)
=>
{

console
.
log
(
arr
)
;
}
)
;
}
)
.
then
(
(
)
=>
{

//
更改


return

test
.
updateMany
(
{

"
site
"
:
"
runoob.com
"

}
,
{
$
set
:
{

"
site
"
:
"
example.com
"

}

}
)
;
}
)
.
then
(
(
res
)
=>
{

//
查询


return

test
.
find
(
)
.
toArray
(
)
.
then
(
(
arr
)
=>
{

console
.
log
(
arr
)
;
}
)
;
}
)
.
then
(
(
)
=>
{

//
删除


return

test
.
deleteMany
(
{

"
site
"
:
"
example.com
"

}
)
;
}
)
.
then
(
(
res
)
=>
{

//
查询


return

test
.
find
(
)
.
toArray
(
)
.
then
(
(
arr
)
=>
{

console
.
log
(
arr
)
;
}
)
;
}
)
.
catch
(
(
err
)
=>
{

console
.
log
(
"
数据操作失败
"
+
err
.
message
)
;
}
)
.
finally
(
(
)
=>
{

conn
.
close
(
)
;
}
)
;
}
)
.
catch
(
(
err
)
=>
{

console
.
log
(
"
数据库连接失败
"
)
;
}
)
;

执行结果：

数据库已连接
[ { _id: 5f1664966833e531d83d3ac6, site: 'runoob.com' } ]
[ { _id: 5f1664966833e531d83d3ac6, site: 'example.com' } ]
[]

用异步函数实现相同的数据操作

实例

const

MongoClient
=
require
(
"
mongodb
"
)
.
MongoClient
;
const

url
=
"
mongodb://localhost/
"
;
async

function

dataOperate
(
)

{

var

conn
=
null
;
try

{

conn
=
await

MongoClient
.
connect
(
url
)
;
console
.
log
(
"
数据库已连接
"
)
;
const

test
=
conn
.
db
(
"
testdb
"
)
.
collection
(
"
test
"
)
;
//
增加


await

test
.
insertOne
(
{

"
site
"
:
"
runoob.com
"

}
)
;
//
查询


var

arr
=
await

test
.
find
(
)
.
toArray
(
)
;
console
.
log
(
arr
)
;
//
更改


await

test
.
updateMany
(
{

"
site
"
:
"
runoob.com
"

}
,
{
$
set
:
{

"
site
"
:
"
example.com
"

}

}
)
;
//
查询


arr
=
await

test
.
find
(
)
.
toArray
(
)
;
console
.
log
(
arr
)
;
//
删除


await

test
.
deleteMany
(
{

"
site
"
:
"
example.com
"

}
)
;
//
查询


arr
=
await

test
.
find
(
)
.
toArray
(
)
;
console
.
log
(
arr
)
;
}

catch

(
err
)

{

console
.
log
(
"
错误：
"
+
err
.
message
)
;
}

finally

{

if

(
conn
!=
null
)

conn
.
close
(
)
;
}

}

dataOperate
(
)
;

运行结果：

数据库已连接
[ { _id: 5f169006a2780f0cd4ea640b, site: 'runoob.com' } ]
[ { _id: 5f169006a2780f0cd4ea640b, site: 'example.com' } ]
[]

运行结果完全一样。

很显然，异步函数是一种非常良好的编程风格，在多次使用异步操作的时候非常实用。

但是请勿在低于 7.6.0 版本的 node.js 上使用异步函数。