mirror of
https://github.com/postgres/postgres.git
synced 2026-02-23 09:52:14 -05:00
f2e403803f
Similarly to B-tree, GiST index access method gets support of INCLUDE attributes. These attributes aren't used for tree navigation and aren't present in non-leaf pages. But they are present in leaf pages and can be fetched during index-only scan. The point of having INCLUDE attributes in GiST indexes is slightly different from the point of having them in B-tree. The main point of INCLUDE attributes in B-tree is to define UNIQUE constraint over part of attributes enabled for index-only scan. In GiST the main point of INCLUDE attributes is to use index-only scan for attributes, whose data types don't have GiST opclasses. Discussion: https://postgr.es/m/73A1A452-AD5F-40D4-BD61-978622FF75C1%40yandex-team.ru Author: Andrey Borodin, with small changes by me Reviewed-by: Andreas Karlsson
90 lines
3.8 KiB
SQL
90 lines
3.8 KiB
SQL
/*
|
|
* 1.1. test CREATE INDEX with buffered build
|
|
*/
|
|
|
|
-- Regular index with included columns
|
|
CREATE TABLE tbl_gist (c1 int, c2 int, c3 int, c4 box);
|
|
-- size is chosen to exceed page size and trigger actual truncation
|
|
INSERT INTO tbl_gist SELECT x, 2*x, 3*x, box(point(x,x+1),point(2*x,2*x+1)) FROM generate_series(1,8000) AS x;
|
|
CREATE INDEX tbl_gist_idx ON tbl_gist using gist (c4) INCLUDE (c1,c2,c3);
|
|
SELECT pg_get_indexdef(i.indexrelid)
|
|
FROM pg_index i JOIN pg_class c ON i.indexrelid = c.oid
|
|
WHERE i.indrelid = 'tbl_gist'::regclass ORDER BY c.relname;
|
|
SELECT * FROM tbl_gist where c4 <@ box(point(1,1),point(10,10));
|
|
SET enable_bitmapscan TO off;
|
|
EXPLAIN (costs off) SELECT * FROM tbl_gist where c4 <@ box(point(1,1),point(10,10));
|
|
SET enable_bitmapscan TO default;
|
|
DROP TABLE tbl_gist;
|
|
|
|
/*
|
|
* 1.2. test CREATE INDEX with inserts
|
|
*/
|
|
|
|
-- Regular index with included columns
|
|
CREATE TABLE tbl_gist (c1 int, c2 int, c3 int, c4 box);
|
|
-- size is chosen to exceed page size and trigger actual truncation
|
|
CREATE INDEX tbl_gist_idx ON tbl_gist using gist (c4) INCLUDE (c1,c2,c3);
|
|
INSERT INTO tbl_gist SELECT x, 2*x, 3*x, box(point(x,x+1),point(2*x,2*x+1)) FROM generate_series(1,8000) AS x;
|
|
SELECT pg_get_indexdef(i.indexrelid)
|
|
FROM pg_index i JOIN pg_class c ON i.indexrelid = c.oid
|
|
WHERE i.indrelid = 'tbl_gist'::regclass ORDER BY c.relname;
|
|
SELECT * FROM tbl_gist where c4 <@ box(point(1,1),point(10,10));
|
|
SET enable_bitmapscan TO off;
|
|
EXPLAIN (costs off) SELECT * FROM tbl_gist where c4 <@ box(point(1,1),point(10,10));
|
|
SET enable_bitmapscan TO default;
|
|
DROP TABLE tbl_gist;
|
|
|
|
/*
|
|
* 2. CREATE INDEX CONCURRENTLY
|
|
*/
|
|
CREATE TABLE tbl_gist (c1 int, c2 int, c3 int, c4 box);
|
|
INSERT INTO tbl_gist SELECT x, 2*x, 3*x, box(point(x,x+1),point(2*x,2*x+1)) FROM generate_series(1,10) AS x;
|
|
CREATE INDEX CONCURRENTLY tbl_gist_idx ON tbl_gist using gist (c4) INCLUDE (c1,c2,c3);
|
|
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl_gist' ORDER BY indexname;
|
|
DROP TABLE tbl_gist;
|
|
|
|
|
|
/*
|
|
* 3. REINDEX
|
|
*/
|
|
CREATE TABLE tbl_gist (c1 int, c2 int, c3 int, c4 box);
|
|
INSERT INTO tbl_gist SELECT x, 2*x, 3*x, box(point(x,x+1),point(2*x,2*x+1)) FROM generate_series(1,10) AS x;
|
|
CREATE INDEX tbl_gist_idx ON tbl_gist using gist (c4) INCLUDE (c1,c3);
|
|
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl_gist' ORDER BY indexname;
|
|
REINDEX INDEX tbl_gist_idx;
|
|
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl_gist' ORDER BY indexname;
|
|
ALTER TABLE tbl_gist DROP COLUMN c1;
|
|
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl_gist' ORDER BY indexname;
|
|
DROP TABLE tbl_gist;
|
|
|
|
/*
|
|
* 4. Update, delete values in indexed table.
|
|
*/
|
|
CREATE TABLE tbl_gist (c1 int, c2 int, c3 int, c4 box);
|
|
INSERT INTO tbl_gist SELECT x, 2*x, 3*x, box(point(x,x+1),point(2*x,2*x+1)) FROM generate_series(1,10) AS x;
|
|
CREATE INDEX tbl_gist_idx ON tbl_gist using gist (c4) INCLUDE (c1,c3);
|
|
UPDATE tbl_gist SET c1 = 100 WHERE c1 = 2;
|
|
UPDATE tbl_gist SET c1 = 1 WHERE c1 = 3;
|
|
DELETE FROM tbl_gist WHERE c1 = 5 OR c3 = 12;
|
|
DROP TABLE tbl_gist;
|
|
|
|
/*
|
|
* 5. Alter column type.
|
|
*/
|
|
CREATE TABLE tbl_gist (c1 int, c2 int, c3 int, c4 box);
|
|
INSERT INTO tbl_gist SELECT x, 2*x, 3*x, box(point(x,x+1),point(2*x,2*x+1)) FROM generate_series(1,10) AS x;
|
|
CREATE INDEX tbl_gist_idx ON tbl_gist using gist (c4) INCLUDE (c1,c3);
|
|
ALTER TABLE tbl_gist ALTER c1 TYPE bigint;
|
|
ALTER TABLE tbl_gist ALTER c3 TYPE bigint;
|
|
\d tbl_gist
|
|
DROP TABLE tbl_gist;
|
|
|
|
/*
|
|
* 6. EXCLUDE constraint.
|
|
*/
|
|
CREATE TABLE tbl_gist (c1 int, c2 int, c3 int, c4 box, EXCLUDE USING gist (c4 WITH &&) INCLUDE (c1, c2, c3));
|
|
INSERT INTO tbl_gist SELECT x, 2*x, 3*x, box(point(x,x+1),point(2*x,2*x+1)) FROM generate_series(1,10) AS x;
|
|
INSERT INTO tbl_gist SELECT x, 2*x, 3*x, box(point(3*x,2*x),point(3*x+1,2*x+1)) FROM generate_series(1,10) AS x;
|
|
EXPLAIN (costs off) SELECT * FROM tbl_gist where c4 <@ box(point(1,1),point(10,10));
|
|
\d tbl_gist
|
|
DROP TABLE tbl_gist;
|