|| SHOW SETTINGS - Cypher 手册 - Neo4j 文档

SHOW SETTINGS

可以使用 SHOW SETTINGS 列出服务器上的配置设置。

SHOW SETTINGS 命令仅返回执行服务器上的设置。要检索特定服务器上的设置，您需要使用 bolt 方案直接连接到该服务器。

SHOW SETTINGS 命令仅返回默认输出。要获取完整输出，请使用可选的 YIELD 命令。完整输出：SHOW SETTINGS YIELD *。

SHOW SETTINGS 命令将生成一个包含以下列的表

表 1. 显示设置输出
列	描述	类型
`名称`	设置的名称。默认输出	`字符串`
`值`	设置的当前值。默认输出	`字符串`
`是否动态`	设置的值是否可以动态更新，而无需重启服务器。有关动态更新设置值的信息，请参阅更新动态设置。默认输出	`布尔值`
`默认值`	设置的默认值。默认输出	`字符串`
`描述`	设置描述。默认输出	`字符串`
`启动值`	上次启动时设置的值。	`字符串`
`是否显式设置`	设置的值是否由用户显式设置，无论是通过配置还是动态设置。	`布尔值`
`有效值`	设置的有效值描述。	`字符串`
`是否已废弃`	设置是否已废弃。在 5.9 中引入	`布尔值`

语法

有关语法描述的更多详细信息，请参见此处。

列出设置

SHOW SETTING[S] [setting-name[,...]]
[YIELD { * | field[, ...] } [ORDER BY field[, ...]] [SKIP n] [LIMIT n]]
[WHERE expression]
[RETURN field[, ...] [ORDER BY field[, ...]] [SKIP n] [LIMIT n]]

设置名称必须以一个或多个逗号分隔的带引号的 STRING 值形式提供，或者以解析为 STRING 或 LIST<STRING> 的表达式形式提供。

使用 RETURN 子句时，YIELD 子句是强制性的，不得省略。

列出所有设置

要列出所有设置及其默认输出列，可以使用 SHOW SETTINGS 命令。如果需要所有列，请使用 SHOW SETTINGS YIELD *。

查询

SHOW SETTINGS

表 2. 结果
名称	值	是否动态	默认值	描述
`"browser.allow_outgoing_connections"`	`"true"`	`false`	`"true"`	`"配置 Neo4j Browser 出站连接策略。"`
`"browser.credential_timeout"`	`"0s"`	`false`	`"0s"`	`"配置 Neo4j Browser 在此空闲期后使登录用户超时。设置为 0 表示无限制。"`
`"browser.post_connect_cmd"`	`""`	`false`	`""`	`"Neo4j Browser 成功连接到此服务器时要运行的命令。多个命令之间用分号分隔。"`
`"browser.remote_content_hostname_whitelist"`	`"guides.neo4j.com,localhost"`	`false`	`"guides.neo4j.com,localhost"`	`"Neo4j Browser 允许从中获取内容的主机白名单。"`
`"browser.retain_connection_credentials"`	`"true"`	`false`	`"true"`	`"配置 Neo4j Browser 是否存储用户凭据。"`
`"browser.retain_editor_history"`	`"true"`	`false`	`"true"`	`"配置 Neo4j Browser 是否存储用户编辑器历史记录。"`
`"client.allow_telemetry"`	`"true"`	`false`	`"true"`	`"配置客户端应用程序（如 Browser 和 Bloom）发送产品分析数据。"`
`"db.checkpoint"`	`"PERIODIC"`	`false`	`"PERIODIC"`	"配置检查点发生的通用策略。默认策略是“周期性”检查点策略，由“db.checkpoint.interval.tx”和“db.checkpoint.interval.time”设置指定。Neo4j 企业版提供了两种替代策略：第一种是“连续”检查点策略，它将忽略这些设置并始终运行检查点进程。第二种是“体积”检查点策略，它会尽力频繁地进行检查点，以便数据库在根据“db.tx_log.rotation.retention_policy”设置删除旧事务日志方面不会落后太多。"
`"db.checkpoint.interval.time"`	`"15m"`	`false`	`"15m"`	"配置检查点之间的时间间隔。数据库不会比这更频繁地进行检查点（除非检查点由其他事件触发），但如果执行检查点所需的时间比配置的间隔长，则可能会比此间隔更不频繁地进行检查点。检查点是事务日志中的一个点，恢复将从该点开始。更长的检查点间隔通常意味着在发生崩溃时恢复将需要更长的时间才能完成。另一方面，更长的检查点间隔还可以减少数据库施加在系统上的 I/O 负载，因为每个检查点都意味着所有存储文件的刷新和强制写入。"
`"db.checkpoint.interval.tx"`	`"100000"`	`false`	`"100000"`	"配置检查点之间的事务间隔。数据库不会比这更频繁地进行检查点（除非检查点由其他事件触发），但如果执行检查点所需的时间比配置的间隔长，则可能会比此间隔更不频繁地进行检查点。检查点是事务日志中的一个点，恢复将从该点开始。更长的检查点间隔通常意味着在发生崩溃时恢复将需要更长的时间才能完成。另一方面，更长的检查点间隔还可以减少数据库施加在系统上的 I/O 负载，因为每个检查点都意味着所有存储文件的刷新和强制写入。默认值为 '100000'，表示每 100000 个事务进行一次检查点。"
行数：10

上表仅显示查询的前 10 个结果。有关 Neo4j 中所有可用设置的完整列表，请参阅配置设置。

按输出列过滤列出设置

可以使用 WHERE 子句过滤列出的设置。例如，以下查询返回以 'server' 开头的前三个设置的名称、值和描述

查询

SHOW SETTINGS YIELD name, value, description
WHERE name STARTS WITH 'server'
RETURN name, value, description
LIMIT 3

表 3. 结果
名称	值	描述
`"server.backup.advertised_address"`	`"localhost:0"`	`"备份服务器的 advertised address。默认为默认的 advertised address 与备份监听地址中定义的端口的组合。"`
`"server.backup.enabled"`	`"true"`	`"启用对运行在线备份的支持。"`
`"server.backup.exec_connector.command"`	`""`	`"用于 ExecDataConnector 列表的执行命令"`
行数：3

列出特定设置

可以通过设置名称来指定要在列表中返回的设置。

查询

SHOW SETTINGS "server.bolt.enabled", "server.bolt.advertised_address", "server.bolt.listen_address"

表 4. 结果
名称	值	是否动态	默认值	描述
`"server.bolt.advertised_address"`	`"localhost:7687"`	`false`	`":7687"`	`"此连接器的 advertised address。"`
`"server.bolt.enabled"`	`"true"`	`false`	`"true"`	`"启用 Bolt 连接器。"`
`"server.bolt.listen_address"`	`"localhost:7687"`	`false`	`":7687"`	`"连接器应绑定的地址。"`
行数：3