postgresql/contrib
Tom Lane efc77cf5f1 Fix intarray's GiST opclasses to not fail for empty arrays with <@.
contrib/intarray considers "arraycol <@ constant-array" to be indexable,
but its GiST opclass code fails to reliably find index entries for empty
array values (which of course should trivially match such queries).
This is because the test condition to see whether we should descend
through a non-leaf node is wrong.

Unfortunately, empty array entries could be anywhere in the index,
as these index opclasses are currently designed.  So there's no way
to fix this except by lobotomizing <@ indexscans to scan the whole
index ... which is what this patch does.  That's pretty unfortunate:
the performance is now actually worse than a seqscan, in most cases.
We'd be better off to remove <@ from the GiST opclasses entirely,
and perhaps a future non-back-patchable patch will do so.

In the meantime, applications whose performance is adversely impacted
have a couple of options.  They could switch to a GIN index, which
doesn't have this bug, or they could replace "arraycol <@ constant-array"
with "arraycol <@ constant-array AND arraycol && constant-array".
That will provide about the same performance as before, and it will find
all non-empty subsets of the given constant-array, which is all that
could reliably be expected of the query before.

While at it, add some more regression test cases to improve code
coverage of contrib/intarray.

In passing, adjust resize_intArrayType so that when it's returning an
empty array, it uses construct_empty_array for that rather than
cowboy hacking on the input array.  While the hack produces an array
that looks valid for most purposes, it isn't bitwise equal to empty
arrays produced by other code paths, which could have subtle odd
effects.  I don't think this code path is performance-critical
enough to justify such shortcuts.  (Back-patch this part only as far
as v11; before commit 01783ac36 we were not careful about this in
other intarray code paths either.)

Back-patch the <@ fixes to all supported versions, since this was
broken from day one.

Patch by me; thanks to Alexander Korotkov for review.

Discussion: https://postgr.es/m/458.1565114141@sss.pgh.pa.us
2019-08-06 18:04:51 -04:00
..
adminpack Update copyright for 2019 2019-01-02 12:44:25 -05:00
amcheck Don't rely on estimates for amcheck Bloom filters. 2019-07-20 11:11:55 -07:00
auth_delay Update copyright for 2019 2019-01-02 12:44:25 -05:00
auto_explain Fix contrib/auto_explain to not cause problems in parallel workers. 2019-06-03 18:06:04 -04:00
bloom Fix many typos and inconsistencies 2019-07-01 10:00:23 +09:00
btree_gin Provide separate header file for built-in float types 2018-07-29 03:30:48 +02:00
btree_gist Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
citext Fix typos in various places 2019-06-03 13:44:03 +09:00
cube Fix inconsistencies and typos in the tree 2019-07-16 13:23:53 +09:00
dblink Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
dict_int Update copyright for 2019 2019-01-02 12:44:25 -05:00
dict_xsyn Update copyright for 2019 2019-01-02 12:44:25 -05:00
earthdistance Fix earthdistance test suite function name typo. 2018-07-29 12:02:07 -07:00
file_fdw Represent Lists as expansible arrays, not chains of cons-cells. 2019-07-15 13:41:58 -04:00
fuzzystrmatch Update copyright for 2019 2019-01-02 12:44:25 -05:00
hstore Move hash_any prototype from access/hash.h to utils/hashutils.h 2019-03-11 13:17:50 -03:00
hstore_plperl Clean up PL/Perl's handling of the _() macro. 2019-06-02 12:23:39 -04:00
hstore_plpython Avoid Python memory leaks in hstore_plpython and jsonb_plpython. 2019-04-06 17:54:29 -04:00
intagg Schema-qualify some references to regprocedure. 2016-06-10 10:41:58 -04:00
intarray Fix intarray's GiST opclasses to not fail for empty arrays with <@. 2019-08-06 18:04:51 -04:00
isn Update copyright for 2019 2019-01-02 12:44:25 -05:00
jsonb_plperl Fix handling of "undef" in contrib/jsonb_plperl. 2019-08-04 14:05:34 -04:00
jsonb_plpython Fix more typos and inconsistencies in the tree 2019-06-17 16:13:16 +09:00
lo lo: Add test suite 2017-09-14 22:22:59 -04:00
ltree Fix inconsistencies and typos in the tree 2019-07-16 13:23:53 +09:00
ltree_plpython Fix out-of-tree build for transform modules. 2018-09-16 18:46:45 +01:00
oid2name Replace @postgresql.org with @lists.postgresql.org for mailinglists 2019-01-19 19:06:35 +01:00
pageinspect Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
passwordcheck Fix handling of previous password hooks in passwordcheck 2019-08-01 09:37:28 +09:00
pg_buffercache Remove WITH OIDS support, change oid catalog column visibility. 2018-11-20 16:00:17 -08:00
pg_freespacemap Replace heapam.h includes with {table, relation}.h where applicable. 2019-01-21 10:51:37 -08:00
pg_prewarm Fix more typos and inconsistencies in the tree 2019-06-17 16:13:16 +09:00
pg_standby Fix inconsistencies and typos in the tree, take 9 2019-08-05 12:14:58 +09:00
pg_stat_statements pg_stat_statements: add missing check for pgss_enabled(). 2019-07-19 13:38:55 -07:00
pg_trgm Represent Lists as expansible arrays, not chains of cons-cells. 2019-07-15 13:41:58 -04:00
pg_visibility Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
pgcrypto Fix inconsistencies and typos in the tree, take 9 2019-08-05 12:14:58 +09:00
pgrowlocks Only allow heap in a number of contrib modules. 2019-04-01 14:57:21 -07:00
pgstattuple Fix inconsistencies and typos in the tree 2019-07-16 13:23:53 +09:00
postgres_fdw Fix inconsistencies and typos in the tree, take 9 2019-08-05 12:14:58 +09:00
seg Change floating-point output format for improved performance. 2019-02-13 15:20:33 +00:00
sepgsql Fix inconsistencies and typos in the tree, take 9 2019-08-05 12:14:58 +09:00
spi Fix more strcmp() calls using boolean-like comparisons for result checks 2019-04-12 10:16:49 +09:00
sslinfo Phase 3 of pgindent updates. 2017-06-21 15:35:54 -04:00
start-scripts Remove contrib/start-scripts/osx/. 2017-11-17 12:53:20 -05:00
tablefunc Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
tcn Update copyright for 2019 2019-01-02 12:44:25 -05:00
test_decoding Fix inconsistencies and typos in the tree, take 9 2019-08-05 12:14:58 +09:00
tsm_system_rows Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
tsm_system_time Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
unaccent Add combining characters to unaccent.rules. 2019-02-01 15:23:01 +01:00
uuid-ossp Update copyright for 2019 2019-01-02 12:44:25 -05:00
vacuumlo Fix copy-pasto in freeing memory on error in vacuumlo. 2019-06-07 12:42:27 +03:00
xml2 Phase 2 pgindent run for v12. 2019-05-22 13:04:48 -04:00
Makefile Transforms for jsonb to PL/Perl 2018-04-03 09:47:18 -04: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.