CONFIGURATION PARAMETER资源消耗 / 计时
timing_clock_source
控制收集计时测量时使用的时钟来源。
Controls the clock source used for collecting timing measurements.
枚举 会话（超级用户） 引入 19 现存至 20 devel 0 次默认值变更 开发版
版本轨迹
PostgreSQL 20 开发版沿用 19 的 pg_settings 事实，说明取自 devel 手册。 20 开发版尚未定稿：pg_settings 事实沿用 19，说明取自本站 devel 手册。
默认值变迁
默认值自 PostgreSQL 19 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
选择使用操作系统或专用 CPU 指令进行计时测量的方法。可能的值有：
auto（在受支持的 x86-64 CPU 上自动选择 TSC 时钟源，否则使用操作系统时钟）system（使用操作系统时钟进行计时测量）tsc（使用 CPU 指令进行计时，例如在 x86-64 上使用RDTSC/RDTSCP）
默认值为auto。只有超级用户可以更改此设置。不建议在查询执行期间更改该设置，因为这可能会导致间隔计时出现明显跳变，或者产生负值。
如果启用，名为 TSC 的时钟源会在测量时间间隔时使用专门的 CPU 指令；它的名字来自 x86-64 上的时间戳计数器（Time-Stamp Counter）。与读取操作系统时钟相比，这可以降低计时开销，并减少叠加在实际运行时间之上的测量误差，例如在 EXPLAIN ANALYZE 中。
在 x86-64 CPU 上，TSC 时钟源会在 EXPLAIN ANALYZE 中使用 RDTSC 指令。对于需要更高精度的计时，会使用 RDTSCP 指令，以避免由于 CPU 指令重排序造成的不准确。较旧的 x86-64 CPU 和其他架构不支持使用 TSC 时钟源，而且在使用模拟 TSC 的系统上也不建议这样做，因为它很可能比系统时钟源更慢。
为了帮助决定应使用哪种时钟源，你可以运行 pg_test_timing 工具来检查 TSC 可用性并执行计时测量。
机制详解
timing_clock_source：控制收集计时测量时使用的时钟来源。运行时只有超级用户或获得相应 SET 授权的角色可以修改。 本站在 PG19 Beta 3 实测到它；boot_val 是编译或初始化基线，并不能证明某个运行集群的当前有效值。
auto 会在合适的 x86-64 CPU 上选择时间戳计数器，否则使用操作系统单调时钟；system 强制系统时钟，tsc 请求 RDTSC/RDTSCP 等 CPU 指令。快速时钟可降低 EXPLAIN ANALYZE 的测量开销，但模拟或不稳定的 TSC 可能更慢甚至产生无效结果。
应与 track_io_timing、track_wal_io_timing、log_executor_stats、compute_query_id 一起理解。请在目标服务器检查 SHOW 与 pg_settings，确认 source 和 pending_restart，并在修改前后对比真实负载、日志和资源指标。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
必须在生产存储栈与真实并发下测试，优化尾延迟和队列深度，而不只看平均吞吐，并为 WAL、检查点与前台读取保留容量。
-
OLAP分析与批处理
使用有代表性的扫描、预取与落盘阶段；只有吞吐继续提升且 CPU、内存与存储没有不可接受的饱和时，才增加并发或 worker 容量。
-
小规格低配实例与开发机
优先采用 auto 或上游 worker 上限，并按场景使用 pg_test_timing 或 I/O 统计验证；小节点上的大进程池可能只增加上下文切换。
常见问题
- 把 timing_clock_source 的实测 boot_val 当成初始化后或托管集群当前有效值的证明。
- 忽略 pg_settings 报告的 superuser context，误以为修改会立即生效。
- 孤立修改该参数，没有检查关联上限、可观测性和回滚路径。
- 在生产中依赖测试版行为，却没有在 PostgreSQL 19 正式版发布后重新验证。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 19 ← 18 新增此参数
PostgreSQL 19 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 计时 1 | |||||
timing_clock_source |
枚举 | 会话（超级用户） | auto |
— | |
| 控制收集计时测量时使用的时钟来源。 | 现存 | ||||