https://github.com/postgrespro/hstore_ops
Better operator class for hstore: smaller index and faster @> queries.
https://github.com/postgrespro/hstore_ops
Last synced: 6 days ago
JSON representation
Better operator class for hstore: smaller index and faster @> queries.
- Host: GitHub
- URL: https://github.com/postgrespro/hstore_ops
- Owner: postgrespro
- Created: 2014-04-25T09:59:18.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2023-11-13T12:53:25.000Z (over 1 year ago)
- Last Synced: 2025-04-24T10:48:41.063Z (7 days ago)
- Language: C
- Homepage:
- Size: 25.4 KB
- Stars: 16
- Watchers: 5
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
hstore_ops - better operator class for hstore
=============================================
hstore_ops extension provides another implementation of GIN index (opclass)
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
match for each queried key-value pair. Search for @>, ?, ?|, ?& is possible
as partial match for each queried hstore key. Recheck is essential for
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
-------
* Alexander Korotkov , Intaro Soft Ltd., Moscow, Russia
* Oleg Bartunov , Moscow University, Moscow, Russia
License
-------
Development version, available on github, released under the
GNU General Public License, version 2 (June 1991).
Downloads
---------
Stable version of hstore_ops is available from
https://github.com/postgrespro/hstore_ops
Installation
------------
hstore_ops is regular PostgreSQL extension depending on hstore contrib.
To build and install it you should ensure in following:
* You have development package of PostgreSQL installed or you built
PostgreSQL from source.
* Your PATH variable configured so that pg_config command available.
* You did "CREATE EXTENSION hstore;" before "CREATE EXTENSION hstore_ops;".
Typical installation procedure may look like this:
$ git clone https://github.com/postgrespro/hstore_ops.git
$ cd hstore_ops
$ make USE_PGXS=1
$ sudo make USE_PGXS=1 install
$ 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 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.