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

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

Wiki / 配置参数

session_preload_libraries

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

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

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

版本定义 PG 18

这个变量指定在连接开始时要预加载的一个或多个共享库。它包含一个逗号分隔的库名称列表,其中每个名称的解释方式与LOAD命令相同。条目之间的空格会被忽略;如果需要在名称中包含空格或逗号,请用双引号括起库名称。参数值仅在连接开始时生效。后续更改不会生效。如果指定的库未找到,连接尝试将失败。只有超级用户和具有适当SET权限的用户才能更改此设置。

这个特性的意图是允许在特定会话中载入调试用的或者测量性能的库,而不需要显式地给出一个 LOAD命令。例如,通过用ALTER ROLE SET设置这个参数可以为一个给定用户名下的所有会话启用auto_explain。还有,无需重启服务器就能更改这个参数(但是只有新会话启动时才会生效),这样可以以这种方式更容易地增加新模块,即便它们会应用到所有会话。

和shared_preload_libraries不同,相对于在库被第一次使用时载入它,在会话开始时载入库并没有明显的性能优势。不过,当使用连接池时这样做还是有一些优势。

比较版本

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · english-manuals:48ef0691f40262da8a8ae6443935c0c995f94160ba8254bb1812147df9a316eb

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