diff --git a/doc/src/sgml/ref/cluster.sgml b/doc/src/sgml/ref/cluster.sgml index 12f18623d77..756e1bc569b 100644 --- a/doc/src/sgml/ref/cluster.sgml +++ b/doc/src/sgml/ref/cluster.sgml @@ -1,5 +1,5 @@ @@ -99,6 +99,17 @@ CLUSTER Notes + + CLUSTER loses all visibility information of tuples, + which makes the table look empty to any snapshot that was taken + before the CLUSTER command finished. That makes + CLUSTER unsuitable for applications where + transactions that access the table being clustered are run concurrently + with CLUSTER. This is most visible with serializable + transactions, because they take only one snapshot at the beginning of the + transaction, but read-committed transactions are also affected. + + In cases where you are accessing single rows randomly within a table, the actual order of the data in the