Neo4j数据库如何进行备份恢复

Neo4j 备份与恢复实操指南

一 备份恢复总览

• 支持两类方式：
  1. 离线导出/导入（neo4j-admin dump/load）：数据库需停止，生成或读取单一的 .dump 归档，便于迁移与长期保存。
  2. 在线备份/还原（neo4j-admin backup/restore）：企业版特性，数据库运行时可远程热备，支持全量与增量备份。
• 版本差异：自 Neo4j 5.x 起，命令统一为 neo4j-admin database dump/load；早期版本使用 neo4j-admin dump/load；在线备份命令为 neo4j-admin backup/restore。
• 典型场景：日常迁移/克隆用 dump/load；生产不停机用 backup/restore（企业版）。

二 离线备份与恢复步骤

• 前置检查
  • 确认 Neo4j 已停止（避免 dump 时报错）。
  • 在 Neo4j Desktop 中，可在 DBMS 的 “…” → Open folder → DBMS 打开包含 bin/neo4j-admin 的目录；命令行需在该 bin 目录或配置好 PATH。
• 备份（dump）
  • Neo4j 5.x：
    • 命令：neo4j-admin database dump <database_name> --to-path=<备份目录>
    • 示例：neo4j-admin database dump neo4j --to-path=C:\backups\neo4j-2025-12-29
  • Neo4j 4.x 及更早：
    • 命令：neo4j-admin dump --database= --to=<文件路径>
    • 示例：neo4j-admin dump --database=graph.db --to=/mnt/backup/graph-2025-12-29.dump
• 恢复（load）
  • Neo4j 5.x：
    • 命令：neo4j-admin database load <database_name> --from-path=<备份目录> --overwrite-destination=true
    • 示例：neo4j-admin database load neo4j --from-path=C:\backups\neo4j-2025-12-29 --overwrite-destination=true
  • Neo4j 4.x 及更早：
    • 命令：neo4j-admin load --from=<备份文件或目录> --database= --force
    • 示例：neo4j-admin load --from=/mnt/backup/graph-2025-12-29.dump --database=graph.db --force
• 重要提示
  • 目标库在恢复前应当 不存在或允许覆盖（Desktop 中建议使用 –overwrite-destination=true；4.x 使用 –force）。
  • 恢复后可用 Cypher 校验数据规模（如统计节点/关系数）确保一致性。

三 在线热备与恢复步骤（企业版）

• 前置配置
  • 在 neo4j.conf 启用备份并开放端口：
    • dbms.backup.enabled=true
    • dbms.backup.address=<主机名或IP>:6362
  • 备份保留策略：确保 事务日志 在两次增量备份之间不被清理，例如设置 dbms.tx_log.rotation.retention_policy=3 files（可按需调整）。
• 全量备份
  • 命令：neo4j-admin backup --from=host:6362 --backup-dir=<备份目录> --name=<备份名> --pagecache=<大小>
  • 示例：neo4j-admin backup --from=192.168.10.21:6362 --backup-dir=/mnt/backup --name=neo4j-prod --pagecache=4G
• 增量备份
  • 使用同一 –backup-dir 与 –name 指向既有备份目录，工具将仅拷贝新增事务：
  • 示例：neo4j-admin backup --from=192.168.10.21:6362 --backup-dir=/mnt/backup --name=neo4j-prod --fallback-to-full=true --check-consistency=true --pagecache=4G
  • 建议保留 –fallback-to-full=true，在增量失败时自动回退为全量，避免中断备份链。
• 恢复（restore）
  • 单实例：
    1. 停止数据库；2) 执行 neo4j-admin restore --from=<备份目录> --database= [–force]；3) 启动数据库。
  • 因果集群（Causal Cluster）：
    1. 依次停止所有实例；2) 在 每个实例 上执行 restore；3) 如迁移到新硬件，检查 neo4j.conf 的集群配置；4) 启动所有实例。
• 常用参数
  • –protocol：建议显式设置，catchup（用于 Causal Cluster）或 common（单实例/HA）。
  • –check-consistency：默认 true；做增量时可按性能需求关闭（–check-consistency=false）。

四 关键注意事项与最佳实践

• 版本与兼容性
  • 备份与恢复的 Neo4j 版本需匹配/兼容；一般不支持将高版本数据导入低版本。
  • 运行环境建议满足官方要求（如 Java 17 用于较新版本 Neo4j）。
• 保留策略与窗口
  • 在线增量依赖 事务日志，务必配置合理的 retention_policy，确保两次增量之间日志未被清理。
• 一致性校验
  • 备份时建议开启 –check-consistency；如性能敏感，可在增量阶段临时关闭，但在关键时点（如每周全量）务必校验。
• 集群一致性
  • 因果集群恢复时，需在 所有实例 上执行 restore，确保各成员状态一致。
• 验证与演练
  • 恢复后通过统计信息（节点/关系/索引数）与业务抽样查询进行校验；定期演练备份恢复流程，验证 RPO/RTO。