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:31:01 +0000 (14:31 +0200)
commit78ebfd885be563191d659d7a4ae230e199792e3f
tree36c9a73a09c328ff6aeb0d9ad077019dcf15cb1c
parent344d89abf36b9ea559a4b25543bbc7d4206988f5
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