↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / 配置参数

shared_preload_libraries

英文手册覆盖始于 PostgreSQL 7.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

boot val
未知
category
Client Connection Defaults / Shared Library Preloading
context
postmaster
documented
true
enumvals
未知
extra desc
未知
lang
en
max val
未知
metadata version
18
min val
未知
name
shared_preload_libraries
short desc
Lists shared libraries to preload into server.
source
pg-settings-source-snapshot
unit
未知
vartype
string

版本定义 PG 18

这个变量指定一个或者多个要在服务器启动时预载入的共享库。它包含一个由逗号分隔的库名列表,其中每个名称都会按LOAD命令的方式解析。项之间的空格会被忽略,如果需要在库名中包含空格或者逗号,请把库名放在双引号内。这个参数只能在服务器启动时设置。如果指定的库没有找到,服务器将无法启动。

有些库需要执行只能在postmaster启动时发生的特定操作,例如分配共享内存、保留轻量级锁或者启动后台工作者。这些库必须通过这个参数在服务器启动时载入。每个库的详情请见文档。

其他库也能被预载入。通过预载入一个共享库,当该库被第一次使用时就可以省去库的启动耗时。不过,启动每个新服务器进程的时间可能会略有增加,即使该进程从不使用该库。因此,推荐只把这个参数用于那些要在大多数会话中使用的库上。还有,改变这个参数要求重启服务器,因此对于短期的调试任务来说这不是好的选择,应该转用session_preload_libraries。

注意

在 Windows 主机上,在服务器启动时预载入一个库并不会减少启动每个新服务器进程所需的时间;每一个服务器进程将会重新载入所有预载入的库。不过,对于那些要在postmaster启动时执行操作的库来说,Windows 主机上的 shared_preload_libraries仍然有用。

比较版本

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · english-manuals:d08630ebaefede03839708edb7a796056863e9bffbcc4c92a505450d8cf6c105

正文语言: zh-Hans · 2026-09-11@29c86d9