Neo4j 2025.x 中的更改、弃用和移除

Neo4j 2025.01 中的重大更改

本节涵盖自 Neo4j 5.26 LTS 版本以来的重大更改。有关如何从以前的 Neo4j 版本迁移到 2025.01 的指南，请参阅升级和迁移指南。

集群

发现服务

在 2025.01 中，发现服务 v1 被移除。因此，必须在升级到 Neo4j 2025.01 之前完成从 v1 到 v2 的转换。

有关更多详细信息，请参阅操作手册 → 从发现服务 v1 迁移到 v2。

配置设置

  • 在 2025.01 中，设置 server.discovery.advertised_address 和 server.discovery.listen_address 已被移除。

    要列出发现端点（例如，为了提供给发现解析器），请使用 server.cluster.advertised_address 设置的值。

  • 与发现服务 v2 相关的两个配置设置已重命名。从 Neo4j 5.26 迁移到 2025.01 版本时仍可使用它们。但是，建议更新您的 neo4j.conf 文件以使用新设置。

    表 1. 重命名的配置设置
    旧名称 新名称

    dbms.cluster.discovery.v2.endpoints

    dbms.cluster.endpoints

    dbms.kubernetes.discovery.v2.service_port_name

    dbms.kubernetes.discovery.service_port_name
端口

从 2025.01 起，端口 5000 不再使用。内部流量请使用端口 6000。

有关更多详细信息，请参阅配置 → 端口。

日志记录

从 Neo4j 2025.01 开始，默认的 debug.log 格式已从文本更改为 JSON。强烈建议保持其启用状态，不要更改。
如果您需要不同格式的 debug.log 消息，请创建额外的 Appender，因为 Neo4j 支持团队使用默认的 Appender。有关更多信息，请参阅默认日志配置。

内置过程

查看 Neo4j 2025.01 中已移除且无替代的过程。
名称 社区版 企业版

dbms.cluster.moveToNextDiscoveryVersion()

dbms.cluster.showParallelDiscoveryState()

dbms.cluster.switchDiscoveryServiceVersion()

dbms.setDatabaseAllocator()

Neo4j 配置设置

移除的配置设置

查看 Neo4j 2025.01 中移除的配置设置。
名称 注释

db.cluster.raft.leader_transfer.priority_group 企业版

已移除，无替代。请改为使用 db.cluster.raft.leader_transfer.priority_tag。

db.logs.query.annotation_data_as_json_enabled 动态

已替换为 db.logs.query.annotation_data_format。

db.tx_state.memory_allocation

已移除，无替代。

dbms.cluster.catchup.client_inactivity_timeout 企业版

使用 dbms.cluster.network.client_inactivity_timeout。

dbms.cluster.discovery.log_level 企业版

已移除，无替代。

dbms.cluster.discovery.type 企业版

已移除，无替代。

dbms.cluster.discovery.endpoints 企业版

已移除，无替代。

dbms.cluster.discovery.version 企业版

已移除，无替代。

dbms.kubernetes.service_port_name 企业版

已移除，无替代。

initial.dbms.database_allocator 企业版

已移除，无替代。

server.cluster.catchup.connect_randomly_to_server_group 企业版 动态

已移除，无替代。
请改为使用 server.cluster.catchup.connect_randomly_to_server_tags

server.discovery.advertised_address 企业版

已移除，无替代。
请改为使用 server.cluster.advertised_address 的值。

server.discovery.listen_address 企业版

已移除，无替代。
请改为使用 server.cluster.listen_address 的值。

server.groups 企业版

已替换为 initial.server.tags。

server.memory.off_heap.block_cache_size

已移除，无替代。

server.memory.off_heap.max_cacheable_block_size

已移除，无替代。

server.memory.off_heap.transaction_max_size

已移除，无替代。

配置设置默认值的更改

这些更改仅影响新安装或涉及替换现有配置文件的升级。

查看 Neo4j 2025.01 中默认值的更改。
名称 旧默认值 新默认值

db.logs.query.annotation_data_format 动态

CYPHER

JSON

dbms.databases.seed_from_uri_providers 企业版

S3SeedProvider,CloudSeedProvider

CloudSeedProvider

server.metrics.csv.rotation.compression 企业版

NONE

ZIP

server.panic.shutdown_on_panic 企业版

false

true

server.logs.config

conf/server-logs.xml

server-logs.xml

server.logs.user.config

conf/user-logs.xml

user-logs.xml

配置设置有效值的更改

server.logs.config 和 server.logs.user.config 已更改为依赖于提供的 conf 目录路径，而不是在默认值中编码 conf 目录。

表 2. 更新的配置设置
名称 旧有效值 新有效值

server.logs.config

路径。如果为相对路径，则从 server.directories.neo4j_home 解析。

路径。如果为相对路径，则从 server.directories.configuration 解析。

server.logs.user.config

路径。如果为相对路径，则从 server.directories.neo4j_home 解析。

路径。如果为相对路径，则从 server.directories.configuration 解析。

Neo4j 指标

移除的指标

查看 Neo4j 2025.01 中移除的指标。
指标类别 指标名称

Raft 核心指标 - 已相应地被Raft 指标取代

<prefix>.causal_clustering.core.append_index
<prefix>.causal_clustering.core.commit_index
<prefix>.causal_clustering.core.applied_index
<prefix>.causal_clustering.core.term
<prefix>.causal_clustering.core.tx_retries
<prefix>.causal_clustering.core.is_leader
<prefix>.causal_clustering.core.in_flight_cache.total_bytes
<prefix>.causal_clustering.core.in_flight_cache.max_bytes
<prefix>.causal_clustering.core.in_flight_cache.element_count
<prefix>.causal_clustering.core.in_flight_cache.max_elements
<prefix>.causal_clustering.core.in_flight_cache.hits
<prefix>.causal_clustering.core.in_flight_cache.misses
<prefix>.causal_clustering.core.raft_log_entry_prefetch_buffer.lag
<prefix>.causal_clustering.core.raft_log_entry_prefetch_buffer.bytes
<prefix>.causal_clustering.core.raft_log_entry_prefetch_buffer.size
<prefix>.causal_clustering.core.raft_log_entry_prefetch_buffer.async_put
<prefix>.causal_clustering.core.raft_log_entry_prefetch_buffer.sync_put
<prefix>.causal_clustering.core.message_processing_delay
<prefix>.causal_clustering.core.message_processing_timer
<prefix>.causal_clustering.core.replication_new
<prefix>.causal_clustering.core.replication_attempt
<prefix>.causal_clustering.core.replication_fail
<prefix>.causal_clustering.core.replication_maybe
<prefix>.causal_clustering.core.replication_success
<prefix>.causal_clustering.core.last_leader_message

只读副本指标 - 已相应地被存储副本指标取代

<prefix>.causal_clustering.read_replica.pull_updates
<prefix>.causal_clustering.read_replica.pull_update_highest_tx_id_requested
<prefix>.causal_clustering.read_replica.pull_update_highest_tx_id_received

发现指标 v1 - 已移除，无替代。请参阅发现指标

<prefix>.cluster.discovery.replicated_data
<prefix>.cluster.discovery.cluster.members
<prefix>.cluster.discovery.cluster.unreachable
<prefix>.cluster.discovery.cluster.converged
<prefix>.cluster.discovery.restart.success_count
<prefix>.cluster.discovery.restart.failed_count

重命名的指标

在 Neo4j 2025.01 中，<prefix>.store.size.total 已重命名为 <prefix>.store.size.full，以符合 Prometheus 命名要求。

有关更多详细信息，请参阅数据库存储大小指标表。

SSL 框架

从 Neo4j 2025.01 起不再支持基于 CBC 的密码

  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA256

  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA256

    有关更多详细信息，请参阅“安全”部分下的SSL 框架页面。

SSL 相关配置设置

从 2025.01 开始，dbms.ssl.policy.*.verify_hostname 的默认值从 false 更改为 true。有关更多详细信息，请参阅《SSL 框架》页面上的表格。

Java API 更改

查看已移除的公共 API

  • com.neo4j.configuration.EnterpriseEditionSettings.initial_database_allocator

  • com.neo4j.configuration.EnterpriseEditionSettings.server_groups

  • com.neo4j.configuration.EnterpriseEditionSettings.server_max_number_of_databases

  • com.neo4j.dbms.procedures.wait.WaitResponseState

  • com.neo4j.configuration.ClusterSettings.DEFAULT_CLUSTER_STATE_DIRECTORY_NAME

  • com.neo4j.configuration.ClusterSettings.DEFAULT_DISCOVERY_PORT

  • com.neo4j.configuration.ClusterSettings.DEFAULT_RAFT_PORT

  • com.neo4j.configuration.ClusterSettings.DEFAULT_TRANSACTION_PORT

  • com.neo4j.configuration.ClusterSettings.catchup_connect_randomly_to_server_group

  • com.neo4j.configuration.ClusterSettings.raft_leader_transfer_priority_group

  • com.neo4j.configuration.ClusterBaseSettings.DEFAULT_DISCOVERY_PORT

  • com.neo4j.configuration.ClusterNetworkSettings.catchup_client_inactivity_timeout

  • com.neo4j.causalclustering.discovery.parallel.ParallelDiscoveryMode

  • com.neo4j.causalclustering.discovery.resolve.RemotesResolver.Type

  • com.neo4j.causalclustering.discovery.resolve.RemotesResolver.init(com.neo4j.causalclustering.discovery.resolve.RemotesResolver.Type, org.neo4j.graphdb.config.Configuration, org.neo4j.logging.LogProvider)

  • com.neo4j.configuration.ClusterAddressSettings.discovery_advertised_address

  • com.neo4j.configuration.DiscoverySettings.discovery_endpoints

  • com.neo4j.configuration.DiscoverySettings.discovery_listen_address

  • com.neo4j.configuration.DiscoverySettings.discovery_log_level

  • com.neo4j.configuration.DiscoverySettings.discovery_type

  • com.neo4j.configuration.DiscoverySettings.discovery_version

  • com.neo4j.configuration.KubernetesSettings.kubernetes_service_port_name

  • com.neo4j.configuration.RaftSettings.DEFAULT_CLUSTER_STATE_DIRECTORY_NAME

  • com.neo4j.configuration.RaftSettings.DEFAULT_RAFT_PORT

  • com.neo4j.dbms.seeding.SeedDownloadStreamWrapper

  • com.neo4j.dbms.seeding.SeedProvider

  • com.neo4j.dbms.seeding.SeedProviderDependencies

  • org.neo4j.configuration.GraphDatabaseSettings.TransactionStateMemoryAllocation

  • org.neo4j.configuration.GraphDatabaseSettings.log_queries_annotation_data_as_json

  • org.neo4j.configuration.GraphDatabaseSettings.tx_state_max_off_heap_memory

  • org.neo4j.configuration.GraphDatabaseSettings.tx_state_memory_allocation

  • org.neo4j.configuration.GraphDatabaseSettings.tx_state_off_heap_block_cache_size

  • org.neo4j.configuration.GraphDatabaseSettings.tx_state_off_heap_max_cacheable_block_size

SeedProvider 已移除并替换为 DatabaseSeedProvider。有关详细信息，请参阅Java 参考 → 扩展 Neo4j → 设置插件项目。

Neo4j 2025.x 中的弃用

本节列出了 2025 系列中所有已弃用的 Neo4j 服务器功能，包括适用的替代方案。

有关 Cypher 语言中的弃用，请参阅Cypher 手册 → 弃用、新增和兼容性。

过程

查看所有已弃用的过程
名称 社区版 企业版 注释

dbms.cluster.recreateDatabase()

在 2025.04 中弃用
已替换为 dbms.recreateDatabase()

dbms.quarantineDatabase() 仅限管理员

在 2025.01 中弃用
已替换为 dbms.unquarantineDatabase()

dbms.cluster.uncordonServer()

在 5.23 中弃用.
在 Neo4j 5.23 之前，该过程只能以管理员权限运行。
已替换为 ENABLE SERVER。

dbms.cluster.routing.getRoutingTable()

在 5.21 中弃用.
已替换为：dbms.routing.getRoutingTable()。

cdc.current() 测试版

在 5.17 中弃用
已替换为：db.cdc.current()

cdc.earliest() 测试版

在 5.17 中弃用
已替换为：db.cdc.earliest()

cdc.query() 测试版 仅限管理员

在 5.17 中弃用
已替换为：db.cdc.query()

db.create.setVectorProperty() 测试版

在 5.13 中弃用
已替换为：db.create.setNodeVectorProperty()

dbms.upgrade() 仅限管理员

在 5.9 中弃用

dbms.upgradeStatus() 仅限管理员

在 5.9 中弃用

dbms.cluster.readReplicaToggle() 仅限管理员

在 5.6 中弃用
已替换为：dbms.cluster.secondaryReplicationDisable()。

配置设置

查看所有已弃用的配置设置
名称 社区版 企业版 注释

dbms.routing.load_balancing.plugin

在 2025.05 中弃用

server.db.query_cache_size

在 5.7 中弃用

dbms.security.oidc.<provider>.auth_params

动态 已弃用

dbms.security.oidc.<provider>.client_id

动态 已弃用

指标

查看所有已弃用的指标
名称 注释

<prefix>.cluster.raft.tx_retries 在 2025.02 中弃用

该指标将在未来版本中移除。

数据库数据指标 在 5.15 中弃用

<prefix>.ids_in_use.relationship_type

<prefix>.ids_in_use.property

<prefix>.ids_in_use.relationship

如果您想大致了解图的大小，请改为使用 <prefix>.neo4j.count.relationship。

<prefix>.ids_in_use.node

如果您想大致了解图的大小，请改为使用 <prefix>.neo4j.count.node。

日志记录

从 2025.05 开始，JSON 格式查询日志的 failureReason 列已弃用。请改为使用 errorInfo 列。有关详细信息，请参阅日志记录 → 查询日志类型的 JSON 格式日志条目。

Neo4j-admin 工具

查看所有已弃用的命令
名称 社区版 企业版 注释

neo4j-admin database aggregate-backup

在 2025.01 中弃用
已替换为 neo4j-admin backup aggregate
查看所有已弃用的命令选项
命令 选项 注释

neo4j-admin database migrate

--page-cache 在 2025.04 中弃用

该选项已弃用，并被 --max-off-heap-memory 选项取代。

种子提供程序

S3SeedProvider 自 Neo4j 5.26 起已弃用，并被 CloudSeedProvider 取代。

有关更多信息，请参阅从 URI 播种。

Java API

自 Neo4j 5.26 起，服务器端通知 API 和 Result Core API 的 getNotifications() 方法已弃用。

Neo4j 错误码消息

从 2025.04 开始，以编程方式使用错误消息已弃用。因为错误消息在未来版本中可能会更改，请在您的应用程序代码中解析或使用 GQLSTATUS 错误码。有关详细信息，请参阅错误和通知状态码 → GQLSTATUS 错误码列表。

Neo4j 2025.x 中的更改

本节涵盖 Neo4j 服务器功能在不同领域的更改。

Neo4j-admin 工具

Neo4j 2025.01

  • neo4j-admin database copy 命令。

    --from-pagecache=<size> 选项的功能已更改。
    现在，您可以控制用于复制操作（包括读取和写入）的最大堆外内存量，而不是指定读取源时要分配的缓存量。通过配置堆外内存值，您也可以影响缓存分配。
    为了反映此更改，该选项添加了一个新名称：--max-off-heap-memory=<size>。

    有关详细信息，请参阅提高性能。

© . All rights reserved.