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:00 +0000 (14:30 +0200)
commit61fa6ca79b3c566f44831a33bb226f7358ed4511
tree1f931e4dbe0cdd54ad0bc75ef3afb79221245c18
parente26114c817b610424010cfbe91a743f591246ff1
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