gin_hstore_bytea_ops - non collation-aware version of default hstore GIN index.

Author: akorotkov

Makefile

@@ -4,7 +4,7 @@ MODULE_big = hstore_ops
 OBJS = hstore_compat.o hstore_ops.o
 
 EXTENSION = hstore_ops
-DATA = hstore_ops--1.0.sql
+DATA = hstore_ops--1.1.sql hstore_ops--1.0--1.1.sql
 
 REGRESS = hstore_ops
 

README.md

@@ -2,9 +2,9 @@ hstore_ops - better operator class for hstore
 =============================================
 
 hstore_ops extension provides another implementation of GIN index (opclass)
-for hstore. It provides smaller index and faster @> operator queries than
-default GIN opclass. However, queries containing ?, ?|, ?& operators could
-become a little slower.
+for hstore - gin_hstore_hash_ops. It provides smaller index and faster @>
+operator queries than default GIN opclass. However, queries containing ?,
+?|, ?& operators could become a bit slower.
 
 Idea of this opclass is to use composite GIN key which consists of hashes
 of hstore key and value. Thus, search for @> operator is possible as simple
@@ -14,6 +14,12 @@ every kind of search, because of possible hash collision. Hashing provides
 small size of index, mixing key and value into same GIN key provides high
 performance for @> search operator.
 
+Also hstore_ops extension contains gin_hstore_bytea_ops - variation of
+standard GIN opclass for hstore where collation key comparison is replaced
+with per-byte comparison. This change doesn't affect any functionality,
+just makes index work faster when collation comparison is slow.
+gin_hstore_bytea_ops was introduced in version 1.1.
+
 Authors
 -------
 
@@ -52,12 +58,17 @@ Typical installation procedure may look like this:
     $ make USE_PGXS=1 installcheck
     $ psql DB -c "CREATE EXTENSION hstore_ops;"
 
+If you used hstore_ops 1.0 then replace last command to upgrade to 1.1.
+
+    $ psql DB -c "ALTER EXTENSION hstore_ops UPDATE TO '1.1';"
+
 Usage
 -----
 
-Just create index on hstore column using following command.
+Just create index on hstore column using one of following commands.
 
     CREATE INDEX index_name ON table_name USING GIN (column_name gin_hstore_hash_ops);
+    CREATE INDEX index_name ON table_name USING GIN (column_name gin_hstore_bytea_ops);
 
 Index will be automatically used for search on @>, ?, ?|, ?& operators on this
 column.

hstore_ops--1.0--1.1.sql

@@ -0,0 +1,17 @@
+/* contrib/hstore_ops/hstore_ops--1.0--1.1.sql */
+
+-- complain if script is sourced in psql, rather than via ALTER EXTENSION
+\echo Use "ALTER EXTENSION hstore_ops UPDATE TO '1.1'" to load this file. \quit
+
+CREATE OPERATOR CLASS gin_hstore_bytea_ops
+FOR TYPE hstore USING gin
+AS
+	OPERATOR        7       @>,
+	OPERATOR        9       ?(hstore,text),
+	OPERATOR        10      ?|(hstore,text[]),
+	OPERATOR        11      ?&(hstore,text[]),
+	FUNCTION        1       byteacmp(bytea,bytea),
+	FUNCTION        2       gin_extract_hstore(internal, internal),
+	FUNCTION        3       gin_extract_hstore_query(internal, internal, int2, internal, internal),
+	FUNCTION        4       gin_consistent_hstore(internal, int2, internal, int4, internal, internal),
+	STORAGE         bytea;

hstore_ops--1.0.sql renamed to hstore_ops--1.1.sql

@@ -1,4 +1,4 @@
-/* contrib/hstore/hstore_ops--1.0.sql */
+/* contrib/hstore_ops/hstore_ops--1.1.sql */
 
 -- complain if script is sourced in psql, rather than via CREATE EXTENSION
 \echo Use "CREATE EXTENSION hstore_ops" to load this file. \quit
@@ -41,3 +41,16 @@ AS
 	FUNCTION        4       gin_consistent_hstore_hash(internal, int2, internal, int4, internal, internal),
 	FUNCTION        5       gin_compare_partial_hstore_hash(int8, int8, int2, internal),
 	STORAGE         int8;
+
+CREATE OPERATOR CLASS gin_hstore_bytea_ops
+FOR TYPE hstore USING gin
+AS
+	OPERATOR        7       @>,
+	OPERATOR        9       ?(hstore,text),
+	OPERATOR        10      ?|(hstore,text[]),
+	OPERATOR        11      ?&(hstore,text[]),
+	FUNCTION        1       byteacmp(bytea,bytea),
+	FUNCTION        2       gin_extract_hstore(internal, internal),
+	FUNCTION        3       gin_extract_hstore_query(internal, internal, int2, internal, internal),
+	FUNCTION        4       gin_consistent_hstore(internal, int2, internal, int4, internal, internal),
+	STORAGE         bytea;

hstore_ops.control

@@ -1,6 +1,6 @@
 # hstore_ops extension
 comment = 'extra operator class for hstore extension'
-default_version = '1.0'
+default_version = '1.1'
 module_pathname = '$libdir/hstore_ops'
 relocatable = true
 requires = 'hstore'