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:01:21
Message-ID: E1nYozo-001kzy-Hj@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
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/61fa6ca79b3c566f44831a33bb226f7358ed4511

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 Tomas Vondra 2022-03-28 13:01:36 pgsql: Document autoanalyze limitations for partitioned tables
Previous Message Peter Eisentraut 2022-03-28 09:20:12 pgsql: Make JSON path numeric literals more correct