Document autoanalyze limitations for partitioned tables
authorTomas Vondra <tomas.vondra@postgresql.org>
Mon, 28 Mar 2022 12:27:36 +0000 (14:27 +0200)
committerTomas Vondra <tomas.vondra@postgresql.org>
Mon, 28 Mar 2022 12:30:44 +0000 (14:30 +0200)
commit6b262f353ef710704a9388d32924b8c10c7e6eaa
tree3755e025efb9a51e30f6b7a9cebb5f084b37eeef
parentc1a0d7d1c4b77d978fe93edc0889589148cbad23
Document autoanalyze limitations for partitioned tables

When dealing with partitioned tables, counters for partitioned tables
are not updated when modifying child tables. This means autoanalyze may
not update optimizer statistics for the parent relations, which can
result in poor plans for some queries.

It's worth documenting this limitation, so that people are aware of it
and can take steps to mitigate it (e.g. by setting up a script executing
ANALYZE regularly).

Backpatch to v10. Older branches are affected too, of couse, but we no
longer maintain those.

Author: Justin Pryzby
Reviewed-by: Zhihong Yu, Tomas Vondra
Backpatch-through: 10
Discussion: https://postgr.es/m/20210913035409.GA10647%40telsasoft.com
doc/src/sgml/maintenance.sgml
doc/src/sgml/ref/analyze.sgml