连接提示

在 bolt 4.3 中引入

从 bolt 4.3 版开始，服务器可以选择在对 HELLO 消息的响应中提供的 SUCCESS 元数据中包含一组配置提示。驱动程序可以自行决定解释或忽略这些提示。当前已定义以下提示集。

ssr.enabled::Boolean

在 bolt 5.8 中引入

指示数据库集群是否配置了已启用的服务器端路由（SSR），以便在当前成员无法处理事务时，事务可以在集群成员之间进行路由。

如果缺少此提示，则视为 SSR 已禁用。

示例

C: HELLO {"user_agent": "neo4j-javascript/5.26.0", "bolt_agent": {"product": "neo4j-javascript/5.26.0", "platform": "darwin 24.1.0; arm64", "language_details": "Node/18.19.0 (v8 10.2.154.26-node.28)"}}
S: SUCCESS {"server": "Neo4j/5.26.0", "connection_id": "example-connection-id:1", "hints": {"ssr.enabled": true}}

telemetry.enabled::Boolean

在 bolt 5.4 中引入

是否启用通过 TELEMETRY 消息进行遥测收集。

如果为 false 或未出现，驱动程序不应发送 TELEMETRY 消息。即使发送，服务器也会忽略这些消息。

示例

C: HELLO {"user_agent": "Example/5.13.0", "scheme": "basic", "principal": "test", "credentials": "test"}
S: SUCCESS {"server": "Neo4j/5.13.0", "connection_id": "example-connection-id:1", "hints": {"telemetry.enabled": true}}

connection.recv_timeout_seconds::Integer

在 bolt 4.3 中引入

在请求之后，连接可以保持空闲的最长时间（以秒为单位），超过此时间后驱动程序应视为过期。

服务器将确保在每个超时时间段内至少发送一次块（或 NOOP 块）。选择解释此提示的驱动程序可以终止依据此提示定义被视为过期的连接。

示例

C: HELLO {"user_agent": "Example/4.0.0", "scheme": "basic", "principal": "test", "credentials": "test"}
S: SUCCESS {"server": "Neo4j/4.3.0", "connection_id": "example-connection-id:1", "hints": {"connection.recv_timeout_seconds": 120}}