/ /

快速参考

本页显示了若干 MongoDB 命令的驱动程序语法，以及指向相关引用和 API 文档的链接。

兼容性

您可以使用 Node.js 驱动程序连接到以下环境中托管的部署并对其执行命令：

MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务
MongoDB Enterprise：基于订阅的自管理 MongoDB 版本
MongoDB Community：source-available、免费使用且可自管理的 MongoDB 版本

要详细了解如何在 Atlas 用户界面中为 MongoDB Atlas 中托管的部署执行常见的 CRUD 操作，请参阅创建、查看、更新和删除文档。

命令

语法

查找文档

API 文档
 查找文档指南

await coll.findOne({ title: 'Hamlet' });

{ title: 'Hamlet', type: 'movie', ... }

查找多个文档

API 文档
 查找文档指南

coll.find({ year: 2005 });

[
  { title: 'Christmas in Boston', year: 2005, ... },
  { title: 'Chicken Little', year: 2005, ... },
  ...
]

插入文档

API 文档
 插入文档指南

await coll.insertOne({ title: 'Jackie Robinson' });

插入多个文档

API 文档
 插入文档指南

await coll.insertMany([
  { title: 'Dangal', rating: 'Not Rated' },
  { title: 'The Boss Baby', rating: 'PG' }
 ]);

更新文档

API 文档
 更新文档指南

await coll.updateOne(
  { title: 'Amadeus' },
  { $set: { 'imdb.rating': 9.5 } }
);

{ title: 'Amadeus', imdb: { rating: 9.5, ... } }

更新多个文档

API 文档
 更新文档指南

await coll.updateMany(
  { year: 2001 },
  { $inc: { 'imdb.votes': 100 } }
);

[
  { title: 'A Beautiful Mind', year: 2001, imdb: { votes: 826257, ... },
  { title: 'Shaolin Soccer', year: 2001, imdb: { votes: 65442, ... },
  ...
]

更新文档中的数组

API 文档
 更新文档指南中的数组

await coll.updateOne(
  { title: 'Cosmos' },
  { $push: { genres: 'Educational' } }
):

{ title: 'Cosmos', genres: [ 'Documentary', 'Educational' ] }

替换文档

API 文档
 替换文档指南

await coll.replaceOne(
  { name: 'Deli Llama', address: '2 Nassau St' },
  { name: 'Lord of the Wings', zipcode: 10001 }
);

{ name: 'Lord of the Wings', zipcode: 10001 }

删除文档

API 文档
 删除文档指南

await coll.deleteOne({ title: 'Congo' });

删除多个文档

API 文档
 删除文档指南

await coll.deleteMany({ title: { $regex: /^Shark.*/ } });

批量写入

API 文档
 批量操作指南

await coll.bulkWrite([
  {
    insertOne: {
      document: {
        title: 'A New Movie',
        year: 2022
      }
    }
  },
  {
    deleteMany: {
      filter: { year: { $lt: 1970 } }
    }
  }
]);

BulkWriteResult {
  result: {
    ...
  },
  ...
}

注意更改

API 文档
 使用 Change Streams 监控数据指南

coll.watch([ { $match: { year: { $gte: 2022 } } } ]);

从游标迭代访问数据

从游标访问数据指南

const cursor = coll.find();
for await (const doc of cursor) {
   console.dir(doc);
}

[
  { title: '2001: A Space Odyssey', ... },
  { title: 'The Sound of Music', ... },
  ...
]

以数组形式访问游标中的数据

API 文档
 从游标访问数据指南

const cursor = coll.find();
const results = await cursor.toArray();

[
  { title: '2001: A Space Odyssey', ... },
  { title: 'The Sound of Music', ... },
  ...
]

计算文档

API 文档
 计数文档指南

await coll.countDocuments({ year: 2000 });

列出不同的文档或字段值
API 文档
 Retrieve Distinct Values Guide

await coll.distinct('year');

[ 1891, 1893, 1894, 1896, 1903, ... ]

限制检索的文档数量

API 文档
 限制文档参考

coll.find().limit(2);

[
  { title: 'My Neighbor Totoro', ... },
  { title: 'Amélie', ... }
]

跳过检索到的文档

API 文档
 跳过文档引用

coll.find({ title: { $regex: /^Rocky/} }, { skip: 2 });

[
  { title: 'Rocky III', ... },
  { title: 'Rocky IV', ... },
  { title: 'Rocky V'}, ... }
]

检索文档时对文档进行排序

API 文档
 对文档参考进行排序

coll.find().sort({ year: 1});

[
  { title: 'Newark Athlete', year: 1891, ... },
  { title: 'Blacksmith Scene', year: 1893, ...},
  { title: 'Dickson Experimental Sound Film', year: 1894},
  ...
]

检索项目文档字段时

API 文档
 指定要返回的字段指南

coll.find().project({ _id: 0, year: 1, imdb: 1 });

[
  { year: 2012, imdb: { rating: 5.8, votes: 230, id: 8256 }},
  { year: 1985, imdb: { rating: 7.0, votes: 447, id: 1654 }},
  ...
]

创建索引

API 文档
 Indexes Guide

await coll.createIndex({ title: 1, year: -1 });

查询文本

API 文档
 查询文本指南

// only searches fields with text indexes
coll.find({ $text: { $search: 'zissou' } });

[
  { title: 'The Life Aquatic with Steve Zissou', ... }
]

安装驱动程序依赖项

package.json

"dependencies": {
  "mongodb": "^6.21",
  ...
}