database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-10-16 17:07:43 +03:00
Code Activity

Doc: clarify n_distinct_inherited setting

Browse Source 
There was some confusion around how to adjust the n_distinct estimates
for partitioned tables.  Here we try and clarify that
n_distinct_inherited needs to be adjusted rather than n_distinct.

Also fix some slightly misleading text which was talking about table
size rather than table rows, fix a grammatical error, and adjust some
text which indicated that ANALYZE was performing calculations based on
the n_distinct settings.  Really it's the query planner that does this
and ANALYZE only stores the overridden n_distinct estimate value in
pg_statistic.

Author: David Rowley <dgrowleyml@gmail.com>
Reviewed-by: David G. Johnston <david.g.johnston@gmail.com>
Reviewed-by: Chao Li <li.evan.chao@gmail.com>
Backpatch-through: 13
Discussion: https://postgr.es/m/CAApHDvrL7a-ZytM1SP8Uk9nEw9bR2CPzVb+uP+bcNj=_q-ZmVw@mail.gmail.com
This commit is contained in:
David Rowley
2025-10-14 09:27:38 +13:00
parent af302ff6b8
commit c3b9e56513
1 changed files with 16 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
doc/src/sgml/ref/alter_table.sgml
View File

@@ -328,24 +328,22 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
<literal>n_distinct_inherited</literal>, which override the <literal>n_distinct_inherited</literal>, which override the
number-of-distinct-values estimates made by subsequent number-of-distinct-values estimates made by subsequent
<xref linkend="sql-analyze"/> <xref linkend="sql-analyze"/>
operations. <literal>n_distinct</literal> affects the statistics for the table operations. <literal>n_distinct</literal> affects the statistics for the
itself, while <literal>n_distinct_inherited</literal> affects the statistics table itself, while <literal>n_distinct_inherited</literal> affects the
gathered for the table plus its inheritance children. When set to a statistics gathered for the table plus its inheritance children, and for
positive value, <command>ANALYZE</command> will assume that the column contains the statistics gathered for partitioned tables. When the value
exactly the specified number of distinct nonnull values. When set to a specified is a positive value, the query planner will assume that the
negative value, which must be greater column contains exactly the specified number of distinct nonnull values.
than or equal to -1, <command>ANALYZE</command> will assume that the number of Fractional values may also be specified by using values below 0 and
distinct nonnull values in the column is linear in the size of the above or equal to -1. This instructs the query planner to estimate the
table; the exact count is to be computed by multiplying the estimated number of distinct values by multiplying the absolute value of the
table size by the absolute value of the given number. For example, specified number by the estimated number of rows in the table. For
a value of -1 implies that all values in the column are distinct, while example, a value of -1 implies that all values in the column are
a value of -0.5 implies that each value appears twice on the average. distinct, while a value of -0.5 implies that each value appears twice on
This can be useful when the size of the table changes over time, since average. This can be useful when the size of the table changes over
the multiplication by the number of rows in the table is not performed time. For more information on the use of statistics by the
until query planning time. Specify a value of 0 to revert to estimating <productname>PostgreSQL</productname> query planner, refer to
the number of distinct values normally. For more information on the use <xref linkend="planner-stats"/>.
of statistics by the <productname>PostgreSQL</productname> query
planner, refer to <xref linkend="planner-stats"/>.
</para> </para>
<para> <para>
Changing per-attribute options acquires a Changing per-attribute options acquires a