4.x 中支持的升级和迁移路径

本节介绍支持的升级和迁移路径。

您选择哪条路径取决于您的当前版本和您要迁移到的版本；如果您要升级或迁移整个 Neo4j DBMS 或单个数据库；以及您的备份和还原策略。

顺序路径 (Neo4j DBMS) 从 3.5.latest → 4.0.latest → 4.1.latest → 4.2.latest → 4.3.latest → 4.4.latest
它包括迁移和后续升级整个 Neo4j DBMS（包括数据库和 system 数据库）。
复制/迁移单个数据库从 Neo4j 社区版或企业版 3.5.latest 或 4.x 到 Neo4j 企业版 4.4.latest
它利用 neo4j-admin copy 命令来迁移单个数据库的数据存储。

neo4j-admin copy 命令是 Neo4j 企业版功能。您可以使用它从 Neo4j 社区版迁移到 Neo4j 企业版。
还原单个数据库到更高版本上的正在运行的 Neo4j DBMS。

顺序路径 (Neo4j DBMS)

按照顺序路径，您首先将您的 Neo4j 部署从 3.5.latest 迁移到 4.0.latest，然后依次升级到 4.1.latest、4.2.latest、4.3.latest 和 4.4.latest。它利用 neo4-admin load 或 neo4j-admin restore 来复制数据库和 system 数据库或备份到新安装，然后在 Neo4j 启动期间将数据和模式存储升级到新版本。neo4j-admin 命令可以在在线和离线 Neo4j DBMS 中运行，并且必须以 neo4j 用户身份调用以确保适当的文件权限。

表 1. 完成升级/迁移的文档
起始版本	目标版本	支持的路径	操作	文档
3.4.latest	3.5.latest	3.4.latest → 3.5.latest	升级	操作手册 3.5 → 升级
3.5.latest	4.0.latest	3.5.latest → 4.0.latest	迁移	Neo4j 3.5 → Neo4j 4.0
3.5.latest	4.1.latest	3.5.latest → 4.0.latest → 4.1.latest	迁移和升级	Neo4j 3.5 → Neo4j 4.0 Neo4j 4.0.latest → Neo4j 4.1.latest
3.5.latest	4.2.latest	3.5.latest → 4.0.latest → 4.1.latest → 4.2.latest	迁移和升级	Neo4j 3.5 → Neo4j 4.0 Neo4j 4.0.latest → Neo4j 4.1.latest Neo4j 4.1.latest → Neo4j 4.2.latest
3.5.latest	4.3.latest	3.5.latest → 4.0.latest → 4.1.latest → 4.2.latest → 4.3.latest	迁移和升级	Neo4j 3.5 → Neo4j 4.0 Neo4j 4.0.latest → Neo4j 4.1.latest Neo4j 4.1.latest → Neo4j 4.2.latest Neo4j 4.2.latest → Neo4j 4.3.latest
3.5.latest	4.4.latest	3.5.latest → 4.0.latest → 4.1.latest → 4.2.latest → 4.3.latest → 4.4.latest	迁移和升级	Neo4j 3.5 → Neo4j 4.0 Neo4j 4.0.latest → Neo4j 4.1.latest Neo4j 4.1.latest → Neo4j 4.2.latest Neo4j 4.2.latest → Neo4j 4.3.latest Neo4j 4.3.latest → Neo4j 4.4.latest
4.0.latest	4.1.latest	4.0.latest → 4.1.latest	升级	Neo4j 4.0.latest → Neo4j 4.1.latest
4.0.latest	4.2.latest	4.0.latest → 4.1.latest → 4.2.latest	升级	Neo4j 4.0.latest → Neo4j 4.1.latest Neo4j 4.1.latest → Neo4j 4.2.latest
4.0.latest	4.3.latest	4.0.latest → 4.1.latest → 4.2.latest → 4.3.latest	升级	Neo4j 4.0.latest → Neo4j 4.1.latest Neo4j 4.1.latest → Neo4j 4.2.latest Neo4j 4.2.latest → Neo4j 4.3.latest
4.0.latest	4.4.latest	4.0.latest → 4.1.latest → 4.2.latest → 4.3.latest → 4.4.latest	升级	Neo4j 4.0.latest → Neo4j 4.1.latest Neo4j 4.1.latest → Neo4j 4.2.latest Neo4j 4.2.latest → Neo4j 4.3.latest Neo4j 4.3.latest → Neo4j 4.4.latest
4.1.latest	4.2.latest	4.1.latest → 4.2.latest	升级	Neo4j 4.1.latest → Neo4j 4.2.latest
4.1.latest	4.3.latest	4.1.latest → 4.2.latest → 4.3.latest	升级	Neo4j 4.1.latest → Neo4j 4.2.latest Neo4j 4.2.latest → Neo4j 4.3.latest
4.1.latest	4.4.latest	4.1.latest → 4.2.latest → 4.3.latest → 4.4.latest	升级	Neo4j 4.1.latest → Neo4j 4.2.latest Neo4j 4.2.latest → Neo4j 4.3.latest Neo4j 4.3.latest → Neo4j 4.4.latest
4.2.latest	4.3.latest	4.2.latest → 4.3.latest	升级	Neo4j 4.2.latest → Neo4j 4.3.latest
4.2.latest	4.4.latest	4.2.latest → 4.3.latest → 4.4.latest	升级	Neo4j 4.2.latest → Neo4j 4.3.latest Neo4j 4.3.latest → Neo4j 4.4.latest
4.3.latest	4.4.latest	4.3.latest → 4.4.latest	升级	Neo4j 4.3.latest → Neo4j 4.4.latest

复制/迁移单个数据库

您可以使用 neo4j-admin copy 命令复制或迁移单个数据库（除 system 数据库外）到更高版本上的正在运行的 Neo4j DBMS。copy 命令复制并（如果需要）迁移数据库的数据存储。但是，它不会复制模式存储。因此，如果定义了模式，您必须手动运行 neo4j-admin copy 操作输出的命令来重新创建模式。

此路径适用于

清理数据库不一致和压缩存储。
将单个数据库从 3.5 Neo4j DBMS（社区版或企业版）迁移到 4.x 企业版。
迁移单个数据库的存储格式。有关存储格式版本和兼容性的更多信息，请参阅操作手册 → 存储格式和实体限制。
将单个数据库从 4.x 社区版迁移到 4.y 企业版。
将单个数据库从 4.x 企业版迁移到更高版本的 4.y 企业版。
将单个数据库从 4.x 企业版迁移到更高版本的 4.y 企业版，并使用不同的存储格式。

neo4j-admin copy 命令复制整个数据存储，是一个 IOPS 密集型过程。它占用更多空间，并且比启动时的迁移速度慢。但是，如果您想一次迁移多个顺序步骤或由于某种原因想一次迁移几个数据库，这可能是一个不错的选择。

请记住，neo4j-admin copy 命令会复制节点 ID，但关系会得到新的 ID。因此，如果您想保留关系 ID，则应遵循顺序路径。

恢复单个数据库

您可以使用 neo4j-admin restore 命令将单个数据库的备份恢复到运行在更高版本的 Neo4j DBMS 中。但是，它**不会迁移数据库的store_format**。因此，如果恢复的数据库与 DBMS 的存储格式不同，则必须设置 dbms.allow_upgrade=true 以启用迁移。对于 4.1 之前的版本，您必须重新启动 DBMS 才能使配置生效。