toast.vacuum_max_eager_freeze_failure_rate
Per-table value for vacuum_max_eager_freeze_failure_rate parameter.
Reading PG 18·Select a recorded version
- Applies to
- TOAST tables
- Value type
- floating point
- signature
- WITH (toast.vacuum_max_eager_freeze_failure_rate = value)
Definition PG 18
Specifies the maximum number of pages (as a fraction of total pages in
the relation) that VACUUM may scan and
fail to set all-frozen in the visibility map
before disabling eager scanning. A value of 0
disables eager scanning altogether. The default is
0.03 (3%).
Note that when eager scanning is enabled, only freeze failures count against the cap, not successful freezing. Successful page freezes are capped internally at 20% of the all-visible but not all-frozen pages in the relation. Capping successful page freezes helps amortize the overhead across multiple normal vacuums and limits the potential downside of wasted eager freezes of pages that are modified again before the next aggressive vacuum.
The setting can be overridden for individual tables by changing the corresponding table storage parameter. For more information on tuning vacuum's freezing behavior, see Section 24.1.5.
Compare versions
Complete source facts
documentation revision
{"inputs":[{"file":"runtime-config-vacuum.html","kind":"same-version-reviewed-manual","locale":"en","sha256":"599d3819c5fa60f160ba633df604ee9afd85549ffad2ae2fb0c3132a00d47417","version":"18.7"},{"file":"runtime-config-vacuum.html","kind":"same-version-reviewed-manual","locale":"zh-Hans","sha256":"b835e4b6c446cfdaf673750aba29ba28fc55ef6cc0c531558c1e394fdc05a140","version":"18.7"}],"release":"18.7","runtime_remeasured":false,"source_revision":"pgdoc:b9f0e7232f60f380d642ac9b99226606c254b552"}Source references
- PostgreSQL 18 English manual
- Related global parameter: vacuum_max_eager_freeze_failure_rate
- PostgreSQL 18 English manual
Full definition and evidence JSON
Definition sources
center · PostgreSQL 18 · eb6c2292fdf28e1b4635ab478eec3919411cdf4a6c07553387870e26201f3744
Text language: en · eb6c2292fdf28e1b4635ab478eec3919411cdf4a6c07553387870e26201f3744