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 格式时,标记名称必须遵守此长度限制。

standardhigh_limit 格式在 5.23 版本中已被弃用,并将在未来的版本中移除。有关更多信息,请参阅操作手册 → 存储格式 → 格式弃用。有关各 Neo4j 版本可用存储格式的更多信息,请参阅操作手册 → 存储格式

库兼容性

依赖于 dbms.components() 返回值的库(例如 GraphQL 和 Neo4j 连接器)必须在升级到 Neo4j 2025 之前升级到以下补丁版本,以确保兼容性:

表 1. 兼容的补丁版本
版本

Neo4j Kafka 连接器

5.1.9

Neo4j Apache Spark 连接器

5.3.3

Neo4j Dataflow Flex 模板

使用最新发布的镜像

Neo4j GraphQL 库版本 5 (LTS)

5.11.4

Neo4j GraphQL OGM

5.11.4

Neo4j GraphQL 库版本 6

6.3.0

Neo4j GraphQL 库版本 7 (alpha)

7.0.0-alpha.2

弃用与移除

有关 Neo4j 2025-2026 版本中弃用和重大变更的完整列表,请参阅操作手册 → 弃用、移除与变更 — Neo4j 2025.x

有关 Neo4j 2026.x 中弃用和变更的列表,请参阅操作手册 → 弃用、移除与变更 — Neo4j 2026.x。1 根据您的应用程序与 Neo4j 的交互方式,您可能需要更新应用程序以适配新版本的 Neo4j。

© . This site is unofficial and not affiliated with Neo4j, Inc.