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://rb.wikimirror.xyz:

更新一條數據

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://rb.wikimirror.xyz" }}; 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://rb.wikimirror.xyz"     // 已修改為 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://rb.wikimirror.xyz" }}; 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 上使用異步函數。