pgsql: Document autoanalyze limitations for partitioned tables

From: Tomas Vondra <tomas(dot)vondra(at)postgresql(dot)org>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Document autoanalyze limitations for partitioned tables
Date: 2022-03-28 13:02:33
Message-ID: E1nYp0y-001l33-Kh@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers

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

Branch
------
REL_10_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/c1e9cfaef9759442dde94f23275b4969b0a631b7

Modified Files
--------------
doc/src/sgml/maintenance.sgml | 29 +++++++++++++++++++++++++++++
doc/src/sgml/ref/analyze.sgml | 32 +++++++++++++++++++++++++++++---
2 files changed, 58 insertions(+), 3 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Peter Eisentraut 2022-03-28 13:32:55 pgsql: Preparatory test cleanup
Previous Message Tomas Vondra 2022-03-28 13:02:23 pgsql: Document autoanalyze limitations for partitioned tables