导出云备份快照

注意

此功能不适用于 M0 免费集群和 Flex 集群。要详细了解哪些功能不可用，请参阅 Atlas M0（免费集群）限制。

Atlas允许您将云备份快照导出到对象存储服务。

要了解如何管理自动备份策略和计划，请参阅管理备份策略。

支持的存储服务

Atlas目前支持以下对象存储服务：

AWS S3 存储桶
Azure Blob 存储
Google Cloud Storage 存储桶

此外，Atlas支持使用 PrivateLink 将快照导出到 AWS S3 存储桶。

Atlas 如何导出快照

注意

如果您将备份导出到Amazon Web Services S3，则可以启用Amazon Web Services S3 对象锁，以确保合规和安全性所需的备份文件的不变性。对象锁可防止删除和修改导出的备份文件。

您可以手动导出单个快照，也可以设置导出策略来自动导出快照。对于自动导出，您必须在导出策略中指定频率：

每日
每周
每月
每年

Atlas 可自动导出频率类型与导出频率匹配的任何备份快照。导出的结果是该快照的完整备份。

例子

请考虑以下内容：

设立每周和每月快照计划的备份策略
设置每月导出频率的导出策略

假设在月底，每周和每月的快照发生在同一天。将有 4 个快照，其中 3 个是每周快照，第四个快照虽然被 Atlas 视为每周快照，但它也是每月快照，因为发生在同一天。Atlas 只会导出每月快照，因为导出频率与该快照的快照频率匹配。要同时导出每周快照，请将导出策略更新为同时导出每周快照。如果导出频率设置为每周，Atlas 将导出全部 4 个快照。

随着导出的进行，您可能会在对象存储服务中看到部分结果。

无论“生存时间”设置如何， Atlas都会将文档保留在快照中。您可以在超过“生存时间”截止时间后的快照中访问权限这些文档。

要学习；了解快照导出定价，请参阅快照导出成本。

Atlas 上传的文件

当您执行以下操作时，Atlas 会将空文件上传到 /exported_snapshots/.permissioncheck：

添加用于导出的新对象存储
开始导出

完成导出后，Atlas 会为每个集合上传名为 .complete 和 metadata.json 的元数据文件。

Atlas会将名为 .complete 的元数据文件上传到对象存储的以下路径中：

/exported_snapshots/<orgUUID>/<projectUUID>/<clusterName>/<initiationDateOfSnapshot>/<timestamp>/

注意

默认情况下，Atlas 在元数据文件的路径中使用组织和项目 UUID。要使用组织和项目名称而不是 UUID，请通过 API 将 useOrgAndGroupNamesInExportPrefix 标志设置为 true。Atlas 会用下划线 (_) 替换所有空格，并从路径中的组织和项目名称中删除任何可能需要特殊处理的字符和应避免使用的字符。

.complete 元数据文件采用 JSON 格式，包含以下字段：

字段	说明
`orgId`	唯一的 24 位十六进制数字字符串，用于标识 Atlas 组织。
`orgName`	Atlas 组织的名称。
`groupId`	唯一的 24 位十六进制数字字符串，用于标识 Atlas 组织中的项目。
`groupName`	Atlas 项目的名称。
`clusterUniqueId`	用于标识 Atlas 集群的唯一的 24 位十六进制数字字符串。
`clusterName`	Atlas 项目的名称。
`snapshotInitiationDate`	拍摄快照的日期。
`totalFiles`	上传到对象存储的文件总数。
`labels`	已导出快照的集群所具有的标签。
`customData`	您在创建导出作业时指定的自定义数据（如果有）。

例子

{
  "orgId": "60512d6f65e4047fe0842095",
  "orgName": "org1",
  "groupId": "60512dac65e4047fe084220f",
  "groupName": "group1",
  "clusterUniqueId": "60512dac65e4047fe0842212",
  "clusterName": "cluster0",
  "snapshotInitiationDate": "2020-04-03T05:50:29.321Z"
  "totalFiles": 23,
  "labels": [
    {
      "key": "key1",
      "value": "xyz"
    },
    {
      "key": "key2",
      "value": "xyzuio"
    }
  ],
  "customData": [
    {
      "key": "key1",
      "value": "xyz"
    },
    {
      "key": "key2",
      "value": "xyzuio"
    }
  ]
}

Atlas将每个集合的 metadata.json文件上传到对象存储的以下路径中：

/exported_snapshots/<orgUUID>/<projectUUID>/<clusterName>/<initiationDateOfSnapshot>/<timestamp>/<dbName>/<collectionName>/metadata.json

注意

默认情况下，Atlas 在元数据文件的路径中使用组织和项目 UUID。要使用组织和项目名称而不是 UUID，请通过 API 将 useOrgAndGroupNamesInExportPrefix 标志设置为 true。Atlas 会用下划线 (_) 替换所有空格，并从路径中的组织和项目名称中删除任何可能需要特殊处理的字符和应避免使用的字符。

元数据文件采用 JSON 格式，包含以下字段：

字段	说明
`collectionName`	用于标识集合的用户可读标签。
`indexes`	以 db.collection.getIndexes 命令返回的格式列出集合上的所有索引。
`options`	在集合上定义的配置选项。要了解有关选项的更多信息，请参阅 db.createCollection() 命令。
`type`	（可选）集合类型。此字段仅支持时间序列集合，其值为 `timeseries`。对于标准集合，请将此字段保留为未设置。 Atlas不支持导出 `view` 类型集合。
`uuid`	集合的 UUID。要了解有关 UUID 的更多信息，请参阅UUID。

例子

{
  "options":{
    "viewOn":"othercol",
    "pipeline":[{"$project":{"namez":"$name"}}]
  },
  "indexes":[],
  "collectionName":"viewcol",
  "type":"view"
}

{
  "options":{
    "timeseries":{
      "timeField":"timestamp",
      "granularity":"seconds",
      "bucketMaxSpanSeconds":{"$numberInt":"3600"}
    }
  },
  "indexes":[],
  "collectionName":"timeseriescol",
  "type":"timeseries"
}

{
  "indexes": [
    {
      "v":{"$numberInt":"2"},
      "key":{
        "_id":{"$numberInt":"1"}
      },
      "name":"_id_"
    }
  ],
  "uuid":"342c40a937c34c478bab03de8ce44f3e",
  "collectionName":"somecol"
}

如果导出作业失败：

Atlas 不会自动尝试再次导出。
Atlas不会删除对象存储中的任何部分数据。

导出的数据格式

Atlas上传经过gzip 压缩的扩展JSON2 (v) 文档。Atlas不会按顺序上传这些文档。以下是对象存储上文件的路径：

/exported_snapshots/<orgName>/<projectName>/<clusterName>/<initiationDateOfSnapshot>/<timestamp>/<dbName>/<collectionName>/<shardName>.<increment>.json.gz

其中：

`<orgName>`	您的 Atlas 组织的名称。
`<projectName>`	您的 Atlas 项目的名称。
`<clusterName>`	您的 Atlas 集群的名称。
`<initiationDateOfSnapshot>`	拍摄快照的日期。
`<timestamp>`	创建导出作业时的时间戳。
`<dbName>`	Atlas 集群中数据库的名称。
`<collectionName>`	Atlas 集合的名称。
`<shardName>`	副本集的名称。对于分片的集合，这是主分片的名称。
`<increment>`	上传数据段时递增的计数。从 `0` 开始。

限制

您无法执行以下操作：

导出回退快照。
每个快照都有多个活动导出。
导出视图集合或系统集合，但<database>.system.js 集合除外。
从启用了IP限制静态加密的Atlas项目中的集群导出快照。
在为私有端点配置的项目中，从Azure 或 Google Cloud Storage 上托管的集群导出快照。

必需的访问权限

要管理云备份快照，您必须拥有项目的 Project Backup Manager 或 Project Owner 访问权限。

拥有 Organization Owner 访问权限的用户必须将自己添加为项目的 Project Backup Manager 或 Project Owner，然后才能管理云备份快照。

导出管理

云服务提供商

连接类型

接口

后退

使用静态加密进行恢复

来年

恢复资源