postgresql/contrib
Alvaro Herrera 7516f52594 BRIN: Block Range Indexes
BRIN is a new index access method intended to accelerate scans of very
large tables, without the maintenance overhead of btrees or other
traditional indexes.  They work by maintaining "summary" data about
block ranges.  Bitmap index scans work by reading each summary tuple and
comparing them with the query quals; all pages in the range are returned
in a lossy TID bitmap if the quals are consistent with the values in the
summary tuple, otherwise not.  Normal index scans are not supported
because these indexes do not store TIDs.

As new tuples are added into the index, the summary information is
updated (if the block range in which the tuple is added is already
summarized) or not; in the latter case, a subsequent pass of VACUUM or
the brin_summarize_new_values() function will create the summary
information.

For data types with natural 1-D sort orders, the summary info consists
of the maximum and the minimum values of each indexed column within each
page range.  This type of operator class we call "Minmax", and we
supply a bunch of them for most data types with B-tree opclasses.
Since the BRIN code is generalized, other approaches are possible for
things such as arrays, geometric types, ranges, etc; even for things
such as enum types we could do something different than minmax with
better results.  In this commit I only include minmax.

Catalog version bumped due to new builtin catalog entries.

There's more that could be done here, but this is a good step forwards.

Loosely based on ideas from Simon Riggs; code mostly by Álvaro Herrera,
with contribution by Heikki Linnakangas.

Patch reviewed by: Amit Kapila, Heikki Linnakangas, Robert Haas.
Testing help from Jeff Janes, Erik Rijkers, Emanuel Calvo.

PS:
  The research leading to these results has received funding from the
  European Union's Seventh Framework Programme (FP7/2007-2013) under
  grant agreement n° 318633.
2014-11-07 16:38:14 -03:00
..
adminpack Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
auth_delay Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
auto_explain Print planning time only in EXPLAIN ANALYZE, not plain EXPLAIN. 2014-10-15 18:50:13 -04:00
btree_gin Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
btree_gist Support timezone abbreviations that sometimes change. 2014-10-16 15:22:10 -04:00
chkpass Fix volatility markings of some contrib I/O functions. 2014-11-05 11:34:11 -05:00
citext Fix citext upgrade script for disallowance of oidvector element assignment. 2014-08-28 18:21:05 -04:00
cube Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
dblink Specify the port in dblink and postgres_fdw tests. 2014-08-26 12:28:08 +02:00
dict_int Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
dict_xsyn Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
dummy_seclabel Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
earthdistance Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
file_fdw Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
fuzzystrmatch Define META_FREE in a way that doesn't cause -Wempty-body warnings. 2014-09-26 02:55:38 +02:00
hstore Switch to CRC-32C in WAL and other places. 2014-11-04 11:39:48 +02:00
intagg Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
intarray Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
isn Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
lo Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
ltree Fix volatility markings of some contrib I/O functions. 2014-11-05 11:34:11 -05:00
oid2name Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
pageinspect BRIN: Block Range Indexes 2014-11-07 16:38:14 -03:00
passwordcheck Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
pg_archivecleanup Replace a few strncmp() calls with strlcpy(). 2014-08-18 22:59:31 -04:00
pg_buffercache Make backend local tracking of buffer pins memory efficient. 2014-08-30 14:03:21 +02:00
pg_freespacemap Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
pg_prewarm Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
pg_standby Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
pg_stat_statements Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
pg_test_fsync pg_test_fsync: Update output format 2014-10-20 15:36:51 -04:00
pg_test_timing Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
pg_trgm Fix volatility markings of some contrib I/O functions. 2014-11-05 11:34:11 -05:00
pg_upgrade pg_upgrade: prefix Unix shell script name output with "./" 2014-10-11 18:38:41 -04:00
pg_upgrade_support pg_upgrade: prevent automatic oid assignment 2014-08-25 22:19:05 -04:00
pg_xlogdump BRIN: Block Range Indexes 2014-11-07 16:38:14 -03:00
pgbench Add --latency-limit option to pgbench. 2014-10-13 20:50:24 +03:00
pgcrypto Docs: fix incorrect spelling of contrib/pgcrypto option. 2014-11-03 11:11:34 -05:00
pgrowlocks Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
pgstattuple Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
postgres_fdw Specify the port in dblink and postgres_fdw tests. 2014-08-26 12:28:08 +02:00
seg Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
sepgsql Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
spi Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
sslinfo Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
start-scripts doc: Reflect renaming of Mac OS X to OS X 2014-09-09 13:56:29 -04:00
tablefunc Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
tcn Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
test_decoding Improve documentation about binary/textual output mode for output plugins. 2014-10-01 13:22:17 +02:00
test_parser Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
test_shm_mq Add some noreturn attributes based on compiler recommendations 2014-08-13 22:40:48 -04:00
tsearch2 Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
unaccent Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
uuid-ossp Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
vacuumlo Add file version information to most installed Windows binaries. 2014-07-14 14:07:52 -04:00
worker_spi Add some noreturn attributes based on compiler recommendations 2014-08-13 22:40:48 -04:00
xml2 Fix typos in some error messages thrown by extension scripts when fed to psql. 2014-08-25 18:30:37 +02:00
contrib-global.mk Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
Makefile Support BSD and e2fsprogs UUID libraries alongside OSSP UUID library. 2014-05-27 19:42:08 -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.