aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Rowley <drowley@postgresql.org>2023-06-22 12:50:13 +1200
committerDavid Rowley <drowley@postgresql.org>2023-06-22 12:50:13 +1200
commitc909bd87ce09b00c15707c9420a01bfc8facad3f (patch)
tree222773166977b428aed0dcf32cc36f846dede9c0
parentb6311824f011d3ba03a6c5c1c0bbd7f31e27dbc6 (diff)
downloadpostgresql-c909bd87ce09b00c15707c9420a01bfc8facad3f.tar.gz
postgresql-c909bd87ce09b00c15707c9420a01bfc8facad3f.zip
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
-rw-r--r--doc/src/sgml/ref/create_statistics.sgml6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/src/sgml/ref/create_statistics.sgml b/doc/src/sgml/ref/create_statistics.sgml
index b43aaf142f5..9dfd9639596 100644
--- a/doc/src/sgml/ref/create_statistics.sgml
+++ b/doc/src/sgml/ref/create_statistics.sgml
@@ -127,6 +127,12 @@ CREATE STATISTICS [ IF NOT EXISTS ] <replaceable class="parameter">statistics_na
reading it. Once created, however, the ownership of the statistics
object is independent of the underlying table(s).
</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">