diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml index 208389e8006..147a8f7587c 100644 --- a/doc/src/sgml/ref/create_index.sgml +++ b/doc/src/sgml/ref/create_index.sgml @@ -387,9 +387,13 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] The optional WITH clause specifies storage - parameters for the index. Each index method has its own set of allowed - storage parameters. The B-tree, hash, GiST and SP-GiST index methods all - accept this parameter: + parameters for the index. Each index method has its own set + of allowed storage parameters. + + + + The B-tree, hash, GiST and SP-GiST index methods all accept this + parameter: @@ -401,7 +405,7 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] - The fillfactor for an index is a percentage that determines how full + Controls how full the index method will try to pack index pages. For B-trees, leaf pages are filled to this percentage during initial index builds, and also when extending the index at the right (adding new largest key values). @@ -488,7 +492,7 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] - Determines whether the buffered build technique described in + Controls whether the buffered build technique described in is used to build the index. With OFF buffering is disabled, with ON it is enabled, and with AUTO it is initially disabled, @@ -503,7 +507,7 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] - GIN indexes accept different parameters: + GIN indexes accept these parameters: @@ -515,8 +519,8 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] - This setting controls usage of the fast update technique described in - . It is a Boolean parameter: + Controls usage of the fast update technique described in + . ON enables fast update, OFF disables it. The default is ON. @@ -525,8 +529,9 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] Turning fastupdate off via ALTER INDEX prevents future insertions from going into the list of pending index entries, - but does not in itself flush previous entries. You might want to - VACUUM the table or call gin_clean_pending_list + but does not in itself flush existing entries. You might want to + VACUUM the table or call + the gin_clean_pending_list function afterward to ensure the pending list is emptied. @@ -544,7 +549,8 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] - Custom parameter. + Overrides the global setting of + for this index. This value is specified in kilobytes. @@ -552,7 +558,7 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] - BRIN indexes accept different parameters: + BRIN indexes accept these parameters: @@ -580,8 +586,8 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] Defines whether a summarization run is queued for the previous page - range whenever an insertion is detected on the next one. - See for more details. + range whenever an insertion is detected on the next one + (see for more details). The default is off.