2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4

F.30. pg_prewarm — 将关系数据预加载到缓冲区缓存 #

pg_prewarm 模块提供了一种方便的方式,将关系数据加载到操作系统缓冲区缓存或 PostgreSQL 缓冲区缓存中。预热可以通过使用 pg_prewarm 函数手动执行,也可以通过将 pg_prewarm 包含在 shared_preload_libraries 中自动执行。在后一种情况下,系统将运行一个后台工作进程,它会定期将共享缓冲区的 contents 记录在一个名为 autoprewarm.blocks 的文件中,并在重启后使用 2 个后台工作进程重新加载这些相同的块。

F.30.1. 函数 #

pg_prewarm(regclass, mode text default 'buffer', fork text default 'main',
           first_block int8 default null,
           last_block int8 default null) RETURNS int8

第一个参数是要预热的关系。第二个参数是要使用的预热方法,如下所述;第三个参数是要预热的关系分叉,通常是 main。第四个参数是要预热的第一个块号(NULL 被接受为零的同义词)。第五个参数是要预热的最后一个块号(NULL 表示预热到关系中的最后一个块)。返回值是预热的块数。

有三种可用的预热方法。prefetch 向操作系统发出异步预取请求,如果支持则执行,否则抛出错误。read 读取请求的块范围;与 prefetch 不同,这是一种同步操作,在所有平台和构建上都受支持,但可能较慢。buffer 将请求的块范围读取到数据库缓冲区缓存中。

请注意,使用任何这些方法,尝试预热比可以缓存的块更多的块——当使用 prefetchread 时由操作系统缓存,或当使用 buffer 时由 PostgreSQL 缓存——可能会导致较低编号的块在读取较高编号的块时被逐出。预热数据也不会受到特殊保护免受缓存逐出,因此新预热的块在读取后不久可能被其他系统活动逐出;反之,预热也可能将其他数据从缓存中逐出。出于这些原因,预热通常在启动时最有用,那时缓存大致是空的。

autoprewarm_start_worker() RETURNS void

启动主 autoprewarm 工作进程。这通常会自动发生,但如果服务器启动时未配置自动预热,并且您希望稍后启动工作进程,则此功能很有用。

autoprewarm_dump_now() RETURNS int8

立即更新 autoprewarm.blocks。如果 autoprewarm 工作进程未运行,但您预计在下次重启后运行它,这可能会很有用。返回值是写入 autoprewarm.blocks 的记录数。

F.30.2. 配置参数 #

pg_prewarm.autoprewarm (boolean)

控制服务器是否应运行 autoprewarm 工作进程。默认情况下启用。此参数只能在服务器启动时设置。

pg_prewarm.autoprewarm_interval (integer)

这是 autoprewarm.blocks 更新之间的间隔。默认值为 300 秒。如果设置为 0,则文件不会按固定间隔转储,只有在服务器关闭时才会转储。

这些参数必须在 postgresql.conf 中设置。典型的用法可能是

# postgresql.conf
shared_preload_libraries = 'pg_prewarm'

pg_prewarm.autoprewarm = true
pg_prewarm.autoprewarm_interval = 300s

F.30.3. 作者 #

Robert Haas

提交更正

如果您在文档中发现任何不正确之处、与您对特定功能的体验不符或需要进一步澄清的地方,请使用 此表单 报告文档问题。