对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

从本地下载的快照恢复

Atlas提供了一种将 Flex集群和专用集群快照下载为压缩文件的机制。

注意

您无法通过 Atlas 用户界面将当地下载的快照导回 Atlas 集群。要将快照恢复到 Atlas 集群中,请将快照导出到云对象存储桶,然后将其导入。要了解更多信息,请参阅 将云备份快照导出到对象存储将已存档快照导入 Atlas。

Atlas会在恢复之前删除目标集群上的所有现有数据。 目标集群在恢复期间可用。

如果手动下载备份快照失败,Atlas 会保持请求有效,并允许您重新启动备份,前提是最近一次下载失败发生在不超过一小时前。

对于部署在 AWS、 Azure或 Google Cloud 上的Atlas集群,如果您配置了任何私有端点, Atlas允许您通过与快照位于同一地区的私有端点下载快照。通过私有端点下载快照可能会产生费用。要学习;了解更多信息,请参阅私有端点。

您可以使用与下载未加密快照相同的方式下载加密快照。 作为安全最佳实践,我们建议对项目的加密密钥进行基于角色的访问权限。

从本地下载的快照中恢复时,除了先决条件外,还要考虑以下要求和限制。

  • 如果源快照上的 DefaultRWConcern 值与目标集群上的 DefaultRWConcern 值不同,Atlas 会使用目标集群上的值覆盖源快照上的值。如果目标集群上没有为 DefaultRWConcern 配置值,Atlas 将保留快照中 DefaultRWConcern 的值,而无需显式配置。这可能与该 MongoDB 版本的默认值不同。
  • 此功能不适用于免费集群(以前称为 M0)。

  • 下载的文件包括从data mongorestore目录复制的原始文件。 与这些文件不兼容。要访问权限数据文件,请使用以下过程启动 mongod实例并将其点解压缩目录。

  • 如果您位于或接近云提供商的私有端点,则可能无法通过私有端点下载快照。在这种情况下,请使用Atlas提供的公共下载端点。

Project Backup Manager要下载备份快照,您必须对该项目具有Project Owner 或 访问权限。

1
  1. 如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含项目的组织。

  2. 如果尚未显示,请从导航栏的 Projects 菜单中选择您的项目。

  3. 在侧边栏中,单击 Database 标题下的 Backup

    此时会显示备份详细信息。

  4. 单击集群链接。

2
  1. 单击 Snapshots(快照)子标签页。

  2. Actions 列中,展开 Actions 菜单,然后单击要下载的快照的 Download

    Atlas生成一次性下载链接,该链接在创建后 1 小时内过期。对于 AWS、 Azure或 Google Cloud, Atlas还会为与快照位于同一地区中的任何已配置私有端点生成一次性下载链接。

    创建此链接所需的时间随着 Atlas 集群的增大而增加。

下载准备就绪后,Atlas 会:

  • 通过电子邮件向您发送警报,告知您快照下载已准备就绪。

  • Restores & Downloads标签页中显示下载链接。

注意

可通过 API 获取

作为另一种选择,您可以使用API请求恢复快照。 Atlas Administration API在deliveryUrl 字段中返回下载链接(如果通过公共互联网下载),在privateDownloadDeliveryUrls 字段中返回下载链接(通过快照所在地区的私有端点下载)。

3

如果当前项目IP访问列表范围未涵盖目标客户端IP或 CIDR解决,请单击 Add or Modify your IP Addresses 可更改Atlas项目IP访问列表。

4
  1. 如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含项目的组织。

  2. 如果尚未显示,请从导航栏的 Projects 菜单中选择您的项目。

  3. 在侧边栏中,单击 Database 标题下的 Backup

    此时会显示备份详细信息。

  4. 单击集群链接。

5
  1. 单击 Restores & Downloads(快照)子标签页。

  2. 导航到您创建的恢复快照。

  3. 单击 Download(连接)。

6

Atlas会将快照压缩到.tar.gz 文件中。此存档包括快照和mongod 日志。

  1. 提取存档中的文件。

    例子

    以下命令使用 tar 实用程序来提取 tar``archive with ``gzip 压缩文件。

    tar -xvzf ~/Downloads/mongodb-snapshots/my-cluster-snapshot.tar.gz
  2. mongod通过在托管上启动 实例并使用--dbpath 选项将其指向解压缩目录来访问数据文件。要学习;了解更多信息,请参阅启动mongod进程。

    例子

    mongod以下命令使用提取的数据文件目录启动 实例:

    mongod --dbpath ~/Downloads/mongodb-snapshots/my-cluster-snapshot/