Configuration parameter

autovacuum_analyze_scale_factor — PostgreSQL configuration parameter

Category Vacuuming Default 0 Change scope Sighup

Specifies a fraction of the table size to add to autovacuum_analyze_threshold when deciding whether to trigger an ANALYZE.

At a glance

Property Value
Parameter autovacuum_analyze_scale_factor
Category Vacuuming
Default 0.1
Value type floating point
Change scope Reload (postgresql.conf, SIGHUP)
Available in PostgreSQL 12, 13, 14, 15, 16, 17, 18, 19 (added in 12)

What it does

Specifies a fraction of the table size to add to autovacuum_analyze_threshold when deciding whether to trigger an ANALYZE. The default is 0.1 (10% of table size). This parameter can only be set in the postgresql.conf file or on the server command line; but the setting can be overridden for individual tables by changing table storage parameters.

(Description quoted from the official PostgreSQL documentation.)

How to apply a change

Set it in postgresql.conf (or with ALTER SYSTEM) and reload with SELECT pg_reload_conf(); or pg_ctl reload — no restart needed.

Inspect the current value and source with SHOW autovacuum_analyze_scale_factor; or SELECT name, setting, unit, context, source FROM pg_settings WHERE name = 'autovacuum_analyze_scale_factor';.

Tuning guidance

This parameter is rarely a performance lever. Leave it at the default unless you have a specific, documented reason to change it, change it on one session or one role/database first, and confirm the effect with pg_settings and your own measurements before rolling it out cluster-wide.

Reference

PostgreSQL documentation — autovacuum_analyze_scale_factor.

Keep going

Related & next steps

Was this helpful?

← All configuration parameters