debug_discard_caches

一个用于使系统目录缓存条目失效的调试参数

debug_discard_caches 是一个 配置参数,指示 PostgreSQL 在第一个可能的机会使每个 系统目录 缓存条目失效。

debug_discard_cachesPostgreSQL 14 中添加。

默认

debug_discard_caches 的默认值为:0。有关例外情况,请参阅“用法”部分。

请注意,debug_discard_caches 仅在 PostgreSQL 使用 --enable-cassert 选项编译,或者 DISCARD_CACHES_ENABLED 被手动设置的情况下才能启用。否则,无法更改此设置。

用法

debug_discard_caches 的引入是为了避免在构建 PostgreSQL 时设置 CLOBBER_CACHE_ALWAYS 的需要,并使得可以动态启用/禁用该设置。

为保持向后兼容,如果定义了 CLOBBER_CACHE_ALWAYS,则 debug_discard_caches 将被设置为 1;如果定义了 CLOBBER_CACHE_RECURSIVE,则设置为 3

PostgreSQL 14 开始,可以向 initdb 提供 --discard-caches 选项,以引导后端使用 debug_discard_caches,该值将设置为 1

按 PostgreSQL 版本详细信息

debug_discard_caches (PostgreSQL 19)

设置 0
单位  
类别 开发者选项
简短描述 为调试目的,积极刷新系统缓存。
扩展描述 0 表示使用正常的缓存行为。
上下文 superuser
变量类型 整数
来源 默认
最小值 0
最大值 5
枚举值  
启动值 0
重置值 0
源文件  
源行  
需要重启 false

文档debug_discard_caches

debug_discard_caches (PostgreSQL 18)

设置 0
单位  
类别 开发者选项
简短描述 为调试目的,积极刷新系统缓存。
扩展描述 0 表示使用正常的缓存行为。
上下文 superuser
变量类型 整数
来源 默认
最小值 0
最大值 5
枚举值  
启动值 0
重置值 0
源文件  
源行  
需要重启 false

文档debug_discard_caches

debug_discard_caches (PostgreSQL 17)

设置 0
单位  
类别 开发者选项
简短描述 为调试目的,积极刷新系统缓存。
扩展描述  
上下文 superuser
变量类型 整数
来源 默认
最小值 0
最大值 5
枚举值  
启动值 0
重置值 0
源文件  
源行  
需要重启 false

文档debug_discard_caches

debug_discard_caches (PostgreSQL 16)

设置 0
单位  
类别 开发者选项
简短描述 为调试目的,积极刷新系统缓存。
扩展描述  
上下文 superuser
变量类型 整数
来源 默认
最小值 0
最大值 5
枚举值  
启动值 0
重置值 0
源文件  
源行  
需要重启 false

文档debug_discard_caches

debug_discard_caches (PostgreSQL 15)

设置 0
单位  
类别 开发者选项
简短描述 为调试目的,积极刷新系统缓存。
扩展描述  
上下文 superuser
变量类型 整数
来源 默认
最小值 0
最大值 5
枚举值  
启动值 0
重置值 0
源文件  
源行  
需要重启 false

文档debug_discard_caches

debug_discard_caches (PostgreSQL 14)

设置 0
单位  
类别 开发者选项
简短描述 为调试目的,积极刷新系统缓存。
扩展描述  
上下文 superuser
变量类型 整数
来源 默认
最小值 0
最大值 5
枚举值  
启动值 0
重置值 0
源文件  
源行  
需要重启 false

文档debug_discard_caches

变更历史

  • PostgreSQL 14
    • 添加(提交 4656e3d6),最初命名为 debug_invalidate_system_caches_always,后重命名为 debug_discard_caches(提交 d68a0039)。

分类

开发/测试, GUC配置项

反馈

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