Doc: document the current-transaction-modes GUCs.

We had documentation of default_transaction_isolation et al,
but for some reason not of transaction_isolation et al.
AFAICS this is just an ancient oversight, so repair.

Per bug #17077 from Yanliang Lei.

Discussion: https://postgr.es/m/17077-ade8e166a01e1374@postgresql.org

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 2661bfde4b8890d3a12c9d1bdb8c919328d9ee70..2a81c5f857c36299d2ecf4cf369a68fc434d243c 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -8150,6 +8150,68 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
       
      
 
+     
+      transaction_isolation (enum)
+      
+       transaction isolation level
+      
+      
+       transaction_isolation configuration parameter
+      
+      
+      
+       
+        This parameter reflects the current transaction's isolation level.
+        At the beginning of each transaction, it is set to the current value
+        of .
+        Any subsequent attempt to change it is equivalent to a 
+        linkend="sql-set-transaction"/> command.
+       
+      
+     
+
+     
+      transaction_read_only (boolean)
+      
+       read-only transaction
+       setting default
+      
+      
+       transaction_read_only configuration parameter
+      
+      
+      
+       
+        This parameter reflects the current transaction's read-only status.
+        At the beginning of each transaction, it is set to the current value
+        of .
+        Any subsequent attempt to change it is equivalent to a 
+        linkend="sql-set-transaction"/> command.
+       
+      
+     
+
+     
+      transaction_deferrable (boolean)
+      
+       deferrable transaction
+       setting default
+      
+      
+       transaction_deferrable configuration parameter
+      
+      
+      
+       
+        This parameter reflects the current transaction's deferrability status.
+        At the beginning of each transaction, it is set to the current value
+        of .
+        Any subsequent attempt to change it is equivalent to a 
+        linkend="sql-set-transaction"/> command.
+       
+      
+     
+
 
      
       session_replication_role (enum)


diff --git a/doc/src/sgml/ref/set_transaction.sgml b/doc/src/sgml/ref/set_transaction.sgml

index ec436b2d163efb333173856cebd4558aa55c96c9..e062e2461e1f61daa5c6ab4aa87cae3a0d9f1887 100644 (file)

--- a/doc/src/sgml/ref/set_transaction.sgml
+++ b/doc/src/sgml/ref/set_transaction.sgml
@@ -202,7 +202,7 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa
   
 
   
-   The session default transaction modes can also be set by setting the
+   The session default transaction modes can also be set or examined via the
    configuration parameters ,
    , and
    .
@@ -212,6 +212,17 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa
    ALTER DATABASE, etc.  Consult 
    for more information.
   
+
+  
+   The current transaction's modes can similarly be set or examined via the
+   configuration parameters ,
+   , and
+   .  Setting one of these
+   parameters acts the same as the corresponding SET
+   TRANSACTION option, with the same restrictions on when it can
+   be done.  However, these parameters cannot be set in the configuration
+   file, or from any source other than live SQL.
+  
  
 
  




This is the main PostgreSQL git repository.
RSS
Atom

diff --git a/doc/src/sgml/ref/set_transaction.sgml b/doc/src/sgml/ref/set_transaction.sgml
index ec436b2d163efb333173856cebd4558aa55c96c9..e062e2461e1f61daa5c6ab4aa87cae3a0d9f1887 100644 (file)
--- a/doc/src/sgml/ref/set_transaction.sgml
+++ b/doc/src/sgml/ref/set_transaction.sgml
@@ -202,7 +202,7 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa
   
 
   
-   The session default transaction modes can also be set by setting the
+   The session default transaction modes can also be set or examined via the
    configuration parameters ,
    , and
    .
@@ -212,6 +212,17 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa
    ALTER DATABASE, etc.  Consult 
    for more information.
   
+
+  
+   The current transaction's modes can similarly be set or examined via the
+   configuration parameters ,
+   , and
+   .  Setting one of these
+   parameters acts the same as the corresponding SET
+   TRANSACTION option, with the same restrictions on when it can
+   be done.  However, these parameters cannot be set in the configuration
+   file, or from any source other than live SQL.
+