From: Simon Riggs Date: Wed, 17 Oct 2012 07:33:38 +0000 (+0100) Subject: Clarify hash index caution and copy to CREATE INDEX docs X-Git-Tag: REL9_0_11~39 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=98188441972151995d485b2e2c18a8cf36a3a227;p=thirdparty%2Fpostgresql.git Clarify hash index caution and copy to CREATE INDEX docs --- diff --git a/doc/src/sgml/indices.sgml b/doc/src/sgml/indices.sgml index 1b02f5f5635..9e090af0a0f 100644 --- a/doc/src/sgml/indices.sgml +++ b/doc/src/sgml/indices.sgml @@ -191,8 +191,10 @@ CREATE INDEX name ON table Hash index operations are not presently WAL-logged, so hash indexes might need to be rebuilt with REINDEX - after a database crash. They are also not replicated over streaming or - file-based replication. + after a database crash if there were unwritten changes. + Also, changes to hash indexes are not replicated over streaming or + file-based replication after the initial base backup, so they + give wrong anwers to queries that subsequently use them. For these reasons, hash index use is presently discouraged. diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml index 5f23316c78d..06bd06ba7c9 100644 --- a/doc/src/sgml/ref/create_index.sgml +++ b/doc/src/sgml/ref/create_index.sgml @@ -439,6 +439,18 @@ Indexes: they can be useful. + + + Hash index operations are not presently WAL-logged, + so hash indexes might need to be rebuilt with REINDEX + after a database crash if there were unwritten changes. + Also, changes to hash indexes are not replicated over streaming or + file-based replication after the initial base backup, so they + give wrong anwers to queries that subsequently use them. + For these reasons, hash index use is presently discouraged. + + + Currently, only the B-tree, GiST and GIN index methods support multicolumn indexes. Up to 32 fields can be specified by default.