pgPedia

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

主页 / S

• 浏览分类
• 随机条目
• PgPedia周刊
  • 2025-10-05
• 25年前的今天
• PostgreSQL版本发布
  • PostgreSQL 19 (开发中)
  • PostgreSQL 18 (最新)
  • PostgreSQL 17
  • PostgreSQL 16
  • PostgreSQL 15
  • PostgreSQL 14
  • PostgreSQL 13
  • PostgreSQL 12 (已停止支持)

版本图表

SQL命令
系统目录表
系统目录视图
系统统计视图
文件系统函数

Contrib模块
对象标识符类型
进度报告视图
存储参数 (relopts)
预定义角色

实用概述

PostgreSQL在线工具
缩略语和首字母缩略词
Pg 10中的xlog重命名

有用链接

PostgreSQL文档
PostgreSQL特性矩阵
PostgreSQL版本策略
PostgreSQL最新版本

@pgpedia.info (Bluesky)

咖啡

shared_preload_libraries

shared_preload_libraries 是一个 服务器配置参数，用于确定在 PostgreSQL 启动时要加载哪些库。任何使用共享内存的库必须通过此参数加载。

shared_preload_libraries 于 PostgreSQL 7.4 中添加（当时名为 preload_libraries）。

默认值

shared_preload_libraries 的默认值是：'' （空字符串）。

用法

通常 shared_preload_libraries 只包含每个库的名称，在这种情况下，假定该库位于 LIBDIR/postgresql/（其中 LIBDIR 是 pg_config --libdir 命令报告的值），例如：

shared_preload_libraries = 'auto_explain,pg_stat_statements'

也可以将库文件指定为绝对文件路径，例如：

shared_preload_libraries = '/usr/pgsql-13/lib/pg_stat_statements/pg_stat_statements.so'

请注意，文件后缀（此处为“.so”）是可选的，通常会被省略。

按 PostgreSQL 版本详细信息

变更历史

• PostgreSQL 16
  • shared_preload_libraries 现在可以在单用户模式下处理（提交 6c31ac09）
• PostgreSQL 10
  • 库名称被视为字符串字面量，而不是 SQL 标识符（提交 a69dfe5f）
• PostgreSQL 8.2
  • 从 preload_libraries 重命名为 shared_preload_libraries（提交 abc3120e）
• PostgreSQL 7.4
  • 添加为 preload_libraries（提交 15ce2d2e）

源代码

shared_preload_libraries 定义在 src/backend/utils/misc/guc.c

	{
		{"shared_preload_libraries", PGC_POSTMASTER, CLIENT_CONN_PRELOAD,
			gettext_noop("Lists shared libraries to preload into server."),
			NULL,
			GUC_LIST_INPUT | GUC_LIST_QUOTE | GUC_SUPERUSER_ONLY
		},
		&shared_preload_libraries_string,
		"",
		NULL, NULL, NULL
	},

并通过 src/backend/utils/init/miscinit.c 中的 process_shared_preload_libraries() 进行处理

/*
 * process any libraries that should be preloaded at postmaster start
 */
void
process_shared_preload_libraries(void)
{
	process_shared_preload_libraries_in_progress = true;
	load_libraries(shared_preload_libraries_string,
				   "shared_preload_libraries",
				   false);
	process_shared_preload_libraries_in_progress = false;
}

请注意，对逗号分隔字符串的底层解析由 SplitDirectoriesString()（来自 src/backend/utils/adt/varlena.c）处理，这实际上意味着可以提供的值的最大长度是 MAXPGPATH - 1。

参考资料

分类

另请参阅

反馈

在此处提交关于“shared_preload_libraries”的任何评论、建议或更正 这里。