summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Rowley <drowley@postgresql.org>2023-06-22 12:47:53 +1200
committerDavid Rowley <drowley@postgresql.org>2023-06-22 12:47:53 +1200
commit8145b5e138c7f26594fb93e11e6ebd5bf2aba586 (patch)
treee2099cf99ceadfdf1714c7dca4bb7a0a667e1503
parent63fa0deb31c4b18a6dbf15fc8ff64ac010ea77b2 (diff)
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 e3e5c297ddb..a145c41f04b 100644
--- a/doc/src/sgml/ref/create_statistics.sgml
+++ b/doc/src/sgml/ref/create_statistics.sgml
@@ -167,6 +167,12 @@ CREATE STATISTICS [ IF NOT EXISTS ] <replaceable class="parameter">statistics_na
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">