MongoDB Atlas 入门指南 – wiki基地

作者： /

MongoDB Atlas 入门指南：从零开始构建和连接你的云端数据库

欢迎来到云数据库的世界！如果您正在寻找一种强大、灵活且易于管理的 NoSQL 数据库解决方案，并且希望将其托管在云端而无需自己操心基础设施的搭建和维护，那么 MongoDB Atlas 正是您需要的。

本文将为您提供一个详尽的 MongoDB Atlas 入门指南，带您一步步完成账号注册、免费集群创建、安全配置以及连接数据库等关键步骤。无论您是开发者、学生还是对云数据库充满好奇的IT爱好者，本指南都将帮助您顺利开启您的 MongoDB Atlas 之旅。

1. 什么是 MongoDB Atlas？为什么选择它？

在深入操作之前，我们先来理解一下 MongoDB Atlas 是什么，以及它为何如此受欢迎。

MongoDB Atlas 是由 MongoDB 公司提供的数据库即服务 (DBaaS) 平台。简单来说，它允许您在主要的云服务提供商（如 Amazon Web Services (AWS)、Google Cloud Platform (GCP) 和 Microsoft Azure）上部署、管理和扩展 MongoDB 数据库，而无需您亲自安装、配置、监控或维护底层的硬件和操作系统。

为什么选择 MongoDB Atlas？

  1. 极简的部署与管理： 您只需通过简单的界面操作，就可以在几分钟内创建一个功能齐全的 MongoDB 集群。Atlas 会自动处理复杂的任务，如硬件配置、操作系统安装、MongoDB 软件部署、补丁更新、备份和恢复等。
  2. 高可用性和数据冗余： Atlas 支持多区域、多可用区部署，通过副本集 (Replica Set) 机制确保数据的高可用性。即使某个区域或可用区发生故障，您的数据库依然可以正常运行。
  3. 无缝扩展： 根据您的业务需求，您可以轻松地在 Atlas 界面上扩展您的数据库集群的存储、计算和连接数，无需停机（对于支持滚动升级的层级）。
  4. 强大的安全性： Atlas 提供多层次的安全特性，包括网络隔离、IP 白名单、数据库用户管理（基于角色的访问控制）、加密（传输层和静态数据）、审计日志等，帮助您保护您的数据。
  5. 内置监控和告警： Atlas 提供详细的性能指标监控面板和可定制的告警功能，让您随时了解数据库的运行状态。
  6. 丰富的功能集成： Atlas 不仅仅是一个数据库托管服务，它还集成了许多增值服务，如 Atlas Search (基于 Apache Lucene 的全文搜索)、Atlas Data Lake (查询云存储中的数据)、Atlas Charts (数据可视化)、Triggers (数据库事件驱动的函数) 等，构建更完整的应用后端。
  7. 经济实惠： Atlas 提供了免费层级 (M0)，允许您在不花费任何费用的情况下开始学习和使用 MongoDB，这对于个人项目、学习或者小型应用来说非常友好。

总而言之，MongoDB Atlas 让您能够专注于构建您的应用程序，而将数据库的运维重担交给专业的服务提供商。

2. 入门前的准备

在开始创建您的第一个 Atlas 集群之前，请确保您满足以下基本条件：

  1. 稳定的互联网连接： 创建和连接集群需要良好的网络环境。
  2. 一个有效的电子邮件地址： 用于注册 Atlas 账号。
  3. （可选，但推荐）对 MongoDB 的基本了解： 如果您已经了解 MongoDB 的一些基本概念（如文档、集合、数据库、副本集），将有助于您更快地理解 Atlas 的工作原理。
  4. （可选）信用卡通信息： 虽然免费层级 (M0) 不需要绑定信用卡，但如果您未来考虑升级到付费层级，或者使用某些需要付费的功能（如更高配置的备份），则需要绑定信用卡。对于入门学习，M0 足够了。

准备就绪后，我们就可以开始第一步：注册 MongoDB Atlas 账号。

3. 注册 MongoDB Atlas 账号

这是使用 MongoDB Atlas 的第一步。

  1. 访问 MongoDB Atlas 网站： 打开您的网页浏览器，访问 https://www.mongodb.com/cloud/atlas。
  2. 点击“Try Free” 或 “Sign Up”： 在页面上找到并点击“免费试用”或“注册”按钮。通常这些按钮很显眼，位于页面的顶部或中央。
  3. 填写注册信息： 您会看到一个注册表单，需要填写以下信息：
    • Email Address (电子邮件地址): 输入您的常用邮箱。
    • First Name (名) 和 Last Name (姓): 输入您的姓名。
    • Password (密码): 创建一个安全的密码。请确保密码强度足够，并牢记它。
    • Company (公司): 您可以填写您的公司名称，如果是个人学习，也可以填写您的组织名称或者留空/填写个人。
    • Country (国家/地区): 选择您所在的国家或地区。
  4. 同意条款： 阅读并勾选同意 MongoDB 的服务条款和隐私政策。
  5. 创建账号： 点击“Get Started Free” 或 “Create Account” 按钮。
  6. 验证您的电子邮件（可能需要）： 有时为了验证您提供的邮箱是有效的，系统会发送一封验证邮件到您的邮箱。请检查您的收件箱（包括垃圾邮件文件夹），找到这封邮件并点击其中的验证链接。
  7. 进入 Atlas 控制面板： 验证成功后（或直接创建账号成功后），您将被引导进入 MongoDB Atlas 的控制面板界面。这是您管理所有 Atlas 资源（项目、集群等）的地方。

恭喜您！您现在已经拥有一个 MongoDB Atlas 账号了。接下来，我们将在账号下创建一个项目，并在项目中部署您的第一个数据库集群。

4. 创建您的第一个 MongoDB Atlas 集群 (M0 Free Tier)

一个项目 (Project) 是您在 Atlas 中管理数据库集群、数据访问和用户等的逻辑容器。一个账号下可以有多个项目。创建集群通常是在一个项目内完成的。

如果您是新用户，登录后 Atlas 可能会自动引导您创建一个新项目。按照提示操作即可。如果需要手动创建：

  1. 创建新项目（如果需要）： 在 Atlas 控制面板左侧导航栏找到 “Projects”，点击 “New Project”。输入项目名称并点击 “Create Project”。
  2. 部署您的第一个数据库集群： 在新创建的项目概览页面，或者在左侧导航栏的 “Deployments” 下，点击 “Create”。您会看到不同的部署选项。对于入门，我们选择 “Database”。
  3. 选择部署类型： 选择您想要部署的数据库类型。对于初学者，我们强烈推荐使用 “Shared” 类型，因为它包含了免费的 M0 Tier。点击 “Create”。

  4. 配置您的集群： 这是核心步骤，需要仔细选择以下选项：

    • Cloud Provider & Region (云服务提供商和区域):

      • Atlas 支持在 AWS、Google Cloud (GCP) 和 Microsoft Azure 上部署。您可以根据您的地理位置、应用部署位置或个人偏好选择其中一个。
      • 重要提示： 选择一个离您最近或离您的应用程序用户最近的区域 (Region)。这可以显著减少延迟，提高访问速度。例如，如果您在中国，选择位于亚洲的区域（如 AWS 的新加坡、东京，GCP 的东京、香港，Azure 的东亚、东南亚）通常比选择美国或欧洲的区域更快。
      • 选择免费的 M0 层级时，并非所有区域都可用。Atlas 会显示哪些区域支持 M0。
      • 选择您偏好的云服务提供商，然后在下拉菜单中选择一个支持 M0 的区域。

    • Cluster Tier (集群层级):

      • 这是决定您的集群规模、性能和成本的关键选项。
      • 选择 M0 (Free): 这是免费层级，非常适合学习、开发测试和小型应用。
      • M0 层级的限制： 请注意 M0 的限制：
        • 共享实例：资源是共享的，性能不如独享层级稳定。
        • 存储空间有限：通常只有 512 MB 存储。
        • RAM 有限：通常只有 512 MB RAM。
        • 没有自动化备份（可以手动创建）。
        • 不支持某些高级功能，如 BI Connector, Atlas Search 等。
        • 连接数有限。
      • 尽管有这些限制，M0 对于入门来说是完全足够的。
      • （了解一下）付费层级（如 M10+）：提供独享资源、更大的存储和 RAM、更高的性能、自动备份、多区域部署选项等。

    • Additional Settings (附加设置):

      • 对于 M0 层级，这些设置通常被禁用或有默认值。
      • 如 Backup (备份): M0 不支持自动备份，您需要手动备份。
      • MongoDB Version: 选择默认推荐的最新稳定版本即可。

    • Cluster Name (集群名称):

      • 给您的集群取一个有意义的名称。例如 MyFreeCluster、LearningCluster 等。这个名称将用于在 Atlas 控制面板中识别您的集群。

  5. 创建集群： 仔细检查您选择的选项后，点击右下角的 “Create Cluster” 按钮。

  6. 等待集群部署： Atlas 现在会开始在您选择的云服务提供商和区域为您配置和部署 MongoDB 集群。这个过程需要一些时间（通常是 5-20 分钟不等），取决于云提供商的资源可用性和 Atlas 的负载。您可以离开页面，稍后回来查看状态。集群部署完成后，状态会从 “Creating” 变为 “Running”。

在等待集群创建的同时，我们可以提前进行下一步的关键配置：安全设置。

5. 配置安全设置：数据库用户和网络访问

安全性是数据库的基石。在您可以连接到集群并使用它之前，必须配置数据库用户和网络访问规则。这通常在创建集群的同一流程中或集群创建完成后进行。

在集群创建过程中，或者在集群创建完成后，您会在集群概览页面看到引导您进行安全配置的步骤。

步骤 A: 设置数据库用户 (Database Access)

Atlas 账号用户（用于登录 Atlas 控制面板）与数据库用户（用于连接数据库并执行操作）是不同的。您需要创建一个或多个数据库用户来访问您的集群中的数据。

  1. 创建数据库用户： 在安全配置向导中，或者在集群概览页面的 “Security” -> “Database Access” 下，点击 “Add New Database User”。
  2. 配置用户：
    • Authentication Method (认证方式): 对于初学者，选择 “Password” (密码) 是最简单的方式。
    • Username (用户名): 输入一个您想要的用户名称，例如 myappuser 或 adminuser。
    • Password (密码): 强烈建议使用 Atlas 生成的安全密码（点击 “Autogenerate Secure Password”）。请务必将这个密码复制并保存在一个安全的地方，因为它只会显示一次！如果您选择手动输入密码，请确保密码强度足够复杂。
    • Database User Privileges (数据库用户权限): 这决定了这个用户可以对数据库执行哪些操作。
      • 对于入门和学习：选择 “Read and write to any database” (读写任意数据库) 是最方便的。
      • 更安全的做法（生产环境推荐）：选择 “Only Read and write to specific databases” 或 “Only Read to specific databases”，然后指定数据库名称。
      • 如果您需要执行管理任务：可以选择 “Atlas Admin” 或其他管理角色，但请谨慎使用，特别是对于通用应用用户。
  3. 创建用户： 点击 “Add User”。

您现在有了一个可以连接到数据库的用户名和密码。

步骤 B: 配置网络访问 (Network Access)

您需要指定哪些 IP 地址或 IP 地址范围可以连接到您的 Atlas 集群。默认情况下，为了安全，任何 IP 地址都无法连接。

  1. 配置 IP 白名单： 在安全配置向导中，或者在集群概览页面的 “Security” -> “Network Access” 下，点击 “Add IP Address”。

  2. 选择访问方式：

    • “Add Current IP Address” (添加当前 IP 地址): Atlas 会自动检测您当前用于访问 Atlas 控制面板的公共 IP 地址，并将其添加到白名单中。这对于从您的个人电脑连接进行测试和开发非常方便。点击后，您的 IP 地址会被添加到列表中，您可以添加描述（如 “My Home IP”）。
    • “Allow Access from Anywhere” (允许从任何地方访问 – 0.0.0.0/0): 警告： 勾选此选项会允许任何 IP 地址连接到您的集群。虽然这对于入门和测试可能最简单，但极不安全，特别是在您存储敏感数据或将应用部署到生产环境时。强烈不建议在生产环境中使用此设置，除非您有其他强大的安全措施（如 VPC Peering）。如果仅仅是个人学习测试，且集群中没有重要数据，可以暂时使用，但请务必了解其风险并在学习完成后移除。
    • “Add IP Address List” (添加 IP 地址列表): 如果您知道您的应用服务器或开发者团队的公共 IP 地址范围，可以在这里手动输入。使用 CIDR 表示法（例如 203.0.113.0/24 表示一个 IP 地址范围）。

  3. 确认配置： 选择并添加您需要的 IP 地址后，点击 “Confirm”。

现在，只有您白名单中的 IP 地址才能尝试连接到您的数据库集群。

安全建议总结：
* 永远为数据库用户使用强密码，最好由 Atlas 生成。
* 遵循最小权限原则，只给用户其所需的最低权限。
* 限制网络访问，只允许可信的 IP 地址连接。避免使用 0.0.0.0/0 除非您清楚风险并有其他安全措施。

6. 连接到您的 MongoDB Atlas 集群

集群已创建并运行，安全配置也已完成。现在是时候连接到您的数据库了！Atlas 提供了多种连接方式，您可以根据您的需求选择。

在集群概览页面，找到并点击绿色的 “Connect” 按钮。Atlas 会为您提供连接选项：

选项 1: 使用 MongoDB Shell 连接

MongoDB Shell (mongosh) 是一个命令行工具，允许您与 MongoDB 数据库进行交互。

  1. 安装 MongoDB Shell： 如果您还没有安装，需要先下载并安装最新版本的 mongosh。访问 MongoDB 官方网站的下载中心 (https://www.mongodb.com/try/download/shell)，根据您的操作系统下载并安装。
  2. 获取连接命令： 在 Atlas 的连接向导中，选择 “Connect with the MongoDB Shell”。
  3. 选择您的 mongosh 版本。Atlas 会生成一个连接命令，类似于：
    bash
    mongosh "mongodb+srv://<username>:<password>@yourcluster.mongodb.net/?retryWrites=true&w=majority"
  4. 替换占位符： 将 <username> 替换为您之前创建的数据库用户名。将 <password> 替换为该用户的密码。
    • 重要： 如果您的密码包含特殊字符，在命令行中直接替换可能会有问题。更好的方法是在运行 mongosh 命令时，当提示输入密码时再输入。或者，有些 shell 允许您在连接字符串中使用 %40 代替 @ 等特殊字符进行编码，但直接在提示符输入密码更安全。
    • Atlas 生成的连接字符串使用了 mongodb+srv 协议。这是一个特殊的格式，它会查询 DNS SRV 记录来获取集群的连接信息，简化了连接配置。确保您的网络允许 DNS SRV 查询。
  5. 在终端中运行命令： 打开您的终端或命令行工具，粘贴修改好的命令，并执行。
  6. 输入密码（如果需要）： 如果您在命令中省略了 <password>，系统会提示您输入密码。输入密码时，屏幕上可能不会显示任何字符，这是正常的安全机制。输入完成后按回车。

  7. 连接成功： 如果一切顺利，您将连接到您的 Atlas 集群，并看到 mongosh 的提示符。您现在可以执行 MongoDB 命令了！

    “`javascript

    use mydatabase // 切换或创建一个数据库
    switched to db mydatabase
    db.mycollection.insertOne({ name: “Test Document”, value: 123 }) // 插入一个文档
    {
    acknowledged: true,
    insertedId: ObjectId(“…”)
    }
    db.mycollection.find() // 查询文档
    [
    {
    _id: ObjectId(“…”),
    name: ‘Test Document’,
    value: 123
    }
    ]
    “`

选项 2: 使用 Compass (GUI) 连接

MongoDB Compass 是一个官方的、功能丰富的图形用户界面 (GUI) 工具，让您可以可视化地浏览、分析和管理您的 MongoDB 数据。对于不熟悉命令行的用户来说，Compass 是一个非常友好的选择。

  1. 安装 MongoDB Compass： 如果您还没有安装，需要先下载并安装 Compass。访问 MongoDB 官方网站的下载中心 (https://www.mongodb.com/try/download/compass)，根据您的操作系统下载并安装。
  2. 获取连接字符串： 在 Atlas 的连接向导中，选择 “Connect with MongoDB Compass”。
  3. Atlas 会显示一个连接字符串，类似于 Shell 中的格式：
    mongodb+srv://<username>:<password>@yourcluster.mongodb.net/?retryWrites=true&w=majority
    您可以直接点击 “Copy” 按钮复制整个连接字符串。
  4. 打开 Compass： 启动 MongoDB Compass 应用程序。
  5. 粘贴连接字符串： Compass 通常会自动检测剪贴板中的 MongoDB 连接字符串。如果检测到，它会弹出一个连接窗口，连接字符串已经填充好了。如果没有自动弹出，点击 Compass 左上角的 “New Connection”。在 URI 字段中粘贴您从 Atlas 复制的连接字符串。
  6. 替换用户名和密码： 在粘贴的连接字符串中，将 <username> 和 <password> 占位符替换为您之前创建的数据库用户的实际用户名和密码。
    • 提示： Compass 通常会在您粘贴字符串后，自动解析出用户名、密码、主机等信息，并填充到下方的字段中。您可以检查这些字段是否正确。如果 Compass 提示密码字段为空，您可以在密码字段中手动输入。
  7. 连接： 点击 “Connect” 按钮。
  8. 连接成功： 如果信息正确且网络访问已允许，Compass 将成功连接到您的 Atlas 集群，并显示您拥有的数据库列表（如果还没有创建数据库，会显示默认的 admin, local 数据库）。您现在可以通过 Compass 可视化地浏览您的集合、插入/编辑/删除文档、执行查询等操作。

选项 3: 连接您的应用程序 (Drivers)

如果您想从您的应用程序（使用 Node.js, Python, Java, .NET 等）连接到 Atlas，需要使用相应的 MongoDB 驱动程序。

  1. 获取连接信息： 在 Atlas 的连接向导中，选择 “Connect your Application”。
  2. 选择驱动程序和版本： 选择您使用的编程语言和对应的 MongoDB 驱动程序版本。

  3. 获取连接字符串： Atlas 会生成一个适用于您所选语言驱动程序的连接代码片段或连接字符串。例如，Node.js 的可能如下：
    “`javascript
    const { MongoClient } = require(‘mongodb’);
    const uri = “mongodb+srv://:@yourcluster.mongodb.net/?retryWrites=true&w=majority”; // 替换用户名和密码
    const client = new MongoClient(uri);

    async function run() {
    try {
    await client.connect();
    // Establish and close a connection
    await client.db(“admin”).command({ ping: 1 }); // 简单测试连接
    console.log(“Pinged your deployment. You successfully connected to MongoDB!”);
    } finally {
    // Ensures that the client will close when you finish/error
    await client.close();
    }
    }
    run().catch(console.dir);
    “`
    4. 集成到您的代码中： 将这段代码或连接字符串复制到您的应用程序代码中，替换占位符（用户名和密码），并使用您的驱动程序 API 来执行数据库操作。

重要提示： 无论使用哪种连接方式，请确保您已经正确配置了数据库用户和网络访问白名单。连接失败最常见的原因就是 IP 地址不在白名单中，或者用户名密码错误。

7. 探索 MongoDB Atlas 控制面板

成功连接到集群后，花一些时间探索 Atlas 控制面板是一个好主意。它提供了许多有用的信息和工具。

  • Overview (概览): 显示集群的当前状态、配置、连接字符串等。
  • Metrics (指标): 提供详细的性能监控图表，如 CPU 使用率、连接数、网络流量、读写操作等。帮助您了解集群的运行状况。
  • Collections (集合): 如果您的集群中有数据，可以在这里使用内置的 Data Explorer 可视化地浏览、查询、插入、编辑和删除文档。这对于没有安装 Compass 的情况非常方便。
  • Security (安全): 管理数据库用户、网络访问白名单、加密设置、审计日志等。
  • Backup (备份): 配置和管理集群的备份策略（注意 M0 的限制）。
  • Settings (设置): 修改集群名称、升级层级、配置高级选项等。
  • Integrations (集成): 配置与其他 Atlas 服务（如 Atlas Search, Charts）或第三方服务的集成。

8. 进一步学习和探索

恭喜您！您已经成功创建并连接到您的第一个 MongoDB Atlas 集群。这仅仅是开始，Atlas 提供了丰富的功能等待您去探索。

以下是一些下一步的建议：

  1. 熟悉 MongoDB 查询语言 (MQL)： 学习如何使用 find(), insertOne(), updateOne(), deleteOne(), 聚合管道 (Aggregation Pipeline) 等命令来操作数据。
  2. 了解副本集 (Replica Sets)： 理解 Atlas 底层的高可用性架构，以及副本集的工作原理。
  3. 学习索引 (Indexes)： 理解索引如何提高查询性能，并在您的集合上创建适当的索引。
  4. 探索 Atlas 的其他功能： 试用 Atlas Search (全文搜索)、Atlas Charts (数据可视化)、Atlas Data Lake (查询 S3/Azure Blob 存储中的数据) 等。
  5. 阅读官方文档： MongoDB 官方文档 (https://docs.mongodb.com/) 是最权威、最详细的学习资源。特别是 Atlas 部分的文档，包含了所有功能的详细说明。
  6. 参与社区： 加入 MongoDB 社区论坛、Stack Overflow 等平台，与其他用户交流，寻求帮助。

9. 总结

本文详细介绍了 MongoDB Atlas 的入门过程，包括：

  • 了解 MongoDB Atlas 及其优势。
  • 注册 Atlas 账号。
  • 在 Atlas 中创建您的第一个免费 (M0) 数据库集群。
  • 配置数据库用户和网络访问安全规则。
  • 使用 MongoDB Shell、Compass 或应用程序驱动程序连接到集群。
  • 简要浏览 Atlas 控制面板。

通过遵循本指南的步骤，您现在应该已经能够成功地在云端拥有并访问您的第一个 MongoDB 数据库了。从这里开始，您可以根据您的项目需求深入学习 MongoDB 的各项功能，并利用 Atlas 提供的便利服务来加速您的开发进程。

祝您在 MongoDB Atlas 的学习和使用过程中一切顺利！如果您在实践中遇到任何问题，不要犹豫查阅官方文档或向社区寻求帮助。

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部