From c2d35bb88eab99fd81198fa4caee004fb8997c73 Mon Sep 17 00:00:00 2001 From: David Rowley Date: Thu, 22 Jun 2023 12:45:30 +1200 Subject: [PATCH] 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 --- doc/src/sgml/ref/create_statistics.sgml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/src/sgml/ref/create_statistics.sgml b/doc/src/sgml/ref/create_statistics.sgml index 3a92fc55ede..d6b25ed2c9b 100644 --- a/doc/src/sgml/ref/create_statistics.sgml +++ b/doc/src/sgml/ref/create_statistics.sgml @@ -171,6 +171,12 @@ CREATE STATISTICS [ [ IF NOT EXISTS ] statistics_ maintenance. Expression statistics are built automatically for each expression in the statistics object definition. + + + 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 PostgreSQL. +