Neo4j 5.26 LTS 至 Neo4j 2025.01 及更高版本的变更
|
重要提示
建议在继续操作前阅读简介和升级到任意 Neo4j 2025–2026 版本。 |
以下是升级到任意 Neo4j 2025-2026 版本时必须审阅并可能需要处理的变更。
软件要求和 Java 版本
建议在升级到任意 Neo4j 2025-2026 版本之前,先升级到完全受支持的操作系统。Neo4j 2025.01 需要 Java 21(自 5.14 版本起开始支持)。Java 17 在 Neo4j 2025.01 中不再受支持。自 Neo4j 2025.10 起开始支持 Java 25。有关受支持操作系统及其 Java 依赖项的列表,请参阅操作手册 → 软件要求。
重大变更
集群发现服务企业版
Neo4j 提供了多种机制供集群成员相互发现并形成集群,具体取决于所使用的配置、集群运行的环境以及所使用的 Neo4j 版本。
在 2025.01 版本中,已移除发现服务 v1。因此,在升级到任何 2025-2026 版本之前,必须完成从 v1 到 v2 的迁移。有关更多详细信息,请参阅操作手册 → 从发现服务 v1 迁移到 v2。
其他变更
存储格式
在 Neo4j 5.26 中,block 格式是所有企业版数据库的默认格式。因此,强烈建议 5.26 LTS 企业版用户在升级到任何 2025-2026 版本之前,将所有数据库迁移到 block 格式,以确保最佳性能。有关详细信息,请参阅操作手册 → 存储格式 → 更改现有数据库的存储格式。block 格式支持的标记名称(包括节点标签、属性键和关系类型名称)长度上限为 GQL 标识符的最大长度 16,383 个字符。因此,从 aligned 格式迁移到 block 格式时,标记名称必须遵守此长度限制。
standard 和 high_limit 格式在 5.23 版本中已被弃用,并将在未来的版本中移除。有关更多信息,请参阅操作手册 → 存储格式 → 格式弃用。有关各 Neo4j 版本可用存储格式的更多信息,请参阅操作手册 → 存储格式。
库兼容性
依赖于 dbms.components() 返回值的库(例如 GraphQL 和 Neo4j 连接器)必须在升级到 Neo4j 2025 之前升级到以下补丁版本,以确保兼容性:
| 库 | 版本 |
|---|---|
Neo4j Kafka 连接器 |
5.1.9 |
Neo4j Apache Spark 连接器 |
5.3.3 |
Neo4j Dataflow Flex 模板 |
使用最新发布的镜像 |
Neo4j GraphQL 库版本 5 (LTS) |
|
Neo4j GraphQL OGM |
|
Neo4j GraphQL 库版本 6 |
|
Neo4j GraphQL 库版本 7 (alpha) |
弃用与移除
有关 Neo4j 2025-2026 版本中弃用和重大变更的完整列表,请参阅操作手册 → 弃用、移除与变更 — Neo4j 2025.x。
有关 Neo4j 2026.x 中弃用和变更的列表,请参阅操作手册 → 弃用、移除与变更 — Neo4j 2026.x。1 根据您的应用程序与 Neo4j 的交互方式,您可能需要更新应用程序以适配新版本的 Neo4j。