配置设置

配置检查点何时发生的通用策略。可能的值为

[PERIODIC, CONTINUOUS, VOLUME, VOLUMETRIC] 之一。

配置检查点之间的时间间隔。数据库运行检查点的频率不会高于指定的时间间隔（除非由其他事件触发），但如果执行检查点花费的时间比配置的时间间隔长，则检查点频率可能会降低。检查点是事务日志中恢复开始的点。更长的检查点间隔通常意味着在发生崩溃时恢复需要更长的时间。另一方面，更长的检查点间隔也可以减少数据库对系统施加的 I/O 负载，因为每个检查点都意味着刷新并强制写入所有存储文件。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

配置检查点之间的事务间隔。数据库运行检查点的频率不会高于指定的时间间隔（除非由其他事件触发），但如果执行检查点花费的时间比配置的时间间隔长，则检查点频率可能会降低。检查点是事务日志中恢复开始的点。更长的检查点间隔通常意味着在发生崩溃时恢复需要更长的时间。另一方面，更长的检查点间隔也可以减少数据库对系统施加的 I/O 负载，因为每个检查点都意味着刷新并强制写入所有存储文件。默认值为 100000，即每 100000 个事务运行一次检查点。

最小为 1 的整数。

配置检查点之间事务日志的卷。数据库运行检查点的频率不会高于指定的时间间隔（除非由其他事件触发），但如果执行检查点花费的时间比配置的时间间隔长，则检查点频率可能会降低。检查点是事务日志中恢复开始的点。更长的检查点间隔通常意味着在发生崩溃时恢复需要更长的时间。另一方面，更长的检查点间隔也可以减少数据库对系统施加的 I/O 负载，因为每个检查点都意味着刷新并强制写入所有存储文件。

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB），最小为 1.00KiB。

限制后台检查点进程每秒消耗的 IO 数。此设置是建议性的。它在 Neo4j 社区版中被忽略，并在企业版中尽力遵循。在这种情况下，IO 是 8 KiB 的（主要是顺序的）写入。以这种方式限制写入 IO 可以为 I/O 子系统留出更多带宽来处理随机读取 IO，这对于数据库无法完全容纳在内存中时查询的响应时间很重要。此设置的唯一缺点是较长的检查点时间可能会导致数据库或系统崩溃时恢复时间稍长。较小的数字意味着较低的 IO 压力，从而导致较长的检查点时间。设置为 -1 可禁用 IOPS 限制并完全移除限制。这允许检查点程序以硬件允许的最快速度刷新数据。移除或注释掉该设置将恢复为默认值 600。

一个整数。

限制后台检查点进程每秒的写入吞吐量。此设置是建议性的。它在 Neo4j 社区版中被忽略，并在企业版中尽力遵循。以这种方式限制写入 IO 可以为 I/O 子系统留出更多带宽来处理随机读取 IO，这对于数据库无法完全容纳在内存中时查询的响应时间很重要。此设置的唯一缺点是较长的检查点时间可能会导致数据库或系统崩溃时恢复时间稍长。较小的数字意味着较低的 IO 压力，从而导致较长的检查点时间。设置为 null 可禁用吞吐量限制并回退到 IOPS 限制。

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB），最小为 8.00KiB。

Azure Blob 存储端点后缀。如果您不使用 Azure 公共云（例如，如果您使用 Azure 政府版），则需要更改此设置。

一个字符串。

Azure 机构主机端点（仅某些身份验证方法需要，应以其完整形式指定 - 例如，https://login.microsoftonline.com）。

一个字符串。

要连接的 Google 存储桶的项目 ID，回退到其 SDK 找到的值。

一个字符串。

传输请求的目标吞吐量。值越高，与 S3 建立的连接就越多。建议将其设置为应用程序运行所在主机的最大网络带宽。默认值为 10.0，但在 EC2 实例上运行时，该值通常可以设置得更高（具体取决于 EC2 实例类型）。

一个 double 值。

从服务器获取特定数据库的更新的间隔（来自该数据库的主服务器）。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

应用缓冲区中的最大字节数。此参数限制了应用缓冲区可以消耗的内存量。如果达到字节限制，即使未超过 max_entries，缓冲区大小也会受到限制。

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB）。

Raft 日志条目预取缓冲区中的最大条目数。

一个整数。

由 RAFT 处理的最大批处理大小（字节）。

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB）。

为所有 Raft TCP 通道设置 keepalive 套接字选项 (SO_KEEPALIVE)。

一个布尔值。

RAFT 入队的最大字节数。

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB）。

服务器标签的名称，其成员应被优先选为领导者。这并不能保证领导者始终是此标签的成员，但集群将在可能时尝试将领导权转移给此类成员。如果使用 db.cluster.raft.leader_transfer.priority_tag.<database> 指定了数据库，则指定的优先级标签将仅应用于该数据库。如果未指定数据库，则该标签将成为默认标签，并应用于所有未显式设置优先级标签的数据库。使用此设置将禁用领导权平衡。

标识服务器标签的字符串。

RAFT 日志修剪策略，确定要修剪哪些日志。Neo4j 仅修剪直至最后一个已应用索引的日志条目，这保证了仅在其中的事务被安全地复制到本地事务日志并被大多数集群成员安全提交后，日志才会被标记为修剪。可能的值是字节大小或事务数（例如，200K txs）。

一个字符串。

传输中缓存中的最大字节数。此参数限制了缓存可以消耗的内存量。如果达到字节限制，即使未超过 max_entries，缓存大小也会受到限制。

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB）。

传输中缓存中的最大条目数。增加大小需要更多内存，但可能会在高负载情况下提高性能。

一个整数。

如果指定的持续时间过去而没有网络活动，则网络请求超时。客户端从服务器接收到的每条消息都会延长超时持续时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

服务器为了发现其他集群成员而应联系的端点的逗号分隔列表。所有托管 system 数据库主服务器的集群成员必须在此列表中指定。然而，通常会将所有集群成员（包括当前服务器）都包含在此列表中。

逗号分隔的列表，其中每个元素都是套接字地址，格式为 hostname:port, hostname, 或 :port。

配置发现服务用于确定谁应该成为集群一部分的解析器类型。有效值为 LIST, SRV, DNS, 和 K8S

一个字符串。

最初形成集群 DBMS 所需的最小机器数。当至少这么多成员发现彼此、绑定在一起并引导了高可用系统数据库时，集群被视为已形成。因此，集群的初始机器中至少有这么多必须将 server.cluster.system_database_mode 设置为 PRIMARY。
注意：如果 dbms.cluster.discovery.resolver_type 设置为 LIST 且 dbms.cluster.endpoints 为空，则假定用户正在部署单机 DBMS，此设置的值将被忽略。

最小为 1 的整数。

等待建立网络连接的最长等待时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

协议协商握手的超时时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

集群机制允许在网络上传输的最大块大小。

范围在 4096 到 10485760 之间的整数。

此服务器将在协商中允许的网络压缩算法（逗号分隔列表）。
对于传入连接，算法按优先级降序列出。空列表表示不压缩。
对于传出连接，这仅指定允许的算法集，远程对等方的首选项将用于做出决定。
允许的值：[Snappy, Snappy_validating, LZ4 在 2026.01 中弃用, LZ4_high_compression 在 2026.01 中弃用, LZ_validating 在 2026.01 中弃用, LZ4_high_compression_validating 在 2026.01 中弃用]。

逗号分隔的列表，其中每个元素都是一个字符串。

启用 Raft 发送方通道的异步获取。如果设置为 false，领导者在向追随者发送条目之前将等待与追随者的连接。如果一个或多个成员建立连接缓慢，这可能会导致复制延迟。

一个布尔值。

Neo4j 服务器上的数据库加入集群或与至少可用法定成员数形成新集群所允许的时间。成员由系统数据库的 dbms.cluster.endpoints 提供，对于标准数据库由拓扑图提供。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

两个节点之间用于操作 raft 协议的最大 TCP 通道数。每个数据库被分配一个通道，但单个通道可以被多个数据库使用。

一个整数。

领导者选举发生的速率。注意，由于选举冲突，可能需要多次尝试才能找到领导者。该窗口应明显大于典型的通信延迟，以使冲突不太可能发生。

一个持续时间范围 <min-max>（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

检测到领导者丢失并在其中进行第一次重新选举尝试的时间窗口。该窗口应明显大于典型的通信延迟，以使冲突不太可能发生。

一个持续时间范围 <min-max>（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

在集群中转移数据库领导权时使用的策略。请注意，如果为给定的数据库指定了 leader_transfer.priority_tag，则该设置的值将被该数据库忽略。可以使用以下值

[NO_BALANCING, EQUAL_BALANCING] 之一。

RAFT 日志修剪频率。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

RAFT 日志读取器池大小。

一个整数。

RAFT 日志轮换大小。当日志达到此大小时，它将被轮换。

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB），最小为 1.00KiB。

新追随者加入 Raft 组所接受的最大滞后量。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

新成员赶上的超时时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

存储复制期间每个请求的最大重试时间。常规存储文件和索引在存储复制期间在单独的请求中下载。这配置了失败请求允许重新发送的最长时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

自动启用处于 FREE 状态的服务器 - 不仅在初始 DBMS 启动期间，而且在新服务器加入集群时也是如此。

一个布尔值。

标准数据库的初始默认主服务器数量。在第一次 DBMS 启动时初始化。如果用户未在 CREATE DATABASE 中指定主服务器数量，则除非被 dbms.setDefaultAllocationNumbers 过程覆盖，否则将使用此值。

最小为 1 且最大为 11 的整数。

标准数据库的初始默认追随者数量。在第一次 DBMS 启动时初始化。如果用户未在 CREATE DATABASE 中指定追随者数量，则除非被 dbms.setDefaultAllocationNumbers 过程覆盖，否则将使用此值。

最小为 0 且最大为 20 的整数。

属性分片的初始默认副本数。在第一次 DBMS 启动时初始化。如果用户未在 CREATE DATABASE 中指定属性分片副本数，则除非被 dbms.setDefaultAllocationNumbers 过程覆盖，否则将使用此值。

最小为 1 且最大为 20 的整数。

此服务器上允许的数据库名称列表；所有其他名称均被拒绝。空表示允许所有数据库。此配置在第一次 DBMS 启动时和/或启用新添加的服务器时进行初始化。该设置用作 ENABLE SERVER 命令的默认输入；执行命令时可以覆盖。与 server.initial_denied_databases 互斥。

在 2025.12 中更改 一个逗号分隔的集合，其中每个元素都是一个有效的数据库名称模式，仅包含字母字符、数字、点、问号、星号和连字符，长度在 1 到 63 个字符之间。

此服务器上不允许的数据库名称列表。空表示不拒绝任何内容。此配置在第一次 DBMS 启动时和/或启用新添加的服务器时进行初始化。该设置用作 ENABLE SERVER 命令的默认输入；执行命令时可以覆盖。与 server.initial_allowed_databases 互斥。

在 2025.12 中更改 一个逗号分隔的集合，其中每个元素都是一个有效的数据库名称模式，仅包含字母字符、数字、点、问号、星号和连字符，长度在 1 到 63 个字符之间。

确定服务器是被配置为仅托管主数据库、仅托管追随者数据库，还是两者都托管。在第一次 DBMS 启动时和/或启用新添加的服务器时进行初始化。该设置用作 ENABLE SERVER 命令的默认输入；执行命令时可以覆盖。

[PRIMARY, SECONDARY, NONE] 之一。

数据库分配以及配置负载均衡和复制策略时使用的服务器标签名称列表。在第一次 DBMS 启动时和/或启用新添加的服务器时进行初始化。该设置用作 ENABLE SERVER 命令的默认输入；执行命令时可以覆盖。

逗号分隔的列表，其中每个元素都是标识服务器标签的字符串，且不包含重复项。

事务传输服务器的已通告主机名/IP 地址和端口。

套接字地址，格式为 hostname:port, hostname, 或 :port，即一个可访问的地址。如果缺失，则从 server.default_advertised_address 获取。

由 connect-randomly-to-server-with-tag 选择策略使用的逗号分隔标签列表。当策略列表 (server.cluster.catchup.upstream_strategy) 包含值 connect-randomly-to-server-with-tag 时，使用 connect-randomly-to-server-with-tag 策略。

逗号分隔的列表，其中每个元素都是标识服务器标签的字符串。

追随者用于选择从其拉取事务更新的上游服务器的降序策略列表。如果没有任何有效策略或列表为空，则默认策略为 typically-connect-to-random-secondary。

逗号分隔的列表，其中每个元素都是一个字符串。

用户定义的上游选择策略的配置。当策略列表 (server.cluster.catchup.upstream_strategy) 包含值 user_defined 时，使用用户定义策略。

一个字符串。

事务传输服务器监听的网络接口和端口。请注意，也可以针对此端口运行备份客户端，因此始终通过防火墙限制对其的访问，并配置 SSL 策略。

套接字地址，格式为 hostname:port, hostname, 或 :port。如果缺失，则从 server.default_listen_address 获取。

如果可用，请使用原生传输。Linux 使用 Epoll，MacOS/BSD 使用 Kqueue。如果此设置设置为 false，或者原生传输不可用，则将使用 Nio 传输。

一个布尔值。

RAFT 服务器的已通告主机名/IP 地址和端口。

套接字地址，格式为 hostname:port, hostname, 或 :port，即一个可访问的地址。如果缺失，则从 server.default_advertised_address 获取。

RAFT 服务器监听的网络接口和端口。

套接字地址，格式为 hostname:port, hostname, 或 :port。如果缺失，则从 server.default_listen_address 获取。

用户必须在每台服务器上为系统数据库手动指定模式。

[PRIMARY, SECONDARY] 之一。

此连接器的已通告地址。

套接字地址，格式为 hostname:port, hostname, 或 :port，即一个可访问的地址。如果缺失，则从 server.default_advertised_address 获取。

在等待来自活动进行中查询的响应的连接上发送 NOOP 之前的最长等待时间。最小值为 1 毫秒。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s），最小为 1ms。

要启用 keep-alive 消息的消息类型，可以是 ALL, STREAMING, 或 OFF。

[ALL, STREAMING, OFF] 之一。

在连接被视为陈旧之前允许遗漏的探测总数。最小值为 1。

最小为 1 的整数。

所有带有活动查询的连接上每次预定 keep-alive 检查之间的时间间隔。零持续时间将关闭 keep-alive 服务。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s），最小为 0s。

启用 Bolt 连接器。

一个布尔值。

连接器应绑定的地址。

套接字地址，格式为 hostname:port, hostname, 或 :port。如果缺失，则从 server.default_listen_address 获取。

连接器应绑定的其他地址。

逗号分隔的集合，其中每个元素都是套接字地址，格式为 hostname:port, hostname, 或 :port。

为 bolt 和 http 连接器启用服务器 OCSP 装订。

一个布尔值。

启用驱动程序遥测收集。

一个布尔值。

启用在 Bolt 堆栈内基于账户的良性错误报告。启用后，仅当此类事件以异常频率发生时才会报告良性错误。禁用后，将报告所有良性网络错误。

一个布尔值。

在错误被清除之前，网络相关连接中止需要保持在合理水平的持续时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s），最小为 1s。

在发出日志消息之前，在指定时间窗口内允许的最大网络相关连接中止次数。零值将恢复为遗留警告行为。

最小为 0 的长整数。

采样网络相关连接中止的时间窗口的持续时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s），最小为 1s。

绑定到此连接器的线程池中的空闲线程等待新任务的最长时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

绑定到此连接器的线程池中允许的最大线程数。

一个整数。

绑定到此连接器的线程池中要保持的线程数（包括空闲线程）。

一个整数。

在错误被清除之前，未调度请求需要保持在合理水平的持续时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s），最小为 1s。

在发出日志消息之前，在指定时间窗口内线程饥饿事件期间允许的最大未调度请求数。

最小为 0 的长整数。

采样未调度请求的时间窗口的持续时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s），最小为 1s。

用于保护与此连接器的通信的加密级别。

[REQUIRED, OPTIONAL, DISABLED] 之一。

当前流量使用样本之间花费的时间量。较小的值会导致更准确的报告，同时会带来更高的性能损失。零值禁用流量核算。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s），为 0s 或最小为 1m。

花费在配置的流量阈值以下以清除流量警告的时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s），最小为 1m。

发出警告之前，在配置的核算检查窗口内允许的最大传入流量（Mbps）。

最小为 1 的长整数。

发出警告之前，在配置的核算检查窗口内允许的最大传出流量（Mbps）。

最小为 1 的长整数。

通过 Bolt Unix 域套接字连接器启用或禁用身份验证。如果禁用，只要已连接的客户端能够访问 Unix 域套接字文件，它们就会获得所有权限。

一个布尔值。

是否删除用于 Unix 域套接字接口的现有文件。这改善了先前的硬关机无法删除文件的情况的处理。

一个布尔值。

启用或禁用 Bolt Unix 域套接字连接器。通过此连接器提交的请求将被放置在专用线程池中，该线程池与所有其他 Bolt 连接隔离。

一个布尔值。

用于 Unix 域套接字接口的文件的绝对路径。必须指定此文件，它将在运行时创建，并在关机时删除。

一个路径。

设置应用于 Unix 域套接字文件的默认权限掩码。此掩码应设置得尽可能严格（特别是在此连接器上禁用身份验证时）。但请注意，除 Linux 外，其他 Posix 系统可能不遵循此权限。

一组文件权限。

绑定到 Unix 域套接字连接器的线程池中的空闲线程等待新任务的最长时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d）。

绑定到 Unix 域套接字连接器的线程池中允许的最大线程数。

最小为 1 的整数。

绑定到 Unix 域套接字连接器的线程池中要保持的线程数（包括空闲线程）。

最小为 0 的整数。

是否分配用于 Unix 域套接字接口的专用线程池。这允许将 Unix 域套接字连接器用作服务器容量过大时的紧急访问连接器。

一个布尔值。

此连接器的已通告地址。

套接字地址，格式为 hostname:port, hostname, 或 :port，即一个可访问的地址。如果缺失，则从 server.default_advertised_address 获取。

启用 HTTP 连接器。

一个布尔值。

连接器应绑定的地址。

套接字地址，格式为 hostname:port, hostname, 或 :port。如果缺失，则从 server.default_listen_address 获取。

启用 X-Forwarded-Host 和 X-Forwarded-Proto 头文件的处理。仅在 Neo4j 位于可信反向代理或负载均衡器后面时才启用此功能。禁用时，出于安全原因，X-Forward 头文件将被忽略。

一个布尔值。

可以出现在 X-Forwarded-Host 头文件中的允许主机名列表。这可以防止主机头注入攻击。保持为空以接受任何主机名（不建议用于生产环境）。

逗号分隔的列表，其中每个元素都是一个字符串。

允许设置 X-Forward 头文件的受信任代理 IP 地址列表。仅来自这些 IP 的请求才会处理其 X-Forward 头文件。保持为空以接受来自任何来源的 X-Forward 头文件（不建议）。

逗号分隔的列表，其中每个元素都是一个字符串。

允许 X-Forwarded-Host 头文件中的私有 IP 地址 (RFC 1918)。设置为 false 可防止内部网络侦察攻击。

一个布尔值。

定义加载到 Neo4j Web 服务器中的模块集。企业管理端点仅在企业版中可用。

逗号分隔的集合，其中每个元素都是 [TRANSACTIONAL_ENDPOINTS, UNMANAGED_EXTENSIONS, BROWSER, ENTERPRISE_MANAGEMENT_ENDPOINTS, QUERY_API_ENDPOINTS] 之一。

定义 HTTP 服务器上可用的传输集。

逗号分隔的集合，其中每个元素都是 [HTTP1_1, HTTP2] 之一。

此连接器的已通告地址。

套接字地址，格式为 hostname:port, hostname, 或 :port，即一个可访问的地址。如果缺失，则从 server.default_advertised_address 获取。

启用 HTTPS 连接器。

一个布尔值。

连接器应绑定的地址。

套接字地址，格式为 hostname:port, hostname, 或 :port。如果缺失，则从 server.default_listen_address 获取。

服务器用于通告自身的默认主机名或 IP 地址。

格式为 主机名:端口、主机名 或 :端口 的套接字地址，且未指定端口，是一个可访问的地址。

用于侦听传入连接的默认网络接口。若要在所有接口上侦听连接，请使用“0.0.0.0”。

格式为 主机名:端口、主机名 或 :端口 且未指定端口的套接字地址。

集群内路由连接器的通告地址。

套接字地址，格式为 hostname:port, hostname, 或 :port，即一个可访问的地址。如果缺失，则从 server.default_advertised_address 获取。

路由连接器应绑定的地址。

套接字地址，格式为 hostname:port, hostname, 或 :port。如果缺失，则从 server.default_listen_address 获取。

对于这些域的 neo4j:// 协议连接，始终使用客户端路由（忽略默认路由器）。这是一个以逗号分隔的域列表。支持通配符 (*)。

以逗号分隔的集合，其中每个元素都是一个字符串。

neo4j:// 协议连接的路由策略。默认为 CLIENT，使用客户端路由，并将服务器端路由作为备选（如果已启用）。当设置为 SERVER 时，客户端路由将被短路，请求依赖于服务器端路由，该路由必须通过 dbms.routing.enabled=true 启用才能正常运行。可被 dbms.routing.client_side.enforce_for_domains 覆盖。

[SERVER, CLIENT] 中的一个。

套接字连接超时。超时值为零将被视为无限超时，并受操作系统层配置的超时限制。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

超过此阈值的连接池连接将被关闭并从池中移除。将此选项设置为较低的值会导致频繁的连接流失，并可能导致性能下降。建议将最大生命周期设置为略小于网络设备（负载均衡器、代理、防火墙等也可能限制最大连接生命周期）中配置的值。零值和负值表示不检查生命周期。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

尝试从连接池获取连接所花费的最大时间。仅当所有现有连接均被占用且无法创建新连接（因为已达到最大连接池大小）时，此超时才会生效。如果在配置的时间内无法获取连接，则会引发错误。允许使用负值，这意味着无限的获取超时。允许使用 0 值，表示没有超时，当连接不可用时立即失败。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

在池中空闲时间超过此超时的连接，在再次使用之前将被测试以确保它们仍然存活。如果此选项的值过低，获取连接将需要额外的网络调用，从而导致性能下降。如果此选项的值过高，活动的连接可能不再可用，从而导致错误。因此，此参数平衡了遇到连接问题的可能性和性能。通常，不需要调整此参数。值 0 表示始终测试连接的有效性。默认情况下不进行连接存活性检查。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

连接池管理的最大连接总数。该限制适用于主机和用户的组合。允许使用负值，表示无限的连接池。不允许使用 0 值。默认为 -1（无限）。

一个整数。

设置驱动程序内部日志记录的级别。

[DEBUG, INFO, WARN, ERROR, NONE] 中的一个。

在集群中使用额外的 bolt 连接器启用服务器端路由。配置后，如果请求无法由第一个成员满足（例如非领导者节点接收到写请求），则允许将请求从一个集群成员转发到另一个成员。

一个布尔值。

每次生成路由表时改变条目的顺序。这意味着不同的客户端应该选择一系列服务器作为其首选联系点，如果存在替代方案，则减少所有客户端联系同一台服务器的机会。这使得服务器之间的负载更加均匀。

一个字符串。

每次生成路由表时改变条目的顺序。这意味着不同的客户端应该选择一系列服务器作为其首选联系点，如果存在替代方案，则减少所有客户端联系同一台服务器的机会。这使得服务器之间的负载更加均匀。

一个布尔值。

配置 dbms.routing.getRoutingTable() 过程是否应将非写入者主节点包括为读取端点，还是仅返回辅助节点。
注意：如果给定数据库没有辅助节点，则无论此设置的值如何，主节点都将作为读取端点返回。默认为 true，以便非写入者主节点可在典型的异构设置中用于只读查询。

一个布尔值。

配置 dbms.routing.getRoutingTable() 过程是否应将写入者包括为读取端点，还是仅返回非写入者（非写入者主节点和辅助节点）。
注意：如果没有其他成员，写入者将被作为读取端点返回。

一个布尔值。

调用者应缓存路由过程 dbms.routing.getRoutingTable() 响应的时间长度。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s），最小值为 1s。

数据库的默认语言决定了评估未明确选择语言的查询时所使用的语言。此设置确定了在 CREATE 或 ALTER 数据库时未指定语言的新（和初始）数据库所使用的默认语言。

[CYPHER_5, CYPHER_25] 中的一个。于 2025.07 更改

此设置与性能优化相关。在某些情况下，更倾向于让使用 'shortestPath' 函数的任何查询立即终止并返回无结果，而不是尝试寻找结果而长时间运行（即使根本找不到路径），此时请将其设置为 true。对于大多数查询，'shortestPath' 算法会非常快地返回正确答案。但在某些情况下，即使存在路径，快速双向广度优先搜索算法也可能找不到结果。当 WHERE 子句中应用于 'shortestPath' 的谓词无法应用于遍历的每一步，而只能应用于整个路径时，就会发生这种情况。当查询规划器检测到这些特殊情况时，如果快速算法未找到路径，它将计划执行穷举深度优先搜索。然而，穷举搜索的速度可能比快速算法慢几个数量级。如果查询尽快终止至关重要，建议将此选项设置为 true，这意味着 Neo4j 将永远不会考虑对 shortestPath 查询使用穷举搜索。但是，请注意，如果未找到路径，将在运行时抛出错误，需要由应用程序进行处理。

一个布尔值。

此设置与性能优化相关。当起始节点和结束节点相同时，最短路径算法无法工作。将此设置设置为 false 时，发生这种情况将不会返回路径。默认值 true 将抛出异常。如果您在笛卡尔积之后执行 shortestPath 搜索，而传递给 shortestPath 的某些行的起始和结束节点可能相同，则可能会发生这种情况。如果您宁愿不遇到此异常，并且对于这些行缺少结果是可以接受的，则将其设置为 false。如果您无法接受缺少结果，并且确实需要两个相同节点之间的最短路径，请使用标准的 Cypher 可变长度模式表达式重写查询，然后按路径长度排序并限制为一个结果。

一个布尔值。

设置此项以指定当无法满足 Cypher 规划器或运行时提示时的行为。如果为 true，则不符合将导致错误，否则仅生成警告。

一个布尔值。

允许在基数估计期间进行标签推断。如果规划器可以从逻辑上推断出节点具有查询中未明确表达的标签，则规划器将在基数估计期间使用此信息。
此设置控制规划器进行此操作的程度

[MOST_SELECTIVE_LABEL, OFF] 中的一个。

设置此项以更改当起始或结束节点缺失时 Cypher 创建关系的行为。默认情况下，这会使查询失败并停止执行，但通过设置此标志，创建操作将不会执行，执行将继续。

一个布尔值。

两次可能的 Cypher 查询重新规划事件之间的最短时间。此时间过后，将评估图统计信息，如果它们的变化超过了 dbms.cypher.statistics_divergence_threshold 设置的值，查询将重新规划。如果统计信息变化不足，则在统计信息再次被评估之前，必须经过相同的间隔。每次评估时，发散阈值都会略微降低，直到 7 小时后达到 10%，因此即使是适度变化的数据库，在经过足够长的时间间隔后也会看到查询重新规划。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

设置此项以指定默认语言版本的默认规划器。

[DEFAULT, COST] 中的一个。

如果设置为 true，则所有使用 EXPLAIN 或 PROFILE 运行的查询的计划描述的文本表示形式将在服务器上呈现。这允许 neo4j 浏览器和 Cypher shell 等客户端显示更详细的计划描述。

一个布尔值。

统计信息的阈值，超过此阈值，计划被视为过期。

如果创建计划所使用的任何底层统计信息的变化超过此值，则计划将被视为过期并重新规划。变化计算公式为 abs(a-b)/max(a,b)。

这意味着 0.75 的值要求数据库规模翻两番才会重新规划查询。0 的值意味着只要统计信息有任何变化且重新规划间隔已过，查询就会被重新规划。

此间隔由 dbms.cypher.min_replan_interval 定义，默认值为 10 秒。在此间隔后，发散阈值将开始缓慢下降，约 7 小时后达到 10%。这将确保即使是长时间运行的数据库在有适度变化时也能获得查询重新规划，而在变化非常大之前不会频繁地重新规划。

介于 0.0 到 1.0 之间的双精度浮点数。

在具有 CALL () { …​ } IN TRANSACTIONS …​ ON ERROR RETRY …​ 子句的查询中，尝试重试因瞬态错误而失败的子查询事务的默认最长时间。此设置仅在查询中未明确指定重试超时时使用。例如，CALL () { …​ } IN TRANSACTIONS …​ ON ERROR RETRY FOR 10 SECONDS 将使用 10 秒的重试超时覆盖此设置，用于该特定查询。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d）。

分配给并行运行时的 Cypher 工作线程数。如果设置为正数，则将启动该数量的工作线程。如果设置为 0，则会为 Java 虚拟机可用的每个逻辑处理器启动一个工作线程。

如果设置为负数，则服务器上可用的逻辑处理器总数将减少该数字的绝对值。例如，如果服务器有 16 个可用处理器，而您将 server.cypher.parallel.worker_limit 设置为 -1，则并行运行时将有 15 个线程可用。

一个整数。

允许启用或禁用文件监视服务。这是一种辅助服务，但在几乎所有情况下都应保持启用。

一个布尔值。

数据库格式。这是将用于新数据库的格式。有效值为 standard、aligned、high_limit 或 block。aligned 格式本质上是 standard 格式，在页面末尾有一些最小的填充，使得单个记录永远不会跨越页面边界。high_limit 和 block 格式仅适用于企业版。如果您的图大于 340 亿个节点、340 亿个关系或 680 亿个属性，则必须使用 high_limit 或 block。

一个字符串。

将节点视为密集节点的数量阈值。此设置仅适用于 standard、aligned 和 high_limit 格式。

最小为 1 的整数。

指定 Neo4j 在存储文件增长时是否应尝试预分配存储文件。

一个布尔值。

时间函数使用的数据库时区。所有在创建时未明确指定时区的 Time 和 DateTime 值都将使用此配置的默认时区。

描述时区的字符串，可以通过偏移量（例如 +02:00）或名称（例如 Europe/Stockholm）来描述。

启用或禁用对查询在 CPU 上主动执行所花费的时间的跟踪。调用 SHOW TRANSACTIONS 将显示该时间，但不会显示在 query.log 中。
如果您希望 CPU 时间记录在 query.log 中，请设置 db.track_query_cpu_time=true。

一个布尔值。

指定 第一次 DBMS 启动之前的默认数据库名称。在初始默认数据库创建后，更改此设置无效。要更改默认数据库，请改为使用 dbms.setDefaultDatabase() 过程。

有效的数据库名称，仅包含字母、数字、点和破折号，长度在 3 到 63 个字符之间，以字母或数字开头，但不能以名称 system 开头。

数据库时区。除其他事项外，此设置会影响监控过程。

[UTC, SYSTEM] 中的一个。

数据库可以从存储在特定源 URI 的现有 种子（数据库备份或转储）中创建。com.neo4j.dbms.seeding.SeedProvider 的不同实现支持各种类型的种子源。

可以使用以下值：CloudSeedProvider, FileSeedProvider, S3SeedProvider 和 URLConnectionSeedProvider。

此列表指定启用的种子提供程序。如果列表中的多个提供程序支持种子源（URI 方案），则将使用第一个匹配的提供程序。如果列表为空，则从 URI 种子功能实际上被禁用。有关更多信息，请参阅 从 URI 种子化。

逗号分隔的列表，其中每个元素都是一个字符串。

数据库的最大数量。

长整型，最小值为 2。

使用数据报告。

一个布尔值。

启用 Fleet Manager 功能以用于 Neo4j Aura 监控。

一个布尔值。

LOAD CSV 使用的内部缓冲区的大小（以字节为单位）。如果 CSV 文件包含巨大的字段，则可能需要增加此值。

最小为 1 的长整数。

选择在加载使用 LOAD CSV 的 CSV 文件时，是否符合标准 https://datatracker.ietf.org/doc/html/rfc4180 来解释转义引号字符。将此项设置为 false 将使用标准，将重复引号 '""' 解释为单个内联引号；而 true 将使用 Neo4j 3.0 和 3.1 最初支持的传统约定，允许反斜杠在字段内包含引号。

一个布尔值。

全文索引默认应使用的分析器名称。

一个字符串。

全文索引默认是否应为最终一致性。

一个布尔值。

处理最终一致性全文索引的排队索引更新的线程数。

最小为 1 的整数。

刷新最终一致性全文索引的频率（确保更改可见）。如果设置为 0，则由应用最终一致性全文索引更新的线程执行刷新。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d）。

可以并行进行全文索引刷新的线程数，即可以并行刷新的最终一致性全文索引数。

最小为 1 的整数。

全文索引的 最终一致性 模式通过将索引更新排队以在后台线程中稍后应用来工作。此新生成器为此队列中在任何时间点允许存在的索引更新数量设置了上限。达到该限制时，提交过程将减慢并等待索引更新应用线程在队列中腾出一些空间。

介于 1 到 50000000 之间的整数。

启用或禁用后台索引采样。

一个布尔值。

索引采样块大小限制。

介于 1048576 到 2147483647 之间的整数。

触发给定索引采样之前所需的索引更新占总索引大小的百分比。

最小值为 0 的整数。

用于 JSON 注释数据的格式。

这仅在查询日志为 JSON 格式时有效。

[CYPHER, JSON, FLAT_JSON] 中的一个。

记录查询文本和参数而不混淆密码。这允许在解析开始之前更早地记录查询。

一个布尔值。

记录已执行的查询。有效值为 OFF, INFO 或 VERBOSE。

日志条目被写入查询日志。

此功能在 Neo4j 企业版中可用。

[OFF, INFO, VERBOSE] 中的一个。

设置日志中每个参数的最大字符长度。这仅在 db.logs.query.parameter_logging_enabled = true 时生效。

一个整数。

如果为 true，则在将错误信息写入查询日志之前，混淆所有可能包含敏感数据的错误信息。当查询日志使用 JSON 格式时，这适用于 failureReason 和 statusDescription 字段；否则适用于错误消息。建议在生产环境中将此设置设置为 true。

一个布尔值。

如果为 true，则在将查询写入查询日志之前混淆查询中的所有字面量。请注意，节点标签、关系类型和映射属性键保持可见。更改此设置不会影响已缓存的查询。要立即应用更改，您还必须调用 CALL db.clearQueryCaches()。建议在生产环境中将此设置设置为 true。

一个布尔值。

记录正在被记录的已执行查询的参数。

一个布尔值。

记录查询计划描述表，这对调试目的非常有用。

一个布尔值。

如果查询的执行时间超过此阈值，则在查询完成后记录该查询 - 前提是将查询日志记录设置为 INFO。默认为 0 秒，即所有查询都会被记录。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

记录事务的开始和结束。有效值为 'OFF', 'INFO' 或 'VERBOSE'。OFF：不记录。INFO：记录耗时超过配置阈值 db.logs.query.transaction.threshold 的事务的开始和结束。VERBOSE：记录所有事务的开始和结束。日志条目被写入查询日志。

[OFF, INFO, VERBOSE] 中的一个。

如果事务打开的时间超过此阈值，则在事务完成后记录该事务 - 前提是将事务日志记录 (db.logs.query.transaction.enabled) 设置为 INFO。默认为 0 秒（所有事务都会被记录）。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

启用 HTTP 请求日志记录。

一个布尔值。

调试、查询、http 和安全日志的日志配置路径。

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

启用调试日志。

一个布尔值。

启用 GC 日志记录。

一个布尔值。

GC 日志记录选项。

一个字符串。

要保留的 GC 日志数量。

一个整数。

保留的每个 GC 日志的大小。

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB）。

用户日志的日志配置路径。

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

页缓存可以配置为对已加载的页面进行使用采样，这些采样可用于构建活动加载配置文件。根据该配置文件，页面可以在重启、复制等过程中重新加载。此设置允许禁用该行为。此功能在 Neo4j 企业版中可用。

一个布尔值。

根据配置文件对页缓存文件进行预热的顺序。

[NONE, ALPHABETIC, PRIORITY] 中的一个。

页缓存预热可以配置为预取文件，最好在缓存大小大于存储大小时进行。可预取的文件可以通过 'dbms.memory.pagecache.warmup.preload.allowlist' 进行过滤。启用此项将禁用按配置文件的预热。

一个布尔值。

页缓存预热预取文件允许列表正则表达式。默认匹配所有文件。

一个字符串。

页缓存的分析频率。准确的配置文件允许页缓存在此重启后进行主动预热，从而缩短达到性能指标所需的平均时间。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s）。

限制单个事务可以消耗的内存量（以字节为单位，或者后缀为 'k' 的千字节，'m' 的兆字节，以及 'g' 的千兆字节）。零表示“最大可能值”。

字节大小（有效的乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB），最小值为 1.00MiB 或为 0B。

限制一个数据库中所有事务可以消耗的内存量（以字节为单位，或者后缀为 'k' 的千字节，'m' 的兆字节，以及 'g' 的千兆字节）。零表示“无限”。

字节大小（有效的乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB），最小值为 10.00MiB 或为 0B。

每个数据库的缓存 Cypher 查询执行计划数量。缓存中可保持的最大查询计划数量为 数据库数量 * server.db.query_cache_size。如果有 10 个数据库，server.db.query_cache_size=1000，则实例上的缓存总共可以保持 10000 个计划，前提是每个数据库接收的查询都填满了其缓存。

最小值为 0 的整数。

server.memory.query_cache.per_db_cache_num_entries

启用堆外和堆内内存跟踪。对于集群，不应将其设置为 false。

一个布尔值。

限制所有运行中事务可以消耗的内存量（以字节为单位，或者后缀为 'k' 的千字节，'m' 的兆字节，以及 'g' 的千兆字节）。零表示“无限”。默认为堆大小限制的 70%。

字节大小（有效的乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB），最小值为 10.00MiB 或为 0B。

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

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB）。

最大堆大小。默认情况下，它是根据可用系统资源计算得出的。

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB）。

对页缓存使用直接 I/O。此设置仅在 Linux 上受支持，且仅适用于使用平台对齐页面大小的记录格式子集。

一个布尔值。

页缓存可以配置为使用临时缓冲区进行刷新。如果可能，它用于将一系列多个缓存页面合并为一个更大的缓冲区，以最大限度地减少执行的单个 IOPS 数量，并更好地利用可用的 I/O 资源，尤其是在这些资源受限时。

一个布尔值。

页缓存可以配置为使用临时缓冲区进行刷新。如果可能，它用于将一系列多个缓存页面合并为一个更大的缓冲区，以最大限度地减少执行的单个 IOPS 数量，并更好地利用可用的 I/O 资源，尤其是在这些资源受限时。使用此设置可配置单个文件刷新缓冲区的大小（以页面为单位，8KiB）。为了能够在页缓存刷新期间利用此缓冲区，必须启用缓冲刷新。

介于 1 到 512 之间的整数。

进行顺序扫描时用于预取数据的最大工作线程数。设置为 '0' 可禁用扫描的预取。

介于 0 到 255 之间的整数。

用于映射存储文件的内存量。如果 Neo4j 在专用服务器上运行，则通常建议为操作系统留出约 2-4GB，给 JVM 足够的堆来容纳所有事务状态和查询上下文，然后将剩余部分留给页缓存。如果未配置页缓存内存，则会根据可用系统资源计算启发式设置。默认情况下，页缓存的大小将为可用 RAM 的 50% 减去最大堆大小。页缓存的大小也不会大于最大堆大小的 70 倍（由于堆中页缓存的一些开销）。

一个字节大小（有效乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB）。

启用在不同数据库之间共享缓存空间。开启此选项后，数据库将共享缓存空间，但不共享缓存条目。这意味着数据库可以存储和检索共享缓存中的条目，但它可能无法检索由另一个数据库生成的条目。但是，根据约束的缓存大小和缓存驱逐策略，数据库可能会根据需要驱逐来自其他数据库的条目。本质上，数据库可能会竞争缓存空间，但可能不会观察彼此的条目。

开启此选项后，所有数据库可用的缓存空间通过 server.memory.query_cache.shared_cache_num_entries 配置。关闭此选项后，每个单独数据库可用的缓存空间通过 server.memory.query_cache.per_db_cache_num_entries 配置。

一个布尔值。

所有数据库的缓存查询数量。缓存中可保持的最大查询数量正好是 server.memory.query_cache.shared_cache_num_entries。仅当 server.memory.query_cache.sharing_enabled 设置为 true 时，此设置才决定缓存大小。

最小值为 0 的整数。

每个数据库的缓存查询数量。缓存中可保持的最大查询数量为 数据库数量 * server.memory.query_cache.per_db_cache_num_entries。如果有 10 个数据库，server.memory.query_cache.per_db_cache_num_entries=1000，则缓存总共可以保持 10000 个计划。仅当 server.memory.query_cache.sharing_enabled 设置为 false 时，此设置才决定缓存大小。

最小值为 0 的整数。

设置为 true 以启用将指标导出到 CSV 文件。

一个布尔值。

CSV 文件的报告间隔。即，新数据行追加到 CSV 文件的频率。

一个持续时间（有效单位为：ns, μs, ms, s, m, h 和 d；默认单位为 s），最小为 1ms。

决定对 csv 历史记录文件使用什么压缩。

[NONE, ZIP, GZ] 中的一个。

csv 文件的最大历史记录文件数量。

最小为 1 的整数。

csv 文件自动轮换的文件大小（以字节为单位）。如果设置为零，则不会发生轮换。接受二进制后缀 k, m 或 g。

字节大小（有效的乘数为 B, KiB, KB, K, kB, kb, k, MiB, MB, M, mB, mb, m, GiB, GB, G, gB, gb, g, TiB, TB, PiB, PB, EiB, EB），范围在 0B 到 8388608.00TiB 之间。