debug_discard_caches 是一个 配置参数,指示 PostgreSQL 在第一个可能的机会使每个 系统目录 缓存条目失效。
debug_discard_caches 在 PostgreSQL 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 (PostgreSQL 18)
| 设置 | 0 |
| 单位 | |
| 类别 | 开发者选项 |
| 简短描述 | 为调试目的,积极刷新系统缓存。 |
| 扩展描述 | 0 表示使用正常的缓存行为。 |
| 上下文 | superuser |
| 变量类型 | 整数 |
| 来源 | 默认 |
| 最小值 | 0 |
| 最大值 | 5 |
| 枚举值 | |
| 启动值 | 0 |
| 重置值 | 0 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
debug_discard_caches (PostgreSQL 17)
| 设置 | 0 |
| 单位 | |
| 类别 | 开发者选项 |
| 简短描述 | 为调试目的,积极刷新系统缓存。 |
| 扩展描述 | |
| 上下文 | superuser |
| 变量类型 | 整数 |
| 来源 | 默认 |
| 最小值 | 0 |
| 最大值 | 5 |
| 枚举值 | |
| 启动值 | 0 |
| 重置值 | 0 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
debug_discard_caches (PostgreSQL 16)
| 设置 | 0 |
| 单位 | |
| 类别 | 开发者选项 |
| 简短描述 | 为调试目的,积极刷新系统缓存。 |
| 扩展描述 | |
| 上下文 | superuser |
| 变量类型 | 整数 |
| 来源 | 默认 |
| 最小值 | 0 |
| 最大值 | 5 |
| 枚举值 | |
| 启动值 | 0 |
| 重置值 | 0 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
debug_discard_caches (PostgreSQL 15)
| 设置 | 0 |
| 单位 | |
| 类别 | 开发者选项 |
| 简短描述 | 为调试目的,积极刷新系统缓存。 |
| 扩展描述 | |
| 上下文 | superuser |
| 变量类型 | 整数 |
| 来源 | 默认 |
| 最小值 | 0 |
| 最大值 | 5 |
| 枚举值 | |
| 启动值 | 0 |
| 重置值 | 0 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
debug_discard_caches (PostgreSQL 14)
| 设置 | 0 |
| 单位 | |
| 类别 | 开发者选项 |
| 简短描述 | 为调试目的,积极刷新系统缓存。 |
| 扩展描述 | |
| 上下文 | superuser |
| 变量类型 | 整数 |
| 来源 | 默认 |
| 最小值 | 0 |
| 最大值 | 5 |
| 枚举值 | |
| 启动值 | 0 |
| 重置值 | 0 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
变更历史
参考资料
- PostgreSQL 文档: debug_discard_caches
