neo4j.conf 文件

neo4j.conf 文件是 Neo4j 中配置设置的主要来源，它包含配置设置键到值的映射。neo4j.conf 文件在 Neo4j 不同配置中的位置列在默认文件位置中。

neo4j.conf 文件中的大多数配置设置直接应用于 Neo4j 本身，但也有其他设置与 Neo4j 运行的 Java 运行时 (JVM) 相关。更多信息请参见JVM 特定配置设置。许多配置设置也用于 neo4j 启动脚本。

neo4j.conf 约定

neo4j.conf 文件中的语法遵循以下约定：

  • 等号 (=) 将配置设置键映射到配置值。

  • 以井号 (#) 开头的行被视为注释。

  • 不支持尾随注释。

  • 空行被忽略。

  • 在 neo4j.conf 中配置一项设置会覆盖任何默认值。如果您想使用自定义值来修改默认值，您必须明确列出默认值和新值。

  • 配置设置没有顺序。

  • 配置设置默认启用严格验证。如果 neo4j.conf 文件包含拼写错误、不正确的信息或重复项（server.jvm.additional 除外），它会阻止 Neo4j 启动。如果您为server.jvm.additional设置多个值，则每个设置值都会向 java 启动器添加另一个自定义 JVM 参数。

    要禁用严格验证，请设置 server.config.strict_validation.enabled=false。

  • 默认情况下，字符编码假定为 ISO 8859-1，但可以通过将环境变量 NEO4J_CONFIG_FILE_CHARSET 设置为（例如）utf8 来覆盖。

配置设置

通用概要

Neo4j 配置设置具有以下通用概要：

<前缀>.<范围>.<组件>...<组件>.<名称>

前缀

前缀保留用于表示两种特殊情况（大多数设置没有前缀）

  • initial — 仅在初始化期间使用但在之后被忽略的设置。例如，initial.server.mode_constraint、initial.dbms.default_database 等。

  • internal — 此前缀取代了旧版本中使用的 unsupported 和 experimental 术语。此命名空间专用于内部使用且可能在不通知的情况下更改的功能。

范围

所有配置设置都属于以下行为不同的范围之一：

  • db 设置可在每个数据库之间变化，但在集群/DBMS 的所有配置文件中必须保持一致。

  • dbms 设置在集群/DBMS 的所有配置文件中必须保持一致。

  • server 设置仅适用于特定服务器，并且可以在集群/DBMS 的配置文件之间变化。

  • browser 设置仅适用于 Neo4j Browser。

  • client 设置仅适用于客户端。

组件

组件命名空间用于对影响类似系统的设置进行分组。

名称

设置的名称。它可能包含常见的动词和单位模式，例如 size、enabled 等。单词之间用下划线分隔。

有关 Neo4j 配置设置的完整参考，请参阅配置设置。

JVM 特有配置设置

Java 虚拟机 (JVM) 是一种虚拟机，使计算机能够运行 Java 程序和用其他语言编写并编译成 Java 字节码的程序。Java 堆是 Java 程序对象存在的地方。根据 JVM 实现的不同，JVM 堆大小通常决定了虚拟机执行垃圾回收的方式和时长。

表 1. JVM 特定设置
设置 描述

server.memory.heap.initial_size

设置 JVM 的初始堆大小。默认情况下，JVM 堆大小是根据可用的系统资源计算的。

server.memory.heap.max_size

设置 JVM 的最大堆大小。默认情况下，JVM 最大堆大小是根据可用的系统资源计算的。

server.jvm.additional

为 JVM 设置附加选项。这些选项以字符串形式设置，并可能因 JVM 实现而异。

如果您希望良好控制系统行为，建议将堆大小参数设置为相同的值，以避免不必要的完整垃圾回收暂停。

列出当前活动设置

您可以使用 SHOW SETTINGS 列出当前活动的配置设置及其值。

示例 1. 列出当前活动的配置设置
SHOW SETTINGS
YIELD name, value
WHERE name STARTS WITH 'server.default'
RETURN name, value
ORDER BY name
LIMIT 3;
+---------------------------------------------------+
| name                                | value       |
+---------------------------------------------------+
| "server.default_advertised_address" | "localhost" |
| "server.default_listen_address"     | "localhost" |
+---------------------------------------------------+

有关动态设置的信息，请参阅更新动态设置和配置设置参考。
© . All rights reserved.