postgresql/contrib
Robert Haas 293e24e507 Cache hash index's metapage in rel->rd_amcache.
This avoids a very significant amount of buffer manager traffic and
contention when scanning hash indexes, because it's no longer
necessary to lock and pin the metapage for every scan.  We do need
some way of figuring out when the cache is too stale to use any more,
so that when we lock the primary bucket page to which the cached
metapage points us, we can tell whether a split has occurred since we
cached the metapage data.  To do that, we use the hash_prevblkno field
in the primary bucket page, which would otherwise always be set to
InvalidBuffer.

This patch contains code so that it will continue working (although
less efficiently) with hash indexes built before this change, but
perhaps we should consider bumping the hash version and ripping out
the compatibility code.  That decision can be made later, though.

Mithun Cy, reviewed by Jesper Pedersen, Amit Kapila, and by me.
Before committing, I made a number of cosmetic changes to the last
posted version of the patch, adjusted _hash_getcachedmetap to be more
careful about order of operation, and made some necessary updates to
the pageinspect documentation and regression tests.
2017-02-07 12:35:45 -05:00
..
adminpack Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
auth_delay Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
auto_explain Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
bloom Fix typos in comments. 2017-02-06 11:33:58 +02:00
btree_gin Test all contrib-created operator classes with amvalidate. 2016-11-29 15:05:22 -05:00
btree_gist Generate fmgr prototypes automatically 2017-01-17 14:06:07 -05:00
chkpass Further cleanup from the strong-random patch. 2016-12-12 11:55:32 +02:00
citext Move some things from builtins.h to new header files 2017-01-20 20:29:53 -05:00
cube Fix typos in comments. 2017-02-06 11:33:58 +02:00
dblink Move some things from builtins.h to new header files 2017-01-20 20:29:53 -05:00
dict_int Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
dict_xsyn Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
earthdistance Fix typos in comments. 2017-02-06 11:33:58 +02:00
file_fdw Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
fuzzystrmatch Move some things from builtins.h to new header files 2017-01-20 20:29:53 -05:00
hstore Test all contrib-created operator classes with amvalidate. 2016-11-29 15:05:22 -05:00
hstore_plperl Code review for avoidance of direct cross-module links. 2017-02-02 11:21:16 -05:00
hstore_plpython Code review for avoidance of direct cross-module links. 2017-02-02 11:21:16 -05:00
intagg Schema-qualify some references to regprocedure. 2016-06-10 10:41:58 -04:00
intarray Generate fmgr prototypes automatically 2017-01-17 14:06:07 -05:00
isn Fix typos in comments. 2017-02-06 11:33:58 +02:00
lo Generate fmgr prototypes automatically 2017-01-17 14:06:07 -05:00
ltree Fix typos in comments. 2017-02-06 11:33:58 +02:00
ltree_plpython Code review for avoidance of direct cross-module links. 2017-02-02 11:21:16 -05:00
oid2name Simplify correct use of simple_prompt(). 2016-08-30 17:02:02 -04:00
pageinspect Cache hash index's metapage in rel->rd_amcache. 2017-02-07 12:35:45 -05:00
passwordcheck Replace isMD5() with a more future-proof way to check if pw is encrypted. 2017-02-01 13:11:37 +02:00
pg_buffercache Don't bother to lock bufmgr partitions in pg_buffercache. 2016-09-29 13:16:30 +03:00
pg_freespacemap Update pg_freespacemap extension for parallel query. 2016-06-09 17:18:16 -04:00
pg_prewarm Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
pg_standby Fix typos in comments. 2017-02-06 11:33:58 +02:00
pg_stat_statements Fix typos in comments. 2017-02-06 11:33:58 +02:00
pg_trgm Fix typos in comments. 2017-02-06 11:33:58 +02:00
pg_visibility Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
pgcrypto Fix typos in comments. 2017-02-06 11:33:58 +02:00
pgrowlocks Move some things from builtins.h to new header files 2017-01-20 20:29:53 -05:00
pgstattuple pgstattuple: Add pgstathashindex. 2017-02-03 14:37:16 -05:00
postgres_fdw Fix typos in comments. 2017-02-06 11:33:58 +02:00
seg Fix typos in comments. 2017-02-06 11:33:58 +02:00
sepgsql Fix typo also in expected output. 2017-02-06 12:04:04 +02:00
spi Fix typos in comments. 2017-02-06 11:33:58 +02:00
sslinfo Support OpenSSL 1.1.0. 2016-09-15 14:42:29 +03:00
start-scripts Fix typos in comments. 2017-02-06 11:33:58 +02:00
tablefunc Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
tcn Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
test_decoding Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
tsearch2 Fix typos in comments. 2017-02-06 11:33:58 +02:00
tsm_system_rows Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
tsm_system_time Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
unaccent Move some things from builtins.h to new header files 2017-01-20 20:29:53 -05:00
uuid-ossp Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
vacuumlo Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
xml2 Fix typos in comments. 2017-02-06 11:33:58 +02:00
Makefile Bloom index contrib module 2016-04-01 16:42:24 +03:00
README Rename 'gmake' to 'make' in docs and recommended commands 2014-02-12 17:29:19 -05:00
contrib-global.mk Respect TEMP_CONFIG when pg_regress_check and friends are called 2016-02-27 12:28:21 -05:00

README

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.