连接提示
在 Bolt 4.3 中引入
从 Bolt 4.3 版本开始,服务器可以根据 HELLO
消息的响应,选择性地在 SUCCESS
元数据中包含一组配置提示。驱动程序可以自行决定解释或忽略这些提示。目前定义了以下提示集。
ssr.enabled::布尔值
在 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::布尔值
在 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::整数
在 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}}