]> granicus.if.org Git - postgresql/commitdiff
doc: Update ALTER SEQUENCE claims about changes being nontransactional
authorPeter Eisentraut <peter_e@gmx.net>
Tue, 2 May 2017 14:34:49 +0000 (10:34 -0400)
committerPeter Eisentraut <peter_e@gmx.net>
Tue, 2 May 2017 14:34:49 +0000 (10:34 -0400)
Clarify that all changes except RESTART are transactional (since
1753b1b027035029c2a2a1649065762fafbf63f3).

Reported-by: Michael Paquier <michael.paquier@gmail.com>
doc/src/sgml/ref/alter_sequence.sgml

index 5c912ab892deb3c6a885dd10d26c268134e5aea2..3fb3400d6be2467a895b5c37863f4f59b2c71a7f 100644 (file)
@@ -180,6 +180,14 @@ ALTER SEQUENCE [ IF EXISTS ] <replaceable class="parameter">name</replaceable> S
         the start value that was recorded by <command>CREATE SEQUENCE</>
         or last set by <command>ALTER SEQUENCE START WITH</>.
        </para>
+
+       <para>
+        Like a <function>setval</function> call, a <literal>RESTART</literal>
+        operation on a sequence is never rolled back, to avoid blocking of
+        concurrent transactions that obtain numbers from the same sequence.
+        (The other clauses cause ordinary catalog updates that can be rolled
+        back.)
+       </para>
       </listitem>
      </varlistentry>
 
@@ -281,15 +289,6 @@ ALTER SEQUENCE [ IF EXISTS ] <replaceable class="parameter">name</replaceable> S
  <refsect1>
   <title>Notes</title>
 
-  <para>
-   To avoid blocking of concurrent transactions that obtain numbers from the
-   same sequence, <command>ALTER SEQUENCE</command>'s effects on the sequence
-   generation parameters are never rolled back; those changes take effect
-   immediately and are not reversible.  However, the <literal>OWNED BY</>,
-   <literal>OWNER TO</>, <literal>RENAME TO</>, and <literal>SET SCHEMA</>
-   clauses cause ordinary catalog updates that can be rolled back.
-  </para>
-
   <para>
    <command>ALTER SEQUENCE</command> will not immediately affect
    <function>nextval</> results in backends,