Docs 菜单
Docs 主页
/ /

使用 Node.js 驱动程序开始操作

本指南介绍如何创建一个使用 MongoDB Node.js 驱动程序连接到在 MongoDB Atlas 上托管的 MongoDB 集群的应用程序。Node.js 驱动程序是一个函数库,它可用于连接到 MongoDB 并与之通信。

提示

MongoDB Atlas 是完全托管的云数据库服务,旨在托管您的 MongoDB 部署。您可以按照本指南中的步骤创建您的免费(无需信用卡)MongoDB Atlas 部署。

请按照本指南所述步骤,将示例 Node.js 应用程序连接到 MongoDB Atlas 部署。如果您希望使用其他驱动程序或编程语言连接 MongoDB,请参阅我们的 官方驱动程序列表

1

确保在开发环境中安装了以下依赖项:

  • Node.js v16.20.1 或更高版本

  • npm (节点包经理)

要学习;了解如何安装 Node.js 和npm ,请参阅npm文档中的下载和安装 Node.js 和npm

2

在您的 Shell 中运行以下命令,为此项目创建一个名为 node_quickstart 的目录:

mkdir node_quickstart

然后,运行以下命令以导航到该目录并初始化 Node.js项目:

cd node_quickstart
npm init -y

初始化命令成功完成后,node_quickstart目录中就会出现一个 package.json文件。

3

从项目目录运行以下命令以安装驾驶员:

npm install mongodb@6.16

此命令会执行以下操作:

  • 下载 mongodb 软件包及其所需的依赖项

  • 将软件包保存在 node_modules 目录中

  • package.json 文件中记录依赖信息

完成这些步骤后,您将拥有一个安装了驾驶员依赖项的新项目目录。

您可以在 MongoDB Atlas 上创建一个免费套餐 MongoDB 部署来存储和管理您的数据。MongoDB Atlas 在云端托管和管理您的 MongoDB 数据库。

1

请按照 Atlas 入门指南中的步骤,设置新的 Atlas 账户并将示例数据加载到新的免费套餐 MongoDB 部署中。

2

创建数据库用户后,请将该用户的用户名和密码保存在一个安全位置,以便在后续步骤中使用。

完成这些步骤后,您就可以在 Atlas 上有一个新的免费套餐 MongoDB 部署,并建立数据库用户凭证,以及将示例数据加载到数据库中。

您可以通过提供连接 URI(也称为连接字符串)来连接到 MongoDB 部署,它指示驱动程序如何连接到 MongoDB 部署以及连接时的行为方式。

连接字符串包含部署的主机名或 IP 地址和端口、身份验证机制、用户档案(如果适用)以及连接选项。

1

要检索您在上一节中创建的部署的连接字符串,日志登录您的Atlas帐户并导航到Clusters部分,然后单击新部署的Connect按钮。

Atlas 用户界面的集群部分中的连接按钮
2

单击连接string右侧的按钮将其复制到剪贴板,如以下屏幕截图所示:

Atlas 用户界面中的连接字符串复制按钮
3

使用首选文本编辑器将连接字符串粘贴到文件中,并将 username<db_password> 占位符替换为数据库用户的用户名和密码。

将此文件保存到安全位置,以便在下一部分中使用。

完成这些步骤后,您将拥有一个包含数据库用户名和密码的连接字符串。

1

node_quickstart目录中,为应用程序创建一个名为 index.js 的文件。

将以下代码复制并粘贴到 index.js 文件:

const { MongoClient } = require("mongodb");
// Replace the uri string with your connection string
const uri = "<connection string uri>";
const client = new MongoClient(uri);
async function run() {
try {
const database = client.db('sample_mflix');
const movies = database.collection('movies');
// Queries for a movie that has a title value of 'Back to the Future'
const query = { title: 'Back to the Future' };
const movie = await movies.findOne(query);
console.log(movie);
} finally {
await client.close();
}
}
run().catch(console.dir);
2

<connection string uri> 占位符替换为从本指南的“创建连接字符串”步骤中复制的连接字符串。

3

在项目目录中,运行以下命令以启动应用程序:

node index.js

输出包括有关检索到的电影文档的详细信息:

{
_id: ...,
plot: 'A young man is accidentally sent 30 years into the past...',
genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
...
title: 'Back to the Future',
...
}

如果遇到错误或看不到输出,请验证您是否在 index.js文件中指定了正确的连接字符串以及是否加载了示例数据。

完成这些步骤后,您就有了一个正常运行的应用程序,它使用驾驶员连接到MongoDB 部署、查询示例数据并打印结果。

恭喜您完成快速入门教程!

注意

如果您在此步骤中运行问题,请使用MongoDB Stack Overflow标签 或MongoDB Reddit 社区 寻求帮助。您可以使用此页面右侧或右下角的 Rate this page标签页提交反馈。

在本教程中,您创建了一个 Node.js 应用程序,该应用程序连接到 MongoDB Atlas 上托管的 MongoDB 部署并检索与查询匹配的文档。

通过以下资源了解详情有关 Node.js驾驶员的更多信息:

  • 了解如何在连接到MongoDB部分配置MongoDB连接。

  • CRUD 操作部分了解如何执行读写操作。

后退

Overview

在此页面上