doc: document the need to analyze partitioned tables

Autovacuum does not do it.

Reported-by: Justin Pryzby

Discussion: https://postgr.es/m/20210913035409.GA10647@telsasoft.com

Backpatch-through: 11
This commit is contained in:
Bruce Momjian 2023-10-10 15:14:19 -04:00
parent ef74c7197c
commit 7454502f94
1 changed files with 9 additions and 4 deletions

View File

@ -861,10 +861,15 @@ analyze threshold = analyze base threshold + analyze scale factor * number of tu
</para>
<para>
Partitioned tables are not processed by autovacuum. Statistics
should be collected by running a manual <command>ANALYZE</command> when it is
first populated, and again whenever the distribution of data in its
partitions changes significantly.
Partitioned tables do not directly store tuples and consequently
are not processed by autovacuum. (Autovacuum does process table
partitions just like other tables.) Unfortunately, this means that
autovacuum does not run <command>ANALYZE</command> on partitioned
tables, and this can cause suboptimal plans for queries that reference
partitioned table statistics. You can work around this problem by
manually running <command>ANALYZE</command> on partitioned tables
when they are first populated, and again whenever the distribution
of data in their partitions changes significantly.
</para>
<para>