diff --git a/doc/src/sgml/ref/set_transaction.sgml b/doc/src/sgml/ref/set_transaction.sgml index 2c57f45511b..f864bbf6a61 100644 --- a/doc/src/sgml/ref/set_transaction.sgml +++ b/doc/src/sgml/ref/set_transaction.sgml @@ -135,6 +135,17 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa among those listed. This is a high-level notion of read-only that does not prevent all writes to disk. + + + The DEFERRABLE transaction property has no effect + unless the transaction is also SERIALIZABLE and + READ ONLY. When all of these properties are set on a + transaction, the transaction may block when first acquiring its snapshot, + after which it is able to run without the normal overhead of a + SERIALIZABLE transaction and without any risk of + contributing to or being cancelled by a serialization failure. This mode + is well suited for long-running reports or backups. +