PostgreSQL commit timestamp原理与pg_commit_ts文件创建规则

1. Commit Timestamp 内部工作机制 #

Commit Timestamp（提交时间戳）是PostgreSQL内置的事务元数据模块，核心作用是为每个已提交事务持久化存储其提交时刻的精确时间戳，工作逻辑如下：

• 存储结构：内存层维护固定大小的环形共享缓存，用于加速最近提交事务的时间戳查询；持久化层落地在pg_commit_ts目录下，以固定256KB（即262144字节）为单位切分成段文件，按数字顺序命名，每个事务ID对应一条8字节的定长记录，存储事务提交的微秒级时间戳，部分版本会附带少量事务状态标记位。
• 写入流程：事务执行COMMIT时，对应的WAL提交记录会先写入WAL缓冲区，记录中携带当前事务的提交时间戳；等WAL记录持久化刷盘、事务正式标记为提交状态后，Commit Timestamp数据会先写入共享缓存，再由后台checkpoint进程异步刷写到pg_commit_ts的段文件中。如果实例发生崩溃，重启恢复时会从WAL日志重放补全所有缺失的提交时间戳记录，保证数据一致性。
• 读取流程：当调用pg_xact_commit_timestamp()系统函数、执行逻辑解码、或运行依赖提交时间的内置特性（如增量同步、长事务快照检测）时，会先查询共享内存缓存，命中直接返回结果；缓存未命中时再读取对应段文件加载到缓存后返回。
• 回收逻辑：和CLOG（事务提交日志）等其他事务元数据的回收逻辑一致，当段文件内存储的所有事务ID都早于集群全局冻结事务ID、不存在任何访问需求时，旧段文件会在checkpoint或vacuum freeze流程中被自动清理，不会无限增长占用磁盘。

2. pg_commit_ts目录下段文件的创建规则 #

你观察到的pg_commit_ts目录下的文件列表如下：

-rw-------.  1 postgres postgres 262144 Jun 17 12:56 0000
-rw-------.  1 postgres postgres 262144 Jun 17 12:56 0001
-rw-------.  1 postgres postgres 262144 Jun 17 12:57 0002
...

这些256KB数字命名段文件，只有在track_commit_timestamp参数设置为on时才会被创建和写入，补充几个实际运维中需要注意的点：

• track_commit_timestamp是静态参数，修改后必须重启数据库实例才能生效，无法通过reload动态加载。
• 参数为off时，初始化数据目录会默认创建空的pg_commit_ts目录，但目录下不会生成任何段文件，也不会产生任何写入IO，不占用额外磁盘空间。
• 如果之前开启过该参数、已经生成了段文件，后续将参数改回off重启实例后，已有的旧段文件不会被自动删除，但不会再有新的写入，也不会被系统访问，停库后可以手动清理这些旧文件释放空间。
• 你看到的单文件262144字节是段文件的固定大小，每个段可以存储32768个事务的提交时间记录，和该模块的默认设计完全匹配。

内容的提问来源于stack exchange，提问作者Fabrice Chapuis