数据完整性说明
最后更新：2026-09-24
本文回答如下问题：你的备份里到底有什么、这些东西是否可信、以及哪些情况下它不会完整。
摘要
- 每次备份都是全量备份。
- 备份包含页面、数据库与数据源、数据库视图、数据库行、块、评论（可开关控制）、用户、文件附件以及外部媒体文件（可开关控制）。
- 相同内容只存一份。实际数据和独立文件都去重后存储，删除某个版本不会破坏其他版本仍在引用的文件。
- 每次备份都有完整的备份报告，包含页面、数据库、数据库行、块、评论、视图、用户各自的计数以及警告或者错误信息。
- 归档的导出与导入都带完整性校验。
- 完整性有边界：集成权限之外的内容、Notion API 不返回的字段、少数已知的 Notion 侧问题，以及免费版单次任务的对象数上限。
一、备份里有什么
一次备份会包含：
- 页面：正文、属性、图标、封面与层级关系
- 数据库与数据源：属性结构、选项与关联关系
- 数据库视图：表格、看板、日历、时间轴、画廊、列表等各视图的配置与筛选、排序、分组条件
- 数据库行：每一行的属性值
- 块（正文内容）：行内格式与嵌套结构
- 评论：针对文件或块的未决评论；已解决的评论 Notion API 不返回，因此无法备份。是否备份评论可开关控制
- 用户：出现在内容里的协作者信息，用于还原"谁写的"
- 附件类文件：Notion 托管的图片、文件
- 外部媒体文件：连接在页面中的外部文件，如 PDF、图片、视频等；是否下载这些文件可开关控制
下载到本地的文件都会更新为仓库内的相对引用，因此移动仓库目录、换机器都不会让引用失效。
这些内容保存在你指定的仓库目录中。结构化的快照在仓库内的本地数据库文件里，下载的文件在仓库的 attachments 目录下。
二、完整性是怎么保证的
全量抓取。 每次备份都会完整遍历你共享给集成的整个范围，逐个重新确认对象的当前状态。Notion API 不提供可靠的变更流，理论上无法做到保证完整的增量备份。
写入层面的跳过。 全量抓取不等于全量重写：内容没有变化的快照不需要重写，相同内容也不会重复存储。报告里的"变化 / 跳过"计数描述的就是这个差异。
崩溃安全。 如果备份中途设备断电或程序崩溃，任务可以安全重入，不会破坏已有数据的完整性。
内容寻址去重。 块内容按内容的哈希值存储并计数引用。
独立文件去重。 附件按稳定的文件标识去重。
备份报告。 备份结束后会给出统计：页面、数据库、数据库行、块、评论、视图、用户各自的数量，以及变化与跳过、失败与警告。
归档的导出与导入。 整库归档（冷备用的单文件导出）在导出前会先把仓库数据库的写入落盘，保证归档里是完整的一致状态；导入时会先对归档内的数据库做完整性校验，校验失败直接报错拒绝导入。
三、完整性边界
备份范围限制。 NotionManager 提供更精细的控制，你可以选择备份哪些内容；未共享给集成、或未选入备份范围的内容不会被遍历到。
Notion API 的已知限制：
- 不支持的块类型。Notion API 文档明确表示某些块类型不受支持，这类块的数据对所有依赖 Notion API 的应用都不可用。
- 视图样式与可显示属性等：这些仅影响本地浏览的效果。
Notion 侧管理信息。 Notion 侧的版本历史（页面历史记录）、回收站数据等不在 Notion API 提供的能力范围内，因此也不在备份范围内。
四、授权限制
NotionManager 可以免费使用，但功能受到限制。涉及数据完整性的限制有：
- 免费版本：单次备份任务的对象数上限；视图浏览上限（只能查看一个视图）。对象数上限是按每次任务计的，因此可以创建多个 profile 把大型工作区分散到多次备份；在每个任务的限制范围内，数据是完整备份的。
- 个人授权（Basic 与 Premium）：不支持整库归档的导出与导入。
更多的功能都绑定到特定的授权，不涉及数据完整性，这里不讨论。
五、请你配合的部分
- 按 3-2-1 保留副本：把整个仓库目录复制到另一种介质（外置硬盘、NAS、对象存储）即可，这一步与授权无关。本地备份同样会随磁盘损坏、误删目录或勒索软件而消失，"异地或离线的那一份"正是为这种场景准备的；团队与企业用户还可以用整库归档（单文件打包）作为归档与移机形式。
- 检查备份报告，确认各类对象的数量与你的工作区规模相符；数量异常时先查明原因，再依赖这份备份。
- 留意磁盘健康：备份仓库所在磁盘的坏道会直接损坏备份，请把仓库放在可靠的存储上，并让离线的副本落在不同介质上。