From 84522dc77afd1b8ce0bf111279302888d9d3edcb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dagfinn=20Ilmari=20Manns=C3=A5ker?= Date: Fri, 31 Jul 2020 10:20:48 +0100 Subject: [PATCH] Add section headers to index types doc This makes it easier to compare the properties of different index types at a glance. In passing, make the index operator lists a single line each. --- doc/src/sgml/indices.sgml | 81 +++++++++++++++++++-------------------- 1 file changed, 39 insertions(+), 42 deletions(-) diff --git a/doc/src/sgml/indices.sgml b/doc/src/sgml/indices.sgml index 671299ff05..f22253f4c3 100644 --- a/doc/src/sgml/indices.sgml +++ b/doc/src/sgml/indices.sgml @@ -122,6 +122,9 @@ B-tree indexes, which fit the most common situations. + + B-tree + index @@ -137,13 +140,9 @@ will consider using a B-tree index whenever an indexed column is involved in a comparison using one of these operators: - - < - <= - = - >= - > - + +<   <=   =   >=   > + Constructs equivalent to combinations of these operators, such as BETWEEN and IN, can also be implemented with @@ -172,6 +171,10 @@ This is not always faster than a simple scan and sort, but it is often helpful. + + + + Hash @@ -191,6 +194,10 @@ CREATE INDEX name ON table USING HASH (column); + + + + GiST @@ -210,20 +217,9 @@ for several two-dimensional geometric data types, which support indexed queries using these operators: - - << - &< - &> - >> - <<| - &<| - |&> - |>> - @> - <@ - ~= - && - + +<<   &<   &>   >>   <<|   &<|   |&>   |>>   @>   <@   ~=   && + (See for the meaning of these operators.) @@ -246,6 +242,10 @@ In , operators that can be used in this way are listed in the column Ordering Operators. + + + + SP-GiST @@ -264,14 +264,9 @@ for two-dimensional points, which support indexed queries using these operators: - - << - >> - ~= - <@ - <^ - >^ - + +<<   >>   ~=   <@   <^   >^ + (See for the meaning of these operators.) @@ -286,6 +281,10 @@ corresponding operator is specified in the Ordering Operators column in . + + + + GIN @@ -312,12 +311,9 @@ PostgreSQL includes a GIN operator class for arrays, which supports indexed queries using these operators: - - <@ - @> - = - && - + +<@   @>   =   && + (See for the meaning of these operators.) @@ -327,6 +323,10 @@ classes are available in the contrib collection or as separate projects. For more information see . + + + + BRIN @@ -348,18 +348,15 @@ values in the column for each block range. This supports indexed queries using these operators: - - < - <= - = - >= - > - + +<   <=   =   >=   > + The BRIN operator classes included in the standard distribution are documented in . For more information see . + -- 2.27.0