--- doc/src/sgml/ref/create_index.sgml.orig 2018-04-05 14:36:00.904617793 +0200
+++ doc/src/sgml/ref/create_index.sgml 2018-04-05 15:49:03.778805965 +0200
@@ -148,31 +148,27 @@
INCLUDE
- An optional INCLUDE clause allows to specify the
- list of columns which will be included in the non-key part of the index.
- Columns listed in this clause cannot co-exist as index key columns,
- and vice versa. The INCLUDE columns exist solely to
+ The optional INCLUDE clause specifies a
+ list of columns which will be included as a non-key part in the index.
+ Columns listed in this clause cannot also be present as index key columns.
+ The INCLUDE columns exist solely to
allow more queries to benefit from index-only scans
- by including specified columns into the index. Values of these columns
+ by including the values of the specified columns in the index. These values
would otherwise have to be obtained by reading the table's heap.
- Having these columns in the INCLUDE clause
- in some cases allows PostgreSQL to skip
- the heap read completely.
- In the UNIQUE indexes, uniqueness is only enforced
+ In UNIQUE indexes, uniqueness is only enforced
for key columns. Columns listed in the INCLUDE
- clause have no influence to uniqueness enforcement. Other constraints
+ clause have no effect on uniqueness enforcement. Other constraints
(PRIMARY KEY and EXCLUDE) work the same way.
- Columns listed in the INCLUDE clause doesn't need
- appropriate operator class to exist. Therefore,
- INCLUDE clause if useful to add non-key index
- columns, whose data types don't have operator classes defined for
- given access method.
+ Columns listed in the INCLUDE clause don't need
+ appropriate operator classes; the clause can contain non-key index
+ columns whose data types don't have operator classes defined for
+ a given access method.
@@ -182,12 +178,12 @@
Currently, only the B-tree index access method supports this feature.
- In B-tree indexes, values of columns listed in the
- INCLUDE clause are included into leaf tuples which
- are linked to the heap tuples, but aren't included into pivot tuples
+ In B-tree indexes, the values of columns listed in the
+ INCLUDE clause are included in leaf tuples which
+ are linked to the heap tuples, but are not included into pivot tuples
used for tree navigation. Therefore, moving columns from the list of
key columns to the INCLUDE clause can slightly
- reduce index size and improve tree branching factor.
+ reduce index size and improve the tree branching factor.