MongoDB Atlas 入门指南：全面介绍 – wiki基地

作者： /

MongoDB Atlas 入门指南：全面介绍

前言

在当今数据爆炸的时代，数据库作为应用程序的核心组件，其重要性不言而喻。MongoDB 作为领先的文档型数据库，以其灵活的数据模型、易于扩展的特性，赢得了全球众多开发者和企业的青睐。然而，数据库的部署、管理和维护是一项复杂且耗时的工作，尤其是随着业务规模的增长，运维的挑战更是日益突出。

正是在这样的背景下，MongoDB Atlas 应运而生。MongoDB Atlas 是 MongoDB 官方提供的全托管云数据库服务。它将复杂的数据库运维工作交由 MongoDB 专业团队处理，让开发者可以专注于构建伟大的应用，而无需为数据库的底层基础设施、高可用性、备份恢复、安全补丁等繁琐事务操心。

本篇文章将为您提供一个全面而深入的 MongoDB Atlas 入门指南，从零开始，带您了解 Atlas 的核心概念、优势，并手把手教您如何创建您的第一个 Atlas 集群，进行基本的配置和操作，从而开启您的云数据库之旅。无论您是刚刚接触 MongoDB 的新手，还是希望从自建数据库迁移到云端的现有用户，本文都将为您提供有价值的参考。

第一部分：什么是 MongoDB Atlas？为何选择它？

什么是 MongoDB Atlas？

简单来说，MongoDB Atlas 是一个运行在主流云平台（如 AWS, Google Cloud, Azure）上的、完全由 MongoDB 官方管理的数据库服务。这意味着您无需自己购买、配置或维护服务器，也无需安装和升级 MongoDB 软件，更不用担心复杂的集群搭建、分片配置或副本集管理。所有这些繁重的任务，都由 Atlas 平台替您完成。

您可以将其想象成一个“数据库即服务”（Database as a Service, DBaaS）平台，您只需通过简单的界面操作或 API 调用，就能按需创建、配置、扩展和管理您的 MongoDB 数据库集群。

为何选择 MongoDB Atlas？

选择 MongoDB Atlas 而非传统的自建数据库或在云虚拟机上自行部署，主要有以下几个核心优势：

  1. 全托管，运维无忧： 这是 Atlas 最大的亮点。Atlas 负责集群的部署、监控、备份、恢复、扩容、安全补丁、版本升级等一切运维工作。这极大地降低了运维成本和技术门槛，让开发者可以更专注于业务逻辑的实现。
  2. 高可用与可靠性： Atlas 默认采用副本集架构，确保数据冗余和自动故障转移。对于更高要求的部署，Atlas 支持跨区域甚至跨云提供高可用性，确保服务持续在线。
  3. 弹性伸缩： 无论是面对业务流量的激增，还是为了控制成本在低谷时缩减资源，Atlas 都能轻松应对。您可以根据需求按需扩展或缩减集群的计算资源（CPU、RAM）和存储容量，甚至是进行自动化扩展。对于大型应用，Atlas 还支持自动化分片（Sharding），解决海量数据存储和高并发访问的挑战。
  4. 强大的安全性： 安全是云数据库的基石。Atlas 提供了多层面的安全措施，包括：
    • 网络安全：IP 白名单、VPC Peering/Private Endpoint、TLS/SSL 加密传输。
    • 身份认证与授权：SCRAM 认证、x.509 认证、LDAP/Active Directory 集成、基于角色的访问控制（RBAC）。
    • 静态数据加密：存储在磁盘上的数据会自动加密。
    • 审计日志：记录数据库活动，便于合规和安全分析。
  5. 全球化部署： Atlas 支持在 AWS、Google Cloud 和 Azure 的全球多个区域部署。您可以选择离用户最近的区域部署数据库，降低访问延迟，提供更好的用户体验。
  6. 丰富的功能生态： Atlas 不仅仅是一个数据库服务，它还集成了 MongoDB 的诸多高级功能和周边工具，形成一个完整的云数据平台，例如：
    • Atlas Search: 基于 Apache Lucene 的全文搜索功能，与数据库无缝集成。
    • Atlas Data Lake: 无服务器的查询服务，可以直接查询存储在云存储（S3, GCS, Blob Storage）中的数据，无需 ETL。
    • Atlas App Services: 提供Functions (无服务器函数)、Hosting (静态网站/应用托管)、GraphQL API、设备同步等服务，加速应用开发。
    • Atlas Triggers: 基于数据库事件执行无服务器函数。
    • 强大的监控和告警： 提供详细的性能指标、日志，并支持灵活的告警配置。
    • 可视化工具： 内置 Data Explorer，方便浏览和操作数据；与 MongoDB Compass 集成，提供更强大的 GUI 工具。
  7. 成本效益： Atlas 提供按需付费模式，避免了初期大量硬件投入。对于小型项目或学习用途，还提供了免费的 M0 集群，让您能够零成本体验 MongoDB 的强大。

综上所述，MongoDB Atlas 提供了一个高性能、高可用、安全可靠且易于管理的云数据库解决方案，让您可以专注于业务创新，而不是耗费精力在复杂的数据库运维上。

第二部分：MongoDB Atlas 入门实操：创建您的第一个集群

本部分将引导您完成注册、创建项目、创建集群以及配置基本的安全访问。

步骤 1：注册 MongoDB Atlas 账号

  1. 访问 MongoDB Atlas 官方网站：https://www.mongodb.com/cloud/atlas
  2. 点击页面上的“Try Free”或“Sign Up”按钮。
  3. 您可以使用 Google 账号、GitHub 账号或通过邮箱和密码进行注册。填写所需信息，同意服务条款。
  4. 完成注册后，您可能需要验证您的邮箱地址。

步骤 2：创建组织和项目

注册成功并首次登录 Atlas 时，您会看到一个向导页面，引导您设置您的账户。

  1. 创建一个组织 (Organization): 组织是 Atlas 的最高级别管理单元，通常代表一个公司或团队。您可以给组织命名（例如：我的公司）。
  2. 创建一个项目 (Project): 项目是组织下的逻辑分组，用于存放相关的数据库集群。一个组织可以有多个项目。通常，一个项目对应一个应用、一个服务或一个环境（如开发环境、生产环境）。给项目命名（例如：我的第一个项目）。
  3. 选择您希望使用的编程语言（这不影响集群创建，只是为了提供后续连接代码示例）。
  4. 点击“Create Organization and Project”。

至此，您已经成功创建了您的组织和项目，进入了项目的控制面板。

步骤 3：创建您的第一个数据库集群 (Cluster)

集群是实际运行 MongoDB 数据库的地方。对于初学者或小型项目，Atlas 提供了免费的 M0 共享集群。

  1. 在项目控制面板首页，您会看到一个醒目的按钮，通常是“Build a Database”或“Create”。点击它。
  2. 选择部署类型：通常有三种选项：
    • Dedicated: 独享资源，性能高，适合生产环境（M10 及以上）。
    • Serverless: 无服务器数据库，按需付费，自动扩展（不适合 M0）。
    • Shared: 共享资源，免费层级 M0 属于此类，适合开发测试或小型应用。
      选择 Shared (免费层级)。
  3. 选择云服务提供商和区域：
    • Cloud Provider: 选择您偏好的云平台，例如 AWS, Google Cloud, 或 Azure。免费层级可能仅支持部分云平台。
    • Region: 选择一个离您或您的目标用户地理位置最近的区域。这可以最小化访问延迟。请注意，不同区域提供的免费层级可能不同，选择标有 “Free Tier Available” 的区域。
  4. 选择集群层级 (Cluster Tier):
    • 对于免费层级，只能选择 M0。它提供 512MB 存储空间，是共享的 CPU 和 RAM 资源。请注意 M0 的限制：不提供自动备份（仅按需手动备份）、连接数有限、性能较低、不支持某些高级功能（如分片、Atlas Search、Data Lake 等）。它非常适合学习和小型开发测试。
    • （对于付费层级，您会看到 M10, M20, M30 等选项，数字越大，资源越多，性能越高。M10 是最低的专用集群）。
  5. 选择 MongoDB 版本 (MongoDB Version): 通常选择推荐的最新稳定版本即可。
  6. 集群名称 (Cluster Name): 给您的集群一个易于识别的名称。例如：MyFirstAtlasCluster。
  7. 确认配置后，点击“Create Cluster”。

创建集群需要几分钟时间（通常 5-15 分钟），Atlas 会在后台为您部署副本集。您可以等待其状态变为“Deployment Complete”。

步骤 4：配置安全访问 (非常重要！)

在集群创建过程中或创建完成后，您需要配置如何安全地访问您的数据库。Atlas 强制要求进行身份验证和网络访问控制。

  1. 设置数据库用户 (Set up your database user):

    • 这是连接到数据库时使用的用户名和密码，而不是您的 Atlas 账号。
    • 点击左侧导航栏的 “Database Access”。
    • 点击 “Add New Database User”。
    • Authentication Method: 选择 “Password”。
    • Username: 输入一个用户名（例如：myUser）。
    • Password: 非常重要！ 输入一个强密码或使用 “Autogenerate Secure Password” 生成一个。请务必记下或安全保存此密码，因为一旦创建，您将无法在界面上再次看到它。
    • Database User Privileges: 选择用户的权限。对于入门，可以选择 “Read and write to any database” 或更精细的权限。
    • 点击 “Add User”。

  2. 设置网络访问 (Set up your network access):

    • 这是配置哪些 IP 地址可以连接到您的集群。出于安全考虑，默认是禁止任何 IP 连接的。
    • 点击左侧导航栏的 “Network Access”。
    • 点击 “Add IP Address”。
    • Choose IP Address:
      • 如果您是在自己的电脑上连接，并且您的 IP 地址是固定的，可以选择 “Add Current IP Address”。
      • 如果您希望从任何地方连接（强烈不推荐用于生产环境！仅用于临时测试或某些特殊开发场景），可以选择 “Allow Access from Anywhere” (输入 0.0.0.0/0)。Atlas 会弹出安全警告。请谨慎使用！ 更好的做法是只添加您需要连接的特定 IP 地址范围。
      • 如果您是在云环境中部署应用，并且该应用需要连接到 Atlas 集群，强烈建议使用 VPC Peering 或 Private Endpoint (M10+ 特性)，而不是通过公网 IP 访问。
    • Comment (Optional): 添加描述，例如 “我的家用电脑 IP”。
    • 点击 “Confirm”。

配置完成后，您的集群已经创建并配置了基本的安全访问。现在您可以尝试连接到它了。

第三部分：连接到您的 MongoDB Atlas 集群

有多种方式可以连接到您的 Atlas 集群，最常用的是使用 MongoDB Shell (mongosh)、MongoDB Compass (GUI 工具) 或在您的应用程序中使用相应的驱动程序。

在集群概览页面，当集群状态变为可用后，您会看到一个 “Connect” 按钮。点击它。Atlas 会弹出连接向导。

方式 1：使用 MongoDB Shell (mongosh) 连接

mongosh 是官方推荐的新一代 MongoDB Shell 工具。如果您还没有安装，需要先下载安装它。

  1. 在连接向导中，选择 “Connect with the MongoDB Shell”。
  2. 选择您安装的 Shell 版本 (mongosh 或旧版 mongo)。
  3. Atlas 会为您生成一个连接字符串。它看起来类似这样（注意：连接字符串中的 <password> 和 <myDatabase> 是占位符）：
    bash
    mongosh "mongodb+srv://<username>:<password>@myfirstatlascluster.abcde.mongodb.net/<myDatabase>?retryWrites=true&w=majority"
  4. 复制此连接字符串。
  5. 打开您的终端或命令行工具。
  6. 将连接字符串粘贴到命令行中，并替换 <username> 为您在步骤 4.1 创建的数据库用户名，将 <password> 替换为您在步骤 4.1 创建的数据库密码。<myDatabase> 可以替换为您想要连接的默认数据库名称，如果留空，默认连接到 test 数据库。
  7. 按回车执行命令。
  8. 如果一切配置正确（IP 允许访问，用户名密码正确），您应该能成功连接到您的 Atlas 集群，并看到 > 提示符。

注意： 连接字符串中的 +srv 告诉驱动程序使用 DNS Seed List 方式连接，这是连接到副本集或分片集群的推荐方式，它会自动发现所有的节点。

方式 2：使用 MongoDB Compass 连接

MongoDB Compass 是 MongoDB 官方提供的图形化用户界面 (GUI) 工具，方便您浏览数据、执行查询、分析性能等。

  1. 如果您还没有安装 Compass，需要先下载安装它：https://www.mongodb.com/products/compass
  2. 在 Atlas 连接向导中，选择 “Connect with MongoDB Compass”。
  3. 选择您已安装的 Compass 版本。
  4. Atlas 会为您生成一个连接字符串（与 mongosh 类似）。复制此字符串。
  5. 打开 MongoDB Compass。
  6. Compass 通常会自动检测剪贴板中的连接字符串并弹出连接窗口。如果未弹出，点击左上角的 “New Connection”。
  7. 将复制的连接字符串粘贴到 URI 字段。同样，请替换 <password> 为您的数据库密码。
  8. 点击 “Connect”。
  9. 如果连接成功，您将在 Compass 中看到您的集群信息、数据库和集合。

方式 3：在应用程序中使用驱动程序连接

在您的应用程序代码中连接 Atlas 集群是最终目标。各种流行的编程语言（如 Node.js, Python, Java, C#, Go 等）都有官方或社区维护的 MongoDB 驱动程序。

  1. 在 Atlas 连接向导中，选择 “Connect your Application”。
  2. 选择您的驱动程序和版本。
  3. Atlas 会生成适用于您选择的语言和驱动程序的连接代码片段。
  4. 复制此代码片段。
  5. 将代码粘贴到您的应用程序中，并替换连接字符串中的 <username> 和 <password> 占位符为您实际的数据库用户名和密码。
  6. 确保您的应用程序运行环境的 IP 地址已经被添加到 Atlas 的网络访问列表中（步骤 4.2）。
  7. 运行您的应用程序进行测试连接。

示例 (Node.js):

“`javascript
const { MongoClient, ServerApiVersion } = require(‘mongodb’);

// 替换为您的连接字符串，并手动替换 const uri = “mongodb+srv://:@myfirstatlascluster.abcde.mongodb.net/?retryWrites=true&w=majority”;

// Create a MongoClient with a MongoClientOptions object to set the Stable API version
const client = new MongoClient(uri, {
serverApi: {
version: ServerApiVersion.v1,
strict: true,
deprecationErrors: true,
}
});

async function run() {
try {
// Connect the client to the server (optional starting in v4.7)
await client.connect();
// Send a ping to confirm a successful connection
await client.db(“admin”).command({ ping: 1 }); // 可以替换 “admin” 为您想连接的数据库
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);
``
将和` 替换为您创建的数据库用户凭据。

第四部分：MongoDB Atlas 基本功能介绍

成功连接到集群后，您就可以开始使用它了。Atlas 控制面板提供了丰富的功能来管理和监控您的集群。

1. 数据浏览器 (Data Explorer)

这是在浏览器中直接查看、插入、编辑和删除数据的便捷工具，尤其适合快速浏览和简单操作。

  • 在集群概览页面，点击您的集群名称。
  • 在左侧导航栏，选择 “Collections”。
  • 这里会列出您集群中的所有数据库和集合。
  • 您可以：
    • 点击数据库和集合名称来浏览文档。
    • 点击 “Insert Document” 添加新文档。
    • 编辑或删除现有文档。
    • 使用 Filter 框输入查询条件（JSON 或 Extended JSON 格式）。
    • 使用 Indexes 标签页查看和创建索引（注意：对于文档型数据库，合理利用索引是提升查询性能的关键！）。
    • 使用 Aggregation 标签页构建和测试聚合管道。

2. 性能监控 (Monitoring)

Atlas 提供详细的集群性能指标，帮助您了解集群的健康状况和负载情况。

  • 在集群概览页面，点击您的集群名称。
  • 在左侧导航栏，选择 “Metrics”。
  • 您可以看到各种图表，如：
    • Operations: 显示每秒的读、写、命令操作数。
    • Connections: 显示当前活动的连接数。
    • CPU Usage: 集群节点的 CPU 利用率。
    • Memory Usage: 集群节点的内存使用情况。
    • Disk Latency/IOPS: 磁盘读写延迟和每秒操作数。
    • Network Traffic: 网络进出流量。
    • Opcounters: 更细粒度的操作计数。
  • 这些指标是排查性能问题的重要依据。

3. 实时性能面板 (Real-Time Performance Panel)

提供集群当前操作的实时视图，可以帮助您发现和终止慢查询。

  • 在集群概览页面，点击您的集群名称。
  • 在左侧导航栏，选择 “Real-Time Performance”。
  • 您可以看到当前正在执行的操作，包括查询、插入、更新等，以及它们的状态和耗时。

4. 日志 (Logs)

数据库日志记录了集群的关键事件和错误信息，对于故障排查至关重要。

  • 在集群概览页面，点击您的集群名称。
  • 在左侧导航栏，选择 “Logs”。
  • 您可以查看不同组件（如数据库、备份）的日志，并进行过滤和搜索。

5. 备份 (Backups)

数据备份是防止数据丢失的最后一道防线。

  • 对于 M10 及以上集群，Atlas 提供自动化的云备份（将快照存储在 S3, GCS, Blob Storage）。
  • 对于 M0 集群，不提供自动备份。您可以通过 Compass 或 mongodump 工具进行手动按需备份，并将备份文件下载保存到本地。
  • 在左侧导航栏，选择 “Backup”。这里管理您的备份策略（付费集群）和恢复点。

6. 安全 (Security)

除了之前设置的数据库用户和网络访问外，Atlas 还提供其他安全功能。

  • Database Access: 管理数据库用户及其权限。
  • Network Access: 管理允许连接的 IP 地址列表。
  • Authentication Methods: 配置更高级的认证方式（如 LDAP）。
  • Encryption at Rest: 查看静态数据加密状态（Atlas 默认开启）。
  • Audit Logs: 配置审计日志（付费功能），记录所有数据库操作，便于合规和安全审计。

7. 扩展集群 (Scaling)

当您的业务增长，M0 集群无法满足需求时，您可以升级集群。

  • 在集群概览页面，点击您的集群名称。
  • 点击右上角的 “…” 菜单，选择 “Scale”。
  • 您可以升级到更高的 M 层级（垂直扩展）。
  • 对于非常大的数据集或高并发，可以启用分片（Horizontal Sharding），将数据分布到多个副本集上（M30+ 或更高）。
  • 注意：M0 共享集群无法进行垂直或水平扩展。要扩展，您需要创建一个新的 M10+ 专用集群，并将数据迁移过去。

第五部分：Atlas 高级功能简介 (M10+ 集群或特定功能)

虽然本指南主要面向入门，但了解一些 Atlas 的高级功能会让您对平台的潜力有更全面的认识。这些功能通常需要付费的 M10 或更高层级集群才能使用。

  • Atlas Search: 在您的 MongoDB 数据上执行高性能的全文搜索、模糊匹配、地理空间搜索等。无需将数据同步到独立的搜索引擎。
  • Atlas Data Lake / Federation: 直接查询存储在云存储（如 Amazon S3）中的数据，无需将其导入到 MongoDB。Atlas Data Federation 甚至可以联合查询 Atlas 数据库和云存储中的数据。
  • Atlas App Services: 一个无服务器后端平台，集成了 Functions (无服务器函数)、GraphQL API、Web Hosting、Mobile Sync 等服务，简化了构建现代应用的流程。
  • Private Endpoint / VPC Peering: 通过私有网络连接您的云环境和 Atlas 集群，避免数据流量经过公网，提高安全性和降低延迟。
  • Performance Advisor: 分析慢查询，并提供创建索引的建议，帮助优化数据库性能。
  • Schema Advisor: 分析您的数据模式，提供潜在的优化建议。

第六部分：成本考量

  • M0 Free Tier: 免费，但资源有限，无 SLA，无自动备份，适合学习、开发和小型非关键应用。
  • Dedicated Clusters (M10+): 按小时计费，费用取决于选择的云平台、区域、集群层级（计算资源）、存储容量、以及是否使用高级功能（如 Atlas Search、Data Lake）。费用是按需支付，没有长期合约（除非您主动购买保留实例）。
  • 理解计费项: 主要包括计算（实例大小）、存储（数据量）、数据传输（出站流量）、备份存储、以及使用的附加功能。在创建集群时，Atlas 会提供预估费用。

第七部分：学习资源和社区

  • MongoDB University (M0 集群免费): 提供大量免费的在线课程，涵盖 MongoDB 基础、开发、运维以及 Atlas 的使用。
  • MongoDB Documentation: 官方文档是学习和查阅详细信息最权威的来源。
  • MongoDB Community Forums: 在社区论坛中提问和交流经验。
  • Atlas In-App Help: Atlas 控制面板内置了帮助和支持选项。

第八部分：常见问题与故障排除 (入门阶段)

  • 无法连接到集群:
    • 检查网络访问: 确保您的连接 IP 地址已添加到 Atlas 的 Network Access 列表中。如果是动态 IP，需要更新或暂时使用 0.0.0.0/0 (仅限非生产测试)。
    • 检查防火墙: 确保您的本地防火墙、公司网络防火墙或云服务器的安全组允许出站连接到 Atlas 集群所在的端口（通常是 27017，但在 Atlas 的连接字符串中使用 +srv 方式连接时，实际连接的是 DNS 返回的端口，通常也是 27017，但网络路径不同）。如果使用了 Private Endpoint/VPC Peering，检查相应的安全组规则。
    • 检查连接字符串: 确保连接字符串复制完整，特别是参数部分 (?retryWrites=true&w=majority 等)。
    • 检查用户名和密码: 确认您使用的是在 Database Access 中创建的数据库用户的用户名和密码，而不是您的 Atlas 账号密码。密码区分大小写。
    • 检查集群状态: 确保您的集群状态是可用的（Deployment Complete）。
  • 连接成功但无法访问数据:
    • 检查数据库用户权限: 确保您连接使用的数据库用户拥有足够的权限来读写您尝试访问的数据库和集合。
  • Compass 或 Shell 报证书错误:
    • 确保您的操作系统时间是准确的。
    • 如果是在公司网络，可能存在网络代理或证书拦截，需要联系您的 IT 部门。

总结

通过本篇全面的入门指南，您应该对 MongoDB Atlas 有了一个清晰的认识，并掌握了如何从零开始创建和连接您的第一个 Atlas 集群。我们了解了 Atlas 作为全托管云数据库服务的巨大优势，包括运维的便捷性、高可用性、弹性伸缩和强大的安全性。我们还一步步实践了注册、创建项目、创建集群以及配置关键的安全访问设置。最后，我们探索了 Atlas 控制面板中的基本功能，如数据浏览、性能监控和日志查看，并简要介绍了高级功能和成本考量。

MongoDB Atlas 极大地简化了数据库管理，让您可以将精力集中在更有价值的业务逻辑和应用创新上。从 M0 免费集群开始，大胆探索 MongoDB 的强大功能吧！随着您的项目成长，Atlas 可以轻松扩展以满足您不断变化的需求。

数据库的世界广阔而深入，Atlas 提供了坚实可靠的基础。继续学习，不断实践，您将在数据驱动的应用开发之路上越走越远。

希望这篇指南对您有所帮助！祝您使用 MongoDB Atlas 愉快！

发表评论

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

滚动至顶部