postgresql/contrib
Tom Lane 733f20df53 Discount the metapage when estimating number of index pages visited.
genericcostestimate() estimates the number of index leaf pages to
be visited as a pro-rata fraction of the total number of leaf pages.
Or at least that was the intention.  What it actually used in the
calculation was the total number of index pages, so that non-leaf
pages were also counted.  In a decent-sized index the error is
probably small, since we expect upper page fanout to be high.
But in a small index that's not true; in the worst case with one
data-bearing page plus a metapage, we had 100% relative error.
This led to surprising planning choices such as not using a small
partial index.

To fix, ask genericcostestimate's caller to supply an estimate of
the number of non-leaf pages, and subtract that.  For the built-in
index AMs, it seems sufficient to count the index metapage (if the
AM uses one) as non-leaf.  Per the above argument, counting upper
index pages shouldn't change the estimate much, and in most cases
we don't have any easy way of estimating the number of upper pages.
This might be an area for further research in future.

Any external genericcostestimate callers that do not set the new field
GenericCosts.numNonLeafPages will see the same behavior as before,
assuming they followed the advice to zero out that whole struct.

Unsurprisingly, this change affects a number of plans seen in the
core regression tests.  I hacked up the existing tests to keep the
tests' plans the same, since in each case it appeared that the
test's intent was to test exactly that plan.  Also add one new
test case demonstrating that a better index choice is now made.

Author: Tom Lane <tgl@sss.pgh.pa.us>
Reviewed-by: Henson Choi <assam258@gmail.com>
Discussion: https://postgr.es/m/870521.1745860752@sss.pgh.pa.us
2026-03-20 14:50:53 -04:00
..
amcheck Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
auth_delay Update copyright for 2026 2026-01-01 13:24:10 -05:00
auto_explain instrumentation: Keep time fields as instrtime, convert in callers 2026-01-09 13:38:00 -05:00
basebackup_to_shell Update copyright for 2026 2026-01-01 13:24:10 -05:00
basic_archive basic_archive: Allow archive directory to be missing at startup. 2026-03-02 13:12:25 -06:00
bloom Discount the metapage when estimating number of index pages visited. 2026-03-20 14:50:53 -04:00
bool_plperl Update copyright for 2026 2026-01-01 13:24:10 -05:00
btree_gin Use fallthrough attribute instead of comment 2026-02-19 08:51:12 +01:00
btree_gist Improve type handling of varlena structures 2026-02-11 07:33:24 +09:00
citext Update copyright for 2026 2026-01-01 13:24:10 -05:00
cube Mark commented out code as unused 2026-01-22 12:44:07 +01:00
dblink Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
dict_int Update copyright for 2026 2026-01-01 13:24:10 -05:00
dict_xsyn Replace pg_mblen() with bounds-checked versions. 2026-02-09 12:44:04 +13:00
earthdistance Update copyright for 2026 2026-01-01 13:24:10 -05:00
file_fdw file_fdw: Add regression test for file_fdw with ON_ERROR='set_null' 2026-03-16 12:13:11 +09:00
fuzzystrmatch fuzzystrmatch: use pg_ascii_toupper(). 2026-01-12 08:54:04 -08:00
hstore Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
hstore_plperl Change StaticAssertVariableIsOfType to be a declaration 2026-02-03 08:46:02 +01:00
hstore_plpython Change StaticAssertVariableIsOfType to be a declaration 2026-02-03 08:46:02 +01:00
intagg Update copyright for 2026 2026-01-01 13:24:10 -05:00
intarray Harden _int_matchsel() against being attached to the wrong operator. 2026-02-09 10:14:22 -05:00
isn Fix additional fallthrough warnings from clang 2026-02-23 07:40:19 +01:00
jsonb_plperl Update copyright for 2026 2026-01-01 13:24:10 -05:00
jsonb_plpython Change StaticAssertVariableIsOfType to be a declaration 2026-02-03 08:46:02 +01:00
lo Update copyright for 2026 2026-01-01 13:24:10 -05:00
ltree Fix more multibyte issues in ltree. 2026-02-26 12:23:22 -08:00
ltree_plpython Change StaticAssertVariableIsOfType to be a declaration 2026-02-03 08:46:02 +01:00
oid2name Use pg_malloc_object() and pg_alloc_array() variants in frontend code 2026-02-27 18:59:41 +09:00
pageinspect Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
passwordcheck Update copyright for 2026 2026-01-01 13:24:10 -05:00
pg_buffercache Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
pg_freespacemap Update copyright for 2026 2026-01-01 13:24:10 -05:00
pg_logicalinspect Update copyright for 2026 2026-01-01 13:24:10 -05:00
pg_overexplain SQL Property Graph Queries (SQL/PGQ) 2026-03-16 10:14:18 +01:00
pg_plan_advice pg_plan_advice: Fix multiple copy-and-paste-errors in test case. 2026-03-18 18:24:39 -04:00
pg_prewarm Don't include wait_event.h in pgstat.h 2026-03-06 16:24:58 +01:00
pg_stat_statements Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
pg_surgery Update copyright for 2026 2026-01-01 13:24:10 -05:00
pg_trgm Fix local-variable shadowing in pg_trgm's printSourceNFA(). 2026-03-02 14:40:29 -05:00
pg_visibility Add all required calls to TupleDescFinalize() 2026-03-16 11:45:49 +13:00
pg_walinspect Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
pgcrypto Use fallthrough attribute instead of comment 2026-02-19 08:51:12 +01:00
pgrowlocks Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
pgstattuple pgstattuple: Optimize pgstattuple_approx() with streaming read 2026-03-14 15:06:13 +09:00
postgres_fdw ALTER SUBSCRIPTION ... SERVER test. 2026-03-18 10:15:51 -07:00
seg Mark commented out code as unused 2026-01-22 12:44:07 +01:00
sepgsql Update copyright for 2026 2026-01-01 13:24:10 -05:00
spi Update copyright for 2026 2026-01-01 13:24:10 -05:00
sslinfo Update copyright for 2026 2026-01-01 13:24:10 -05:00
start-scripts Remove gratuitous references to postmaster program 2023-01-26 10:48:32 +01:00
tablefunc Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
tcn Update copyright for 2026 2026-01-01 13:24:10 -05:00
test_decoding Standardize replication origin naming to use "ReplOrigin". 2026-01-28 11:03:29 -08:00
tsm_system_rows Update copyright for 2026 2026-01-01 13:24:10 -05:00
tsm_system_time Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
unaccent Update Unicode data to Unicode 17.0.0 2026-03-20 08:42:50 +01:00
uuid-ossp Fix accidentally cast away qualifiers 2026-01-26 16:02:31 +01:00
vacuumlo Update copyright for 2026 2026-01-01 13:24:10 -05:00
xml2 Reduce header inclusions via execnodes.h 2026-03-16 14:34:57 +01:00
contrib-global.mk Respect TEMP_CONFIG when pg_regress_check and friends are called 2016-02-27 12:28:21 -05:00
Makefile Add pg_plan_advice contrib module. 2026-03-12 13:00:43 -04:00
meson.build Add pg_plan_advice contrib module. 2026-03-12 13:00:43 -04:00
README Rename 'gmake' to 'make' in docs and recommended commands 2014-02-12 17:29:19 -05:00

The PostgreSQL contrib tree
---------------------------

This subtree contains porting tools, analysis utilities, and plug-in
features that are not part of the core PostgreSQL system, mainly
because they address a limited audience or are too experimental to be
part of the main source tree.  This does not preclude their
usefulness.

User documentation for each module appears in the main SGML
documentation.

When building from the source distribution, these modules are not
built automatically, unless you build the "world" target.  You can
also build and install them all by running "make all" and "make
install" in this directory; or to build and install just one selected
module, do the same in that module's subdirectory.

Some directories supply new user-defined functions, operators, or
types.  To make use of one of these modules, after you have installed
the code you need to register the new SQL objects in the database
system by executing a CREATE EXTENSION command.  In a fresh database,
you can simply do

    CREATE EXTENSION module_name;

See the PostgreSQL documentation for more information about this
procedure.