]> granicus.if.org Git - postgresql/commitdiff
Shorten warning about hash creation
authorBruce Momjian <bruce@momjian.us>
Sat, 18 Oct 2014 14:36:09 +0000 (10:36 -0400)
committerBruce Momjian <bruce@momjian.us>
Sat, 18 Oct 2014 14:36:09 +0000 (10:36 -0400)
Also document that PITR is also affected.

doc/src/sgml/ref/create_index.sgml
src/backend/commands/indexcmds.c
src/test/regress/expected/create_index.out
src/test/regress/expected/enum.out
src/test/regress/expected/macaddr.out
src/test/regress/expected/replica_identity.out
src/test/regress/expected/uuid.out

index e469b17e1687527f2fee63fe80cc89ef29fd4923..43df32f977a104eb5a5f6ecdc19ba606f64e79da 100644 (file)
@@ -474,7 +474,8 @@ Indexes:
     Also, changes to hash indexes are not replicated over streaming or
     file-based replication after the initial base backup, so they
     give wrong answers to queries that subsequently use them.
-    For these reasons, hash index use is presently discouraged.
+    Hash indexes are also not properly restored during point-in-time
+    recovery.  For these reasons, hash index use is presently discouraged.
    </para>
   </caution>
 
index 8a1cb4b818225db2bdd95e8480e9d61e8b0b7763..3c1e90eb0e9f40a4122c6f5d6c7367660a04a337 100644 (file)
@@ -491,7 +491,7 @@ DefineIndex(Oid relationId,
 
        if (strcmp(accessMethodName, "hash") == 0)
                ereport(WARNING,
-                               (errmsg("hash indexes are not WAL-logged and thus are not crash-safe and cannot be used on standby servers")));
+                               (errmsg("hash indexes are not WAL-logged and their use is discouraged")));
 
        if (stmt->unique && !accessMethodForm->amcanunique)
                ereport(ERROR,
index a2bef7acb9a8a96c0a9e96aedee09116f17f8647..8326e94250025da77569c34418992800d3f2a178 100644 (file)
@@ -2238,13 +2238,13 @@ DROP TABLE array_gin_test;
 -- HASH
 --
 CREATE INDEX hash_i4_index ON hash_i4_heap USING hash (random int4_ops);
-WARNING:  hash indexes are not WAL-logged and thus are not crash-safe and cannot be used on standby servers
+WARNING:  hash indexes are not WAL-logged and their use is discouraged
 CREATE INDEX hash_name_index ON hash_name_heap USING hash (random name_ops);
-WARNING:  hash indexes are not WAL-logged and thus are not crash-safe and cannot be used on standby servers
+WARNING:  hash indexes are not WAL-logged and their use is discouraged
 CREATE INDEX hash_txt_index ON hash_txt_heap USING hash (random text_ops);
-WARNING:  hash indexes are not WAL-logged and thus are not crash-safe and cannot be used on standby servers
+WARNING:  hash indexes are not WAL-logged and their use is discouraged
 CREATE INDEX hash_f8_index ON hash_f8_heap USING hash (random float8_ops);
-WARNING:  hash indexes are not WAL-logged and thus are not crash-safe and cannot be used on standby servers
+WARNING:  hash indexes are not WAL-logged and their use is discouraged
 -- CREATE INDEX hash_ovfl_index ON hash_ovfl_heap USING hash (x int4_ops);
 --
 -- Test functional index
index fa23b52e5527be765437c4dddb0e936164c9e540..1a61a5b0df22522ce012fdb10c2c8aa21b94f90b 100644 (file)
@@ -383,7 +383,7 @@ DROP INDEX enumtest_btree;
 -- Hash index / opclass with the = operator
 --
 CREATE INDEX enumtest_hash ON enumtest USING hash (col);
-WARNING:  hash indexes are not WAL-logged and thus are not crash-safe and cannot be used on standby servers
+WARNING:  hash indexes are not WAL-logged and their use is discouraged
 SELECT * FROM enumtest WHERE col = 'orange';
   col   
 --------
index 91edc5ab7aee45a737dac54785b11ab3d2c06e6c..8e41a4bbf3530bece31ad2a52964ce655c2ee106 100644 (file)
@@ -39,7 +39,7 @@ SELECT * FROM macaddr_data;
 
 CREATE INDEX macaddr_data_btree ON macaddr_data USING btree (b);
 CREATE INDEX macaddr_data_hash ON macaddr_data USING hash (b);
-WARNING:  hash indexes are not WAL-logged and thus are not crash-safe and cannot be used on standby servers
+WARNING:  hash indexes are not WAL-logged and their use is discouraged
 SELECT a, b, trunc(b) FROM macaddr_data ORDER BY 2, 1;
  a  |         b         |       trunc       
 ----+-------------------+-------------------
index 45df81ae485f9e965c9841d145d287498efcb4fd..e29e2fba674d050e62b6625f1f6157ff8c7c6b49 100644 (file)
@@ -11,7 +11,7 @@ CREATE INDEX test_replica_identity_keyab ON test_replica_identity (keya, keyb);
 CREATE UNIQUE INDEX test_replica_identity_keyab_key ON test_replica_identity (keya, keyb);
 CREATE UNIQUE INDEX test_replica_identity_nonkey ON test_replica_identity (keya, nonkey);
 CREATE INDEX test_replica_identity_hash ON test_replica_identity USING hash (nonkey);
-WARNING:  hash indexes are not WAL-logged and thus are not crash-safe and cannot be used on standby servers
+WARNING:  hash indexes are not WAL-logged and their use is discouraged
 CREATE UNIQUE INDEX test_replica_identity_expr ON test_replica_identity (keya, keyb, (3));
 CREATE UNIQUE INDEX test_replica_identity_partial ON test_replica_identity (keya, keyb) WHERE keyb != '3';
 -- default is 'd'/DEFAULT for user created tables
index 97c0ce30de34dc06bb7338a574676a97342c9f16..59cb1e0ba6f6c6533ed054b499ba2dbe9bf345f8 100644 (file)
@@ -114,7 +114,7 @@ SELECT COUNT(*) FROM guid1 WHERE guid_field >= '22222222-2222-2222-2222-22222222
 -- btree and hash index creation test
 CREATE INDEX guid1_btree ON guid1 USING BTREE (guid_field);
 CREATE INDEX guid1_hash  ON guid1 USING HASH  (guid_field);
-WARNING:  hash indexes are not WAL-logged and thus are not crash-safe and cannot be used on standby servers
+WARNING:  hash indexes are not WAL-logged and their use is discouraged
 -- unique index test
 CREATE UNIQUE INDEX guid1_unique_BTREE ON guid1 USING BTREE (guid_field);
 -- should fail