Enables or disables the query planner’s use of incremental sort steps.
At a glance
| Property | Value |
|---|---|
| Parameter | enable_incremental_sort |
| Category | Query Planning |
| Default | on |
| Value type | boolean (on/off) |
| Change scope | Per-session (SET) |
| Available in | PostgreSQL 13, 14, 15, 16, 17, 18, 19 (added in 13) |
What it does
Enables or disables the query planner’s use of incremental sort steps. The default is on.
(Description quoted from the official PostgreSQL documentation.)
How to apply a change
Can be set per session with SET, per role/database with ALTER ROLE/DATABASE ... SET, or globally in postgresql.conf.
Inspect the current value and source with SHOW enable_incremental_sort; or SELECT name, setting, unit, context, source FROM pg_settings WHERE name = 'enable_incremental_sort';.
Tuning guidance
This is a diagnostic switch, not a production tuning knob. Turn it off briefly (per session) to confirm why the planner avoids or prefers a plan, then leave it on. Forcing it off in production masks bad estimates instead of fixing them — fix statistics, costs or indexes instead.