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

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

Wiki / 配置参数

local_preload_libraries

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

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

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

版本定义 PG 18

这个变量指定一个或者多个要在连接开始时预载入的共享库。它包含一个由逗号分隔的库名列表,其中每个名称都会按LOAD命令的方式解析。项之间的空格会被忽略,如果需要在库名中包含空格或者逗号,请把库名放在双引号内。这个参数值只在连接开始时生效。后续的更改不会有任何效果。如果一个指定的库没有找到,连接尝试将会失败。

任何用户都能设置这个选项。正因为如此,能被这样载入的库被严格限制为出现于安装的标准库目录中plugins子目录下的共享库(保证只有“安全的”库被安装到这里是数据库管理员的责任)。local_preload_libraries中的项可以显式指定这个目录,例如$libdir/plugins/mylib,或者只是指定库的名称 — mylib 和 $libdir/plugins/mylib的效果是相同的。

这个特性的目的是允许非特权用户在特定的会话中载入用于调试或性能测量的库,而无需一个显式的LOAD命令。为了这个目的,通常通过使用客户端的PGOPTIONS环境变量或者 ALTER ROLE SET来设置这个参数。

不过,除非一个模块被特别设计成由非超级用户以这种方式使用,通常不推荐使用这个设置。请改为参阅session_preload_libraries。

比较版本

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · english-manuals:41746a5ead0db2c64462ad2fa9c51f099f74432e4244d6e57785dabbb9c040e2

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