Doc: mention that extended stats aren't used for joins

Statistics defined by the CREATE STATISTICS command are only used to
assist with the selectivity estimations of base relations, never for
joins.  Here we mention this fact in the notes section of the CREATE
STATISTICS command.

Discussion: https://postgr.es/m/CAApHDvrMuVgDOrmg_EtFDZ=AOovq6EsJNnHH1ddyZ8EqL4yzMw@mail.gmail.com
Backpatch-through: 11
This commit is contained in:
David Rowley 2023-06-22 12:45:30 +12:00
parent 5f0762f147
commit c2d35bb88e
1 changed files with 6 additions and 0 deletions

View File

@ -171,6 +171,12 @@ CREATE STATISTICS [ [ IF NOT EXISTS ] <replaceable class="parameter">statistics_
maintenance. Expression statistics are built automatically for each
expression in the statistics object definition.
</para>
<para>
Extended statistics are not currently used by the planner for selectivity
estimations made for table joins. This limitation will likely be removed
in a future version of <productname>PostgreSQL</productname>.
</para>
</refsect1>
<refsect1 id="sql-createstatistics-examples">