冷热分离（数据归档）

功能概述

冷热分离基于WiredTiger存储引擎与OSS对象存储的深度集成，以集合（Collection）为粒度，将整个集合的数据文件从本地磁盘上传至OSS冷存储。归档完成后，系统释放该集合占用的本地存储空间，并保留集合的元数据和索引定义，以便后续解归档时恢复数据。

冷热分离适用于以下场景：

• 日志类数据超过活跃查询周期后，需要低成本保留。

• 历史订单、交易记录等数据因合规要求需要长期保存，但访问频率较低。

• 业务数据持续增长导致本地磁盘容量不足，需要释放存储空间。

前提条件

使用冷热分离功能前，请确保实例满足以下条件。

申请开通冷热分离

冷热分离依赖特定的内核小版本。该版本暂未在控制台的小版本升级入口开放自助升级，需由技术支持确认资格并升级目标实例。

1. 确认目标实例满足前提条件。

2. 准备需要开通功能的实例ID，例如dds-bp1xxxxxxxxxxxxx。如需同时开通多个实例，请准备实例ID列表。

3. 通过工单或对接的技术支持渠道提交申请，并提供以下信息：

   • 实例ID（必填，可提供多个）。

   • 实例所在地域。

   • 期望开通时间窗口。

4. 等待技术支持为实例开通功能资格，并升级至支持冷热分离的内核小版本。

   重要

   升级会触发实例滚动重启和主备切换，业务可能出现秒级连接中断。请确保应用具备连接重试能力，并在业务低峰期执行升级。

5. 功能开通后，确认实例的数据归档入口已生效。

开通冷热分离

1. 登录云数据库MongoDB管理控制台。

2. 在左侧导航栏，选择副本集实例列表，找到目标实例。

3. 单击目标实例ID，进入实例基本信息页面。

4. 在左侧导航栏，选择数据归档。

5. 首次使用时，单击开通冷热分离。

   系统自动创建OSS存储空间并配置授权。开通通常需要1～2分钟，期间实例可正常对外提供服务，不影响现有业务。

6. 确认页面显示设置冷热数据分离和已归档冷数据页签。

   两个页签分别展示本地存储中的集合和已归档至OSS的集合。

归档集合

将本地集合归档至OSS冷存储，以释放本地磁盘空间。

1. 在数据归档页面，单击设置冷热数据分离页签。

2. 在集合列表中选择目标集合。

   说明

   每次仅支持归档一个集合。

3. 单击归档，确认集合信息，然后单击确定。

4. 在任务中心查看归档进度。

   归档期间，目标集合可读但不可写。

5. 归档完成后，确认集合从热数据列表移至冷数据列表。

   系统会释放集合占用的本地存储空间。

解归档集合

已归档集合可读但不可写。如需写入、更新或删除集合数据，请将冷数据恢复至本地存储，使集合恢复正常读写。

1. 在数据归档页面，单击已归档冷数据页签。

2. 在已归档集合列表中选择目标集合。

3. 单击解归档，确认集合信息，然后单击确定。

4. 在任务中心查看解归档进度。

   解归档期间，目标集合不可访问。

5. 解归档完成后，确认集合从冷数据列表移至热数据列表，并恢复正常读写。

集合读写能力

集合在不同状态下的读写能力不同。请在操作前确认业务可以接受对应限制。

查看归档状态

在数据归档页面，通过设置冷热数据分离和已归档冷数据页签查看集合的分布状态。页面会显示数据库名、集合名和数据大小等信息。正在归档或解归档的集合会显示任务进度。

使用限制

注意事项

• 版本升级：升级至支持冷热分离的内核小版本会触发滚动重启和一次主备切换。请确保应用具备连接重试能力，并预留升级窗口。

• 归档后的写入限制：归档任务启动后，目标集合立即变为只读。所有写操作（insert、update和delete）以及在该集合上创建索引等DDL操作均会失败。归档前，请确认集合已退出写入链路。若业务仍在写入该集合，请先切流或停止写入。

• 解归档期间的访问限制：解归档期间，集合完全不可访问，读写操作均会失败。解归档完成后，集合自动恢复正常读写，无需额外操作。

• 解归档耗时：从OSS下载数据的带宽低于上传带宽，且恢复过程涉及WiredTiger数据文件的重建和校验，因此解归档耗时通常为归档耗时的3～5倍。归档集合前，请评估业务能否接受未来解归档时数小时的不可用窗口。

• 操作窗口：请在业务低峰期执行归档和解归档，以减少任务对实例中其他集合读写性能的影响。

• 任务异常：如果归档或解归档任务长时间无进展或执行失败，请提交工单联系技术支持。