mirror of https://github.com/postgres/postgres
This patch introduces INCLUDE clause to index definition. This clause specifies a list of columns which will be included as a non-key part in the index. The INCLUDE columns exist solely to allow more queries to benefit from index-only scans. Also, such columns don't need to have appropriate operator classes. Expressions are not supported as INCLUDE columns since they cannot be used in index-only scans. Index access methods supporting INCLUDE are indicated by amcaninclude flag in IndexAmRoutine. For now, only B-tree indexes support INCLUDE clause. In B-tree indexes INCLUDE columns are truncated from pivot index tuples (tuples located in non-leaf pages and high keys). Therefore, B-tree indexes now might have variable number of attributes. This patch also provides generic facility to support that: pivot tuples contain number of their attributes in t_tid.ip_posid. Free 13th bit of t_info is used for indicating that. This facility will simplify further support of index suffix truncation. The changes of above are backward-compatible, pg_upgrade doesn't need special handling of B-tree indexes for that. Bump catalog version Author: Anastasia Lubennikova with contribition by Alexander Korotkov and me Reviewed by: Peter Geoghegan, Tomas Vondra, Antonin Houska, Jeff Janes, David Rowley, Alexander Korotkov Discussion: https://www.postgresql.org/message-id/flat/56168952.4010101@postgrespro.rupull/27/merge
Teodor Sigaev
8 years ago
parent
01bb85169a
commit
8224de4f42
@ -0,0 +1,346 @@ |
||||
/* |
||||
* 1.test CREATE INDEX |
||||
*/ |
||||
-- Regular index with included columns |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT x, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
CREATE INDEX tbl_idx ON tbl using btree (c1, c2) INCLUDE (c3,c4); |
||||
-- must fail because of intersection of key and included columns |
||||
CREATE INDEX tbl_idx ON tbl using btree (c1, c2) INCLUDE (c1,c3); |
||||
ERROR: included columns must not intersect with key columns |
||||
SELECT pg_get_indexdef(i.indexrelid) |
||||
FROM pg_index i JOIN pg_class c ON i.indexrelid = c.oid |
||||
WHERE i.indrelid = 'tbl'::regclass ORDER BY c.relname; |
||||
pg_get_indexdef |
||||
-------------------------------------------------------------------------- |
||||
CREATE INDEX tbl_idx ON public.tbl USING btree (c1, c2) INCLUDE (c3, c4) |
||||
(1 row) |
||||
|
||||
DROP TABLE tbl; |
||||
-- Unique index and unique constraint |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT x, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
CREATE UNIQUE INDEX tbl_idx_unique ON tbl using btree (c1, c2) INCLUDE (c3, c4); |
||||
ALTER TABLE tbl add UNIQUE USING INDEX tbl_idx_unique; |
||||
ALTER TABLE tbl add UNIQUE (c1, c2) INCLUDE (c3, c4); |
||||
SELECT pg_get_indexdef(i.indexrelid) |
||||
FROM pg_index i JOIN pg_class c ON i.indexrelid = c.oid |
||||
WHERE i.indrelid = 'tbl'::regclass ORDER BY c.relname; |
||||
pg_get_indexdef |
||||
--------------------------------------------------------------------------------------------- |
||||
CREATE UNIQUE INDEX tbl_c1_c2_c3_c4_key ON public.tbl USING btree (c1, c2) INCLUDE (c3, c4) |
||||
CREATE UNIQUE INDEX tbl_idx_unique ON public.tbl USING btree (c1, c2) INCLUDE (c3, c4) |
||||
(2 rows) |
||||
|
||||
DROP TABLE tbl; |
||||
-- Unique index and unique constraint. Both must fail. |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
CREATE UNIQUE INDEX tbl_idx_unique ON tbl using btree (c1, c2) INCLUDE (c3, c4); |
||||
ERROR: could not create unique index "tbl_idx_unique" |
||||
DETAIL: Key (c1, c2)=(1, 2) is duplicated. |
||||
ALTER TABLE tbl add UNIQUE (c1, c2) INCLUDE (c3, c4); |
||||
ERROR: could not create unique index "tbl_c1_c2_c3_c4_key" |
||||
DETAIL: Key (c1, c2)=(1, 2) is duplicated. |
||||
DROP TABLE tbl; |
||||
-- PK constraint |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT 1, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ALTER TABLE tbl add PRIMARY KEY (c1, c2) INCLUDE (c3, c4); |
||||
SELECT pg_get_indexdef(i.indexrelid) |
||||
FROM pg_index i JOIN pg_class c ON i.indexrelid = c.oid |
||||
WHERE i.indrelid = 'tbl'::regclass ORDER BY c.relname; |
||||
pg_get_indexdef |
||||
---------------------------------------------------------------------------------- |
||||
CREATE UNIQUE INDEX tbl_pkey ON public.tbl USING btree (c1, c2) INCLUDE (c3, c4) |
||||
(1 row) |
||||
|
||||
DROP TABLE tbl; |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT 1, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
CREATE UNIQUE INDEX tbl_idx_unique ON tbl using btree (c1, c2) INCLUDE (c3, c4); |
||||
ALTER TABLE tbl add PRIMARY KEY USING INDEX tbl_idx_unique; |
||||
SELECT pg_get_indexdef(i.indexrelid) |
||||
FROM pg_index i JOIN pg_class c ON i.indexrelid = c.oid |
||||
WHERE i.indrelid = 'tbl'::regclass ORDER BY c.relname; |
||||
pg_get_indexdef |
||||
---------------------------------------------------------------------------------------- |
||||
CREATE UNIQUE INDEX tbl_idx_unique ON public.tbl USING btree (c1, c2) INCLUDE (c3, c4) |
||||
(1 row) |
||||
|
||||
DROP TABLE tbl; |
||||
-- PK constraint. Must fail. |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ALTER TABLE tbl add PRIMARY KEY (c1, c2) INCLUDE (c3, c4); |
||||
ERROR: could not create unique index "tbl_pkey" |
||||
DETAIL: Key (c1, c2)=(1, 2) is duplicated. |
||||
DROP TABLE tbl; |
||||
/* |
||||
* 2. Test CREATE TABLE with constraint |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, |
||||
CONSTRAINT covering UNIQUE(c1,c2) INCLUDE(c3,c4)); |
||||
SELECT indexrelid::regclass, indnatts, indnkeyatts, indisunique, indisprimary, indkey, indclass FROM pg_index WHERE indrelid = 'tbl'::regclass::oid; |
||||
indexrelid | indnatts | indnkeyatts | indisunique | indisprimary | indkey | indclass |
||||
------------+----------+-------------+-------------+--------------+---------+----------- |
||||
covering | 4 | 2 | t | f | 1 2 3 4 | 1978 1978 |
||||
(1 row) |
||||
|
||||
SELECT pg_get_constraintdef(oid), conname, conkey, conincluding FROM pg_constraint WHERE conrelid = 'tbl'::regclass::oid; |
||||
pg_get_constraintdef | conname | conkey | conincluding |
||||
----------------------------------+----------+--------+-------------- |
||||
UNIQUE (c1, c2) INCLUDE (c3, c4) | covering | {1,2} | {3,4} |
||||
(1 row) |
||||
|
||||
-- ensure that constraint works |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ERROR: duplicate key value violates unique constraint "covering" |
||||
DETAIL: Key (c1, c2)=(1, 2) already exists. |
||||
DROP TABLE tbl; |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, |
||||
CONSTRAINT covering PRIMARY KEY(c1,c2) INCLUDE(c3,c4)); |
||||
SELECT indexrelid::regclass, indnatts, indnkeyatts, indisunique, indisprimary, indkey, indclass FROM pg_index WHERE indrelid = 'tbl'::regclass::oid; |
||||
indexrelid | indnatts | indnkeyatts | indisunique | indisprimary | indkey | indclass |
||||
------------+----------+-------------+-------------+--------------+---------+----------- |
||||
covering | 4 | 2 | t | t | 1 2 3 4 | 1978 1978 |
||||
(1 row) |
||||
|
||||
SELECT pg_get_constraintdef(oid), conname, conkey, conincluding FROM pg_constraint WHERE conrelid = 'tbl'::regclass::oid; |
||||
pg_get_constraintdef | conname | conkey | conincluding |
||||
---------------------------------------+----------+--------+-------------- |
||||
PRIMARY KEY (c1, c2) INCLUDE (c3, c4) | covering | {1,2} | {3,4} |
||||
(1 row) |
||||
|
||||
-- ensure that constraint works |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ERROR: duplicate key value violates unique constraint "covering" |
||||
DETAIL: Key (c1, c2)=(1, 2) already exists. |
||||
INSERT INTO tbl SELECT 1, NULL, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ERROR: null value in column "c2" violates not-null constraint |
||||
DETAIL: Failing row contains (1, null, 3, (4,4),(4,4)). |
||||
INSERT INTO tbl SELECT x, 2*x, NULL, NULL FROM generate_series(1,10) AS x; |
||||
DROP TABLE tbl; |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, |
||||
UNIQUE(c1,c2) INCLUDE(c3,c4)); |
||||
SELECT indexrelid::regclass, indnatts, indnkeyatts, indisunique, indisprimary, indkey, indclass FROM pg_index WHERE indrelid = 'tbl'::regclass::oid; |
||||
indexrelid | indnatts | indnkeyatts | indisunique | indisprimary | indkey | indclass |
||||
---------------------+----------+-------------+-------------+--------------+---------+----------- |
||||
tbl_c1_c2_c3_c4_key | 4 | 2 | t | f | 1 2 3 4 | 1978 1978 |
||||
(1 row) |
||||
|
||||
SELECT pg_get_constraintdef(oid), conname, conkey, conincluding FROM pg_constraint WHERE conrelid = 'tbl'::regclass::oid; |
||||
pg_get_constraintdef | conname | conkey | conincluding |
||||
----------------------------------+---------------------+--------+-------------- |
||||
UNIQUE (c1, c2) INCLUDE (c3, c4) | tbl_c1_c2_c3_c4_key | {1,2} | {3,4} |
||||
(1 row) |
||||
|
||||
-- ensure that constraint works |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ERROR: duplicate key value violates unique constraint "tbl_c1_c2_c3_c4_key" |
||||
DETAIL: Key (c1, c2)=(1, 2) already exists. |
||||
DROP TABLE tbl; |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, |
||||
PRIMARY KEY(c1,c2) INCLUDE(c3,c4)); |
||||
SELECT indexrelid::regclass, indnatts, indnkeyatts, indisunique, indisprimary, indkey, indclass FROM pg_index WHERE indrelid = 'tbl'::regclass::oid; |
||||
indexrelid | indnatts | indnkeyatts | indisunique | indisprimary | indkey | indclass |
||||
------------+----------+-------------+-------------+--------------+---------+----------- |
||||
tbl_pkey | 4 | 2 | t | t | 1 2 3 4 | 1978 1978 |
||||
(1 row) |
||||
|
||||
SELECT pg_get_constraintdef(oid), conname, conkey, conincluding FROM pg_constraint WHERE conrelid = 'tbl'::regclass::oid; |
||||
pg_get_constraintdef | conname | conkey | conincluding |
||||
---------------------------------------+----------+--------+-------------- |
||||
PRIMARY KEY (c1, c2) INCLUDE (c3, c4) | tbl_pkey | {1,2} | {3,4} |
||||
(1 row) |
||||
|
||||
-- ensure that constraint works |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ERROR: duplicate key value violates unique constraint "tbl_pkey" |
||||
DETAIL: Key (c1, c2)=(1, 2) already exists. |
||||
INSERT INTO tbl SELECT 1, NULL, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ERROR: null value in column "c2" violates not-null constraint |
||||
DETAIL: Failing row contains (1, null, 3, (4,4),(4,4)). |
||||
INSERT INTO tbl SELECT x, 2*x, NULL, NULL FROM generate_series(1,10) AS x; |
||||
DROP TABLE tbl; |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, |
||||
EXCLUDE USING btree (c1 WITH =) INCLUDE(c3,c4)); |
||||
SELECT indexrelid::regclass, indnatts, indnkeyatts, indisunique, indisprimary, indkey, indclass FROM pg_index WHERE indrelid = 'tbl'::regclass::oid; |
||||
indexrelid | indnatts | indnkeyatts | indisunique | indisprimary | indkey | indclass |
||||
-------------------+----------+-------------+-------------+--------------+--------+---------- |
||||
tbl_c1_c3_c4_excl | 3 | 1 | f | f | 1 3 4 | 1978 |
||||
(1 row) |
||||
|
||||
SELECT pg_get_constraintdef(oid), conname, conkey, conincluding FROM pg_constraint WHERE conrelid = 'tbl'::regclass::oid; |
||||
pg_get_constraintdef | conname | conkey | conincluding |
||||
--------------------------------------------------+-------------------+--------+-------------- |
||||
EXCLUDE USING btree (c1 WITH =) INCLUDE (c3, c4) | tbl_c1_c3_c4_excl | {1} | {3,4} |
||||
(1 row) |
||||
|
||||
-- ensure that constraint works |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ERROR: conflicting key value violates exclusion constraint "tbl_c1_c3_c4_excl" |
||||
DETAIL: Key (c1)=(1) conflicts with existing key (c1)=(1). |
||||
INSERT INTO tbl SELECT x, 2*x, NULL, NULL FROM generate_series(1,10) AS x; |
||||
DROP TABLE tbl; |
||||
/* |
||||
* 3.0 Test ALTER TABLE DROP COLUMN. |
||||
* Any column deletion leads to index deletion. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 int); |
||||
CREATE UNIQUE INDEX tbl_idx ON tbl using btree(c1, c2, c3, c4); |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
------------------------------------------------------------------------ |
||||
CREATE UNIQUE INDEX tbl_idx ON public.tbl USING btree (c1, c2, c3, c4) |
||||
(1 row) |
||||
|
||||
ALTER TABLE tbl DROP COLUMN c3; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
---------- |
||||
(0 rows) |
||||
|
||||
DROP TABLE tbl; |
||||
/* |
||||
* 3.1 Test ALTER TABLE DROP COLUMN. |
||||
* Included column deletion leads to the index deletion, |
||||
* AS well AS key columns deletion. It's explained in documentation. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box); |
||||
CREATE UNIQUE INDEX tbl_idx ON tbl using btree(c1, c2) INCLUDE(c3,c4); |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
--------------------------------------------------------------------------------- |
||||
CREATE UNIQUE INDEX tbl_idx ON public.tbl USING btree (c1, c2) INCLUDE (c3, c4) |
||||
(1 row) |
||||
|
||||
ALTER TABLE tbl DROP COLUMN c3; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
---------- |
||||
(0 rows) |
||||
|
||||
DROP TABLE tbl; |
||||
/* |
||||
* 3.2 Test ALTER TABLE DROP COLUMN. |
||||
* Included column deletion leads to the index deletion. |
||||
* AS well AS key columns deletion. It's explained in documentation. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, UNIQUE(c1, c2) INCLUDE(c3,c4)); |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
--------------------------------------------------------------------------------------------- |
||||
CREATE UNIQUE INDEX tbl_c1_c2_c3_c4_key ON public.tbl USING btree (c1, c2) INCLUDE (c3, c4) |
||||
(1 row) |
||||
|
||||
ALTER TABLE tbl DROP COLUMN c3; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
---------- |
||||
(0 rows) |
||||
|
||||
ALTER TABLE tbl DROP COLUMN c1; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
---------- |
||||
(0 rows) |
||||
|
||||
DROP TABLE tbl; |
||||
/* |
||||
* 4. CREATE INDEX CONCURRENTLY |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, UNIQUE(c1, c2) INCLUDE(c3,c4)); |
||||
INSERT INTO tbl SELECT x, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,1000) AS x; |
||||
CREATE UNIQUE INDEX CONCURRENTLY on tbl (c1, c2) INCLUDE (c3, c4); |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
--------------------------------------------------------------------------------------------- |
||||
CREATE UNIQUE INDEX tbl_c1_c2_c3_c4_idx ON public.tbl USING btree (c1, c2) INCLUDE (c3, c4) |
||||
CREATE UNIQUE INDEX tbl_c1_c2_c3_c4_key ON public.tbl USING btree (c1, c2) INCLUDE (c3, c4) |
||||
(2 rows) |
||||
|
||||
DROP TABLE tbl; |
||||
/* |
||||
* 5. REINDEX |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, UNIQUE(c1, c2) INCLUDE(c3,c4)); |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
--------------------------------------------------------------------------------------------- |
||||
CREATE UNIQUE INDEX tbl_c1_c2_c3_c4_key ON public.tbl USING btree (c1, c2) INCLUDE (c3, c4) |
||||
(1 row) |
||||
|
||||
ALTER TABLE tbl DROP COLUMN c3; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
---------- |
||||
(0 rows) |
||||
|
||||
REINDEX INDEX tbl_c1_c2_c3_c4_key; |
||||
ERROR: relation "tbl_c1_c2_c3_c4_key" does not exist |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
---------- |
||||
(0 rows) |
||||
|
||||
ALTER TABLE tbl DROP COLUMN c1; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
indexdef |
||||
---------- |
||||
(0 rows) |
||||
|
||||
DROP TABLE tbl; |
||||
/* |
||||
* 7. Check various AMs. All but btree must fail. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 box, c4 box); |
||||
CREATE INDEX on tbl USING brin(c1, c2) INCLUDE (c3, c4); |
||||
ERROR: access method "brin" does not support included columns |
||||
CREATE INDEX on tbl USING gist(c3) INCLUDE (c4); |
||||
ERROR: access method "gist" does not support included columns |
||||
CREATE INDEX on tbl USING spgist(c3) INCLUDE (c4); |
||||
ERROR: access method "spgist" does not support included columns |
||||
CREATE INDEX on tbl USING gin(c1, c2) INCLUDE (c3, c4); |
||||
ERROR: access method "gin" does not support included columns |
||||
CREATE INDEX on tbl USING hash(c1, c2) INCLUDE (c3, c4); |
||||
ERROR: access method "hash" does not support included columns |
||||
CREATE INDEX on tbl USING rtree(c1, c2) INCLUDE (c3, c4); |
||||
NOTICE: substituting access method "gist" for obsolete method "rtree" |
||||
ERROR: access method "gist" does not support included columns |
||||
CREATE INDEX on tbl USING btree(c1, c2) INCLUDE (c3, c4); |
||||
DROP TABLE tbl; |
||||
/* |
||||
* 8. Update, delete values in indexed table. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT x, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
CREATE UNIQUE INDEX tbl_idx_unique ON tbl using btree(c1, c2) INCLUDE (c3,c4); |
||||
UPDATE tbl SET c1 = 100 WHERE c1 = 2; |
||||
UPDATE tbl SET c1 = 1 WHERE c1 = 3; |
||||
-- should fail |
||||
UPDATE tbl SET c2 = 2 WHERE c1 = 1; |
||||
ERROR: duplicate key value violates unique constraint "tbl_idx_unique" |
||||
DETAIL: Key (c1, c2)=(1, 2) already exists. |
||||
UPDATE tbl SET c3 = 1; |
||||
DELETE FROM tbl WHERE c1 = 5 OR c3 = 12; |
||||
DROP TABLE tbl; |
||||
/* |
||||
* 9. Alter column type. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, UNIQUE(c1, c2) INCLUDE(c3,c4)); |
||||
INSERT INTO tbl SELECT x, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ALTER TABLE tbl ALTER c1 TYPE bigint; |
||||
ALTER TABLE tbl ALTER c3 TYPE bigint; |
||||
\d tbl |
||||
Table "public.tbl" |
||||
Column | Type | Collation | Nullable | Default |
||||
--------+---------+-----------+----------+--------- |
||||
c1 | bigint | | | |
||||
c2 | integer | | | |
||||
c3 | bigint | | | |
||||
c4 | box | | | |
||||
Indexes: |
||||
"tbl_c1_c2_c3_c4_key" UNIQUE CONSTRAINT, btree (c1, c2) INCLUDE (c3, c4) |
||||
|
||||
DROP TABLE tbl; |
||||
@ -0,0 +1,203 @@ |
||||
/* |
||||
* 1.test CREATE INDEX |
||||
*/ |
||||
|
||||
-- Regular index with included columns |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT x, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
CREATE INDEX tbl_idx ON tbl using btree (c1, c2) INCLUDE (c3,c4); |
||||
-- must fail because of intersection of key and included columns |
||||
CREATE INDEX tbl_idx ON tbl using btree (c1, c2) INCLUDE (c1,c3); |
||||
SELECT pg_get_indexdef(i.indexrelid) |
||||
FROM pg_index i JOIN pg_class c ON i.indexrelid = c.oid |
||||
WHERE i.indrelid = 'tbl'::regclass ORDER BY c.relname; |
||||
DROP TABLE tbl; |
||||
|
||||
-- Unique index and unique constraint |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT x, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
CREATE UNIQUE INDEX tbl_idx_unique ON tbl using btree (c1, c2) INCLUDE (c3, c4); |
||||
ALTER TABLE tbl add UNIQUE USING INDEX tbl_idx_unique; |
||||
ALTER TABLE tbl add UNIQUE (c1, c2) INCLUDE (c3, c4); |
||||
SELECT pg_get_indexdef(i.indexrelid) |
||||
FROM pg_index i JOIN pg_class c ON i.indexrelid = c.oid |
||||
WHERE i.indrelid = 'tbl'::regclass ORDER BY c.relname; |
||||
DROP TABLE tbl; |
||||
|
||||
-- Unique index and unique constraint. Both must fail. |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
CREATE UNIQUE INDEX tbl_idx_unique ON tbl using btree (c1, c2) INCLUDE (c3, c4); |
||||
ALTER TABLE tbl add UNIQUE (c1, c2) INCLUDE (c3, c4); |
||||
DROP TABLE tbl; |
||||
|
||||
-- PK constraint |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT 1, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ALTER TABLE tbl add PRIMARY KEY (c1, c2) INCLUDE (c3, c4); |
||||
SELECT pg_get_indexdef(i.indexrelid) |
||||
FROM pg_index i JOIN pg_class c ON i.indexrelid = c.oid |
||||
WHERE i.indrelid = 'tbl'::regclass ORDER BY c.relname; |
||||
DROP TABLE tbl; |
||||
|
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT 1, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
CREATE UNIQUE INDEX tbl_idx_unique ON tbl using btree (c1, c2) INCLUDE (c3, c4); |
||||
ALTER TABLE tbl add PRIMARY KEY USING INDEX tbl_idx_unique; |
||||
SELECT pg_get_indexdef(i.indexrelid) |
||||
FROM pg_index i JOIN pg_class c ON i.indexrelid = c.oid |
||||
WHERE i.indrelid = 'tbl'::regclass ORDER BY c.relname; |
||||
DROP TABLE tbl; |
||||
|
||||
-- PK constraint. Must fail. |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ALTER TABLE tbl add PRIMARY KEY (c1, c2) INCLUDE (c3, c4); |
||||
DROP TABLE tbl; |
||||
|
||||
|
||||
/* |
||||
* 2. Test CREATE TABLE with constraint |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, |
||||
CONSTRAINT covering UNIQUE(c1,c2) INCLUDE(c3,c4)); |
||||
SELECT indexrelid::regclass, indnatts, indnkeyatts, indisunique, indisprimary, indkey, indclass FROM pg_index WHERE indrelid = 'tbl'::regclass::oid; |
||||
SELECT pg_get_constraintdef(oid), conname, conkey, conincluding FROM pg_constraint WHERE conrelid = 'tbl'::regclass::oid; |
||||
-- ensure that constraint works |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
DROP TABLE tbl; |
||||
|
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, |
||||
CONSTRAINT covering PRIMARY KEY(c1,c2) INCLUDE(c3,c4)); |
||||
SELECT indexrelid::regclass, indnatts, indnkeyatts, indisunique, indisprimary, indkey, indclass FROM pg_index WHERE indrelid = 'tbl'::regclass::oid; |
||||
SELECT pg_get_constraintdef(oid), conname, conkey, conincluding FROM pg_constraint WHERE conrelid = 'tbl'::regclass::oid; |
||||
-- ensure that constraint works |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
INSERT INTO tbl SELECT 1, NULL, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
INSERT INTO tbl SELECT x, 2*x, NULL, NULL FROM generate_series(1,10) AS x; |
||||
DROP TABLE tbl; |
||||
|
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, |
||||
UNIQUE(c1,c2) INCLUDE(c3,c4)); |
||||
SELECT indexrelid::regclass, indnatts, indnkeyatts, indisunique, indisprimary, indkey, indclass FROM pg_index WHERE indrelid = 'tbl'::regclass::oid; |
||||
SELECT pg_get_constraintdef(oid), conname, conkey, conincluding FROM pg_constraint WHERE conrelid = 'tbl'::regclass::oid; |
||||
-- ensure that constraint works |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
DROP TABLE tbl; |
||||
|
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, |
||||
PRIMARY KEY(c1,c2) INCLUDE(c3,c4)); |
||||
SELECT indexrelid::regclass, indnatts, indnkeyatts, indisunique, indisprimary, indkey, indclass FROM pg_index WHERE indrelid = 'tbl'::regclass::oid; |
||||
SELECT pg_get_constraintdef(oid), conname, conkey, conincluding FROM pg_constraint WHERE conrelid = 'tbl'::regclass::oid; |
||||
-- ensure that constraint works |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
INSERT INTO tbl SELECT 1, NULL, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
INSERT INTO tbl SELECT x, 2*x, NULL, NULL FROM generate_series(1,10) AS x; |
||||
DROP TABLE tbl; |
||||
|
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, |
||||
EXCLUDE USING btree (c1 WITH =) INCLUDE(c3,c4)); |
||||
SELECT indexrelid::regclass, indnatts, indnkeyatts, indisunique, indisprimary, indkey, indclass FROM pg_index WHERE indrelid = 'tbl'::regclass::oid; |
||||
SELECT pg_get_constraintdef(oid), conname, conkey, conincluding FROM pg_constraint WHERE conrelid = 'tbl'::regclass::oid; |
||||
-- ensure that constraint works |
||||
INSERT INTO tbl SELECT 1, 2, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
INSERT INTO tbl SELECT x, 2*x, NULL, NULL FROM generate_series(1,10) AS x; |
||||
DROP TABLE tbl; |
||||
|
||||
/* |
||||
* 3.0 Test ALTER TABLE DROP COLUMN. |
||||
* Any column deletion leads to index deletion. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 int); |
||||
CREATE UNIQUE INDEX tbl_idx ON tbl using btree(c1, c2, c3, c4); |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
ALTER TABLE tbl DROP COLUMN c3; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
DROP TABLE tbl; |
||||
|
||||
/* |
||||
* 3.1 Test ALTER TABLE DROP COLUMN. |
||||
* Included column deletion leads to the index deletion, |
||||
* AS well AS key columns deletion. It's explained in documentation. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box); |
||||
CREATE UNIQUE INDEX tbl_idx ON tbl using btree(c1, c2) INCLUDE(c3,c4); |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
ALTER TABLE tbl DROP COLUMN c3; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
DROP TABLE tbl; |
||||
|
||||
/* |
||||
* 3.2 Test ALTER TABLE DROP COLUMN. |
||||
* Included column deletion leads to the index deletion. |
||||
* AS well AS key columns deletion. It's explained in documentation. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, UNIQUE(c1, c2) INCLUDE(c3,c4)); |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
ALTER TABLE tbl DROP COLUMN c3; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
ALTER TABLE tbl DROP COLUMN c1; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
DROP TABLE tbl; |
||||
|
||||
|
||||
/* |
||||
* 4. CREATE INDEX CONCURRENTLY |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, UNIQUE(c1, c2) INCLUDE(c3,c4)); |
||||
INSERT INTO tbl SELECT x, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,1000) AS x; |
||||
CREATE UNIQUE INDEX CONCURRENTLY on tbl (c1, c2) INCLUDE (c3, c4); |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
DROP TABLE tbl; |
||||
|
||||
|
||||
/* |
||||
* 5. REINDEX |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, UNIQUE(c1, c2) INCLUDE(c3,c4)); |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
ALTER TABLE tbl DROP COLUMN c3; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
REINDEX INDEX tbl_c1_c2_c3_c4_key; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
ALTER TABLE tbl DROP COLUMN c1; |
||||
SELECT indexdef FROM pg_indexes WHERE tablename = 'tbl' ORDER BY indexname; |
||||
DROP TABLE tbl; |
||||
|
||||
/* |
||||
* 7. Check various AMs. All but btree must fail. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 box, c4 box); |
||||
CREATE INDEX on tbl USING brin(c1, c2) INCLUDE (c3, c4); |
||||
CREATE INDEX on tbl USING gist(c3) INCLUDE (c4); |
||||
CREATE INDEX on tbl USING spgist(c3) INCLUDE (c4); |
||||
CREATE INDEX on tbl USING gin(c1, c2) INCLUDE (c3, c4); |
||||
CREATE INDEX on tbl USING hash(c1, c2) INCLUDE (c3, c4); |
||||
CREATE INDEX on tbl USING rtree(c1, c2) INCLUDE (c3, c4); |
||||
CREATE INDEX on tbl USING btree(c1, c2) INCLUDE (c3, c4); |
||||
DROP TABLE tbl; |
||||
|
||||
/* |
||||
* 8. Update, delete values in indexed table. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int, c2 int, c3 int, c4 box); |
||||
INSERT INTO tbl SELECT x, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
CREATE UNIQUE INDEX tbl_idx_unique ON tbl using btree(c1, c2) INCLUDE (c3,c4); |
||||
UPDATE tbl SET c1 = 100 WHERE c1 = 2; |
||||
UPDATE tbl SET c1 = 1 WHERE c1 = 3; |
||||
-- should fail |
||||
UPDATE tbl SET c2 = 2 WHERE c1 = 1; |
||||
UPDATE tbl SET c3 = 1; |
||||
DELETE FROM tbl WHERE c1 = 5 OR c3 = 12; |
||||
DROP TABLE tbl; |
||||
|
||||
/* |
||||
* 9. Alter column type. |
||||
*/ |
||||
CREATE TABLE tbl (c1 int,c2 int, c3 int, c4 box, UNIQUE(c1, c2) INCLUDE(c3,c4)); |
||||
INSERT INTO tbl SELECT x, 2*x, 3*x, box('4,4,4,4') FROM generate_series(1,10) AS x; |
||||
ALTER TABLE tbl ALTER c1 TYPE bigint; |
||||
ALTER TABLE tbl ALTER c3 TYPE bigint; |
||||
\d tbl |
||||
DROP TABLE tbl; |
||||
|
||||
Loading…
Reference in new issue