old_snapshot
支持 old_snapshot_threshold 的实用程序
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
old_snapshot | 1.0 | ADMIN | PostgreSQL | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 5960 | old_snapshot | 否 | 是 | 否 | 是 | 否 | 否 | - |
| 相关扩展 | pageinspect pg_visibility pgstattuple pg_prewarm pg_buffercache amcheck pg_surgery toastinfo |
|---|
版本
| PG18 | PG17 | PG16 | PG15 | PG14 |
|---|---|---|---|---|
| ✗ | ✗ | 1.0 | 1.0 | 1.0 |
安装
提示：这是 PostgreSQL 内核自带的 contrib 扩展
CREATE EXTENSION old_snapshot;
用法
old_snapshot 扩展提供与 old_snapshot_threshold 配置参数相关的服务器状态检查函数。
注意：在较新版本中，本章已从 PostgreSQL 当前文档中移除；需要时请使用版本化文档。
函数
-- 查看时间戳到 XID 的映射表
SELECT * FROM pg_old_snapshot_time_mapping();
函数签名
pg_old_snapshot_time_mapping(
array_offset OUT int4,
end_timestamp OUT timestamptz,
newest_xmin OUT xid
) RETURNS SETOF record
输出列
| 列 | 类型 | 描述 |
|---|---|---|
array_offset | int4 | 映射数组中的索引位置 |
end_timestamp | timestamptz | 对应一分钟时间段的结束时间 |
newest_xmin | xid | 该分钟内拍摄的所有快照中最新的 xmin |
上下文
PostgreSQL 的 old_snapshot_threshold 参数控制快照保持有效的时长。服务器维护一个内部的时间戳到事务 ID 的映射来实现此功能。此扩展公开该映射以供检查和调试。
-- 检查 old_snapshot_threshold 设置
SHOW old_snapshot_threshold;
-- 检查当前映射条目
SELECT array_offset, end_timestamp, newest_xmin
FROM pg_old_snapshot_time_mapping()
ORDER BY array_offset;