diff options
| author | Simon Riggs | 2012-10-17 07:33:38 +0000 |
|---|---|---|
| committer | Simon Riggs | 2012-10-17 07:33:38 +0000 |
| commit | 98188441972151995d485b2e2c18a8cf36a3a227 (patch) | |
| tree | b743a68104e18f673a19babe15b739215935732e | |
| parent | 1c95b5eea6bec742d5d6ee097c55690712dd3be6 (diff) | |
Clarify hash index caution and copy to CREATE INDEX docs
| -rw-r--r-- | doc/src/sgml/indices.sgml | 6 | ||||
| -rw-r--r-- | doc/src/sgml/ref/create_index.sgml | 12 |
2 files changed, 16 insertions, 2 deletions
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 <replaceable>name</replaceable> ON <replaceable>table</replaceable> <para> Hash index operations are not presently WAL-logged, so hash indexes might need to be rebuilt with <command>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. </para> </caution> 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. </para> + <caution> + <para> + Hash index operations are not presently WAL-logged, + so hash indexes might need to be rebuilt with <command>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. + </para> + </caution> + <para> Currently, only the B-tree, GiST and GIN index methods support multicolumn indexes. Up to 32 fields can be specified by default. |