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不同,相对于在库被第一次使用时载入它,在会话开始时载入库并没有明显的性能优势。不过,当使用连接池时这样做还是有一些优势。
比较版本
来源引用
定义来源
center · PostgreSQL 18 · english-manuals:48ef0691f40262da8a8ae6443935c0c995f94160ba8254bb1812147df9a316eb
正文语言: zh-Hans · 2026-09-11@29c86d9