<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/abort.sgml,v 1.14 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/abort.sgml,v 1.15 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
<command>ABORT</command> rolls back the current transaction and causes
all the updates made by the transaction to be discarded.
This command is identical
- in behavior to the standard <acronym>SQL</acronym> command <command>ROLLBACK</command>,
+ in behavior to the standard <acronym>SQL</acronym> command
+ <xref linkend="SQL-ROLLBACK" endterm="SQL-ROLLBACK-TITLE">,
and is present only for historical reasons.
</para>
</refsect1>
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ROLLBACK</computeroutput></term>
- <listitem>
- <para>
- Message returned if successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>WARNING: ROLLBACK: no transaction in progress</computeroutput></term>
- <listitem>
- <para>
- If there is not any transaction currently in progress.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<para>
- Use <command>COMMIT</command> to successfully
- terminate a transaction.
+ Use <xref linkend="SQL-COMMIT" endterm="SQL-COMMIT-TITLE"> to
+ successfully terminate a transaction.
+ </para>
+
+ <para>
+ Issuing <command>ABORT</> when not inside a transaction does
+ no harm, but it will provoke a warning message.
</para>
</refsect1>
</para>
</refsect1>
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-begin" endterm="sql-begin-title"></member>
+ <member><xref linkend="sql-commit" endterm="sql-commit-title"></member>
+ <member><xref linkend="sql-rollback" endterm="sql-rollback-title"></member>
+ </simplelist>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_aggregate.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_aggregate.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
<para>
<command>ALTER AGGREGATE</command> changes the definition of an
- aggregate function. The only functionality is to rename the
- aggregate function.
+ aggregate function. The only currently available functionality is to
+ rename the aggregate function.
</para>
</refsect1>
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER AGGREGATE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_conversion.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_conversion.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
<para>
<command>ALTER CONVERSION</command> changes the definition of a
- conversion. The only functionality is to rename the conversion.
+ conversion. The only currently available functionality is to rename the
+ conversion.
</para>
</refsect1>
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER CONVERSION</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_database.sgml,v 1.8 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_database.sgml,v 1.9 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER DATABASE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the alteration was successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: database "dbname" does not exist</computeroutput></term>
- <listitem>
- <para>
- Error message returned if the specified database is not known
- to the system.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_domain.sgml,v 1.8 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_domain.sgml,v 1.9 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</indexterm>
<refsynopsisdiv>
- <refsynopsisdivinfo>
- <date>2002-11-27</date>
- </refsynopsisdivinfo>
<synopsis>
ALTER DOMAIN <replaceable class="PARAMETER">domain</replaceable>
{ SET DEFAULT <replaceable class="PARAMETER">value</replaceable> | DROP DEFAULT }
ALTER DOMAIN <replaceable class="PARAMETER">domain</replaceable>
OWNER TO <replaceable class="PARAMETER">new_owner</replaceable>
</synopsis>
-
- <refsect2 id="R2-SQL-ALTERDOMAIN-1">
- <refsect2info>
- <date>2002-11-27</date>
- </refsect2info>
- <title>
- Inputs
- </title>
- <para>
- <variablelist>
-
- <varlistentry>
- <term><replaceable class="PARAMETER"> domain </replaceable></term>
- <listitem>
- <para>
- The name (possibly schema-qualified) of an existing domain to
- alter.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><replaceable class="PARAMETER"> domain_constraint </replaceable></term>
- <listitem>
- <para>
- New domain constraint for the domain.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><replaceable class="PARAMETER"> constraint_name </replaceable></term>
- <listitem>
- <para>
- Name of an existing constraint to drop.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>CASCADE</term>
- <listitem>
- <para>
- Automatically drop objects that depend on the constraint.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>RESTRICT</term>
- <listitem>
- <para>
- Refuse to drop the constraint if there are any dependent
- objects. This is the default behavior.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><replaceable class="PARAMETER">new_owner</replaceable></term>
- <listitem>
- <para>
- The user name of the new owner of the domain.
- </para>
- </listitem>
- </varlistentry>
-
- </variablelist>
- </para>
- </refsect2>
-
- <refsect2 id="R2-SQL-ALTERDOMAIN-2">
- <refsect2info>
- <date>1998-04-15</date>
- </refsect2info>
- <title>
- Outputs
- </title>
- <para>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER DOMAIN</computeroutput></term>
- <listitem>
- <para>
- Message returned from domain alteration.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR</computeroutput></term>
- <listitem>
- <para>
- Message returned if domain is not available.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect2>
</refsynopsisdiv>
- <refsect1 id="R1-SQL-ALTERDOMAIN-1">
- <refsect1info>
- <date>2002-11-27</date>
- </refsect1info>
- <title>
- Description
- </title>
+ <refsect1>
+ <title>Description</title>
+
<para>
<command>ALTER DOMAIN</command> changes the definition of an existing domain.
There are several sub-forms:
</para>
</refsect1>
- <refsect1 id="R1-SQL-ALTERDOMAIN-2">
- <title>
- Usage
- </title>
+ <refsect1>
+ <title>Parameters</title>
+
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><replaceable class="PARAMETER"> domain </replaceable></term>
+ <listitem>
+ <para>
+ The name (possibly schema-qualified) of an existing domain to
+ alter.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="PARAMETER"> domain_constraint </replaceable></term>
+ <listitem>
+ <para>
+ New domain constraint for the domain.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="PARAMETER"> constraint_name </replaceable></term>
+ <listitem>
+ <para>
+ Name of an existing constraint to drop.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>CASCADE</term>
+ <listitem>
+ <para>
+ Automatically drop objects that depend on the constraint.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>RESTRICT</term>
+ <listitem>
+ <para>
+ Refuse to drop the constraint if there are any dependent
+ objects. This is the default behavior.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="PARAMETER">new_owner</replaceable></term>
+ <listitem>
+ <para>
+ The user name of the new owner of the domain.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
<para>
To add a NOT NULL constraint to a domain:
<programlisting>
</para>
</refsect1>
+ <refsect1>
+ <title>Compatibility</title>
+
+ <para>
+ The <command>ALTER DOMAIN</command> statement is compatible with SQL99,
+ except for the <literal>OWNER</> variant, which is a
+ <productname>PostgreSQL</productname> extension.
+ </para>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_function.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_function.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER FUNCTION</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_group.sgml,v 1.11 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_group.sgml,v 1.12 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER GROUP</computeroutput></term>
- <listitem>
- <para>
- Message returned if the alteration was successful.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<para>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_language.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_language.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER LANGUAGE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the alteration was successful.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Compatibility</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_opclass.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_opclass.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER OPERATOR CLASS</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Compatibility</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_schema.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_schema.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER SCHEMA</computeroutput></term>
- <listitem>
- <para>
- Message returned if the alteration was successful.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Compatibility</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.3 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.4 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</indexterm>
<refsynopsisdiv>
- <refsynopsisdivinfo>
- <date>1999-07-20</date>
- </refsynopsisdivinfo>
<synopsis>
ALTER SEQUENCE <replaceable class="parameter">seqname</replaceable> [ INCREMENT [ BY ] <replaceable class="parameter">increment</replaceable> ]
[ MINVALUE <replaceable class="parameter">minvalue</replaceable> | NO MINVALUE ] [ MAXVALUE <replaceable class="parameter">maxvalue</replaceable> | NO MAXVALUE ]
[ RESTART [ WITH ] <replaceable class="parameter">start</replaceable> ] [ CACHE <replaceable class="parameter">cache</replaceable> ] [ [ NO ] CYCLE ]
</synopsis>
-
- <refsect2 id="R2-SQL-ALTERSEQUENCE-1">
- <refsect2info>
- <date>1998-09-11</date>
- </refsect2info>
- <title>
- Inputs
- </title>
- <para>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>Description</title>
+
+ <para>
+ <command>ALTER SEQUENCE</command> changes the parameters of an existing
+ sequence generator. Any parameter not specifically set in the
+ <command>ALTER SEQUENCE</command> command retains its prior setting.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Parameters</title>
+
+ <para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">seqname</replaceable></term>
<listitem>
<para>
The optional <option>RESTART WITH
- <replaceable class="parameter">start</replaceable>
- clause</option> enables the sequence to re-begin anywhere.
+ <replaceable class="parameter">start</replaceable></option>
+ clause changes the current value of the sequence.
</para>
</listitem>
</varlistentry>
</varlistentry>
</variablelist>
</para>
- </refsect2>
-
- <refsect2 id="R2-SQL-ALTERSEQUENCE-2">
- <refsect2info>
- <date>1998-09-11</date>
- </refsect2info>
- <title>
- Outputs
- </title>
- <para>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>
-ALTER SEQUENCE
- </computeroutput></term>
- <listitem>
- <para>
- Message returned if the command is successful.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><computeroutput>
-ERROR: AlterSequence: MINVALUE (<replaceable class="parameter">start</replaceable>) can't be >= MAXVALUE (<replaceable class="parameter">max</replaceable>)
- </computeroutput></term>
- <listitem>
- <para>
- If the specified starting value is out of range.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><computeroutput>
-ERROR: AlterSequence: START value (<replaceable class="parameter">start</replaceable>) can't be < MINVALUE (<replaceable class="parameter">min</replaceable>)
- </computeroutput></term>
- <listitem>
- <para>
- If the specified starting value is out of range.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><computeroutput>
-ERROR: AlterSequence: MINVALUE (<replaceable class="parameter">min</replaceable>) can't be >= MAXVALUE (<replaceable class="parameter">max</replaceable>)
- </computeroutput></term>
- <listitem>
- <para>
- If the minimum and maximum values are inconsistent.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect2>
- </refsynopsisdiv>
+ </refsect1>
- <refsect1 id="R1-SQL-ALTERSEQUENCE-1">
- <title>
- Description
- </title>
-
- <para>
- See <xref linkend="SQL-CREATESEQUENCE"> for limitations, and uses
- of sequences.
- </para>
- </refsect1>
+ <refsect1>
+ <title>Examples</title>
- <refsect1 id="R1-SQL-ALTERSEQUENCE-2">
- <title>
- Usage
- </title>
<para>
Restart a sequence called <literal>serial</literal>, at 105:
</para>
</programlisting>
</refsect1>
- <refsect1 id="R1-SQL-ALTERSEQUENCE-5">
- <title>
- Notes
- </title>
+ <refsect1>
+ <title>Notes</title>
+
<para>
- To avoid blocking of concurrent transactions that obtain numbers from the same
- sequence, a nextval operation is never rolled back; that is, once a value has
- been fetched it is considered used, even if the transaction that did the nextval
- later aborts. This means that aborted transactions may leave unused "holes" in
- the sequence of assigned values. setval operations are never rolled back, either.
+ To avoid blocking of concurrent transactions that obtain numbers from the
+ same sequence, <command>ALTER SEQUENCE</command> is never rolled back;
+ the changes take effect immediately and are not reversible.
</para>
+
<para>
- <command>ALTER SEQUENCE</command> will not immediately affect backends, other than the
- current one, which have cached sequence values. They must use up all cached values
- prior to noticing the changed sequence parameters. The current backend will be
- immediatly affected.
+ <command>ALTER SEQUENCE</command> will not immediately affect
+ <literal>nextval</> results in backends,
+ other than the current one, that have preallocated (cached) sequence
+ values. They will use up all cached values prior to noticing the changed
+ sequence parameters. The current backend will be affected immediately.
</para>
</refsect1>
- <refsect1 id="R1-SQL-ALTERSEQUENCE-3">
+ <refsect1>
<title>
Compatibility
</title>
- <refsect2 id="R2-SQL-ALTERSEQUENCE-4">
- <refsect2info>
- <date>2003-03-02</date>
- </refsect2info>
+ <refsect2>
<title>
SQL99
</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.60 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.61 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER TABLE</computeroutput></term>
- <listitem>
- <para>
- Message returned if successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR</computeroutput></term>
- <listitem>
- <para>
- Message returned if table or column does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_trigger.sgml,v 1.5 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_trigger.sgml,v 1.6 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</refsect1>
<refsect1>
- <title>Parameter</title>
+ <title>Parameters</title>
<variablelist>
<varlistentry>
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER TRIGGER</computeroutput></term>
- <listitem>
- <para>
- Message returned if successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR</computeroutput></term>
- <listitem>
- <para>
- If the trigger does not exist, or the new name is a duplicate of
- another existing trigger on the table.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.29 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.30 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ALTER USER</computeroutput></term>
- <listitem>
- <para>
- Message returned if the alteration was successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: ALTER USER: user "username" does not exist</computeroutput></term>
- <listitem>
- <para>
- Error message returned if the specified user is not known to
- the database system.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/analyze.sgml,v 1.13 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/analyze.sgml,v 1.14 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ANALYZE</computeroutput></term>
- <listitem>
- <para>
- The command is complete.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/begin.sgml,v 1.25 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/begin.sgml,v 1.26 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
<title>Description</title>
<para>
- By default, <productname>PostgreSQL</productname> executes
- transactions in <quote>autocommit</quote> mode, that is, each
- statement is executed in its own transaction and a commit is
- implicitly performed at the end of the statement (if execution was
- successful, otherwise a rollback is done).
<command>BEGIN</command> initiates a transaction block, that is,
all statements after <command>BEGIN</command> command will be
executed in a single transaction until an explicit <xref
linkend="sql-commit" endterm="sql-commit-title"> or <xref
- linkend="sql-rollback" endterm="sql-rollback-title">. Statements
- are executed more quickly in a transaction block, because
+ linkend="sql-rollback" endterm="sql-rollback-title"> is given.
+ By default (without <command>BEGIN</command>),
+ <productname>PostgreSQL</productname> executes
+ transactions in <quote>autocommit</quote> mode, that is, each
+ statement is executed in its own transaction and a commit is
+ implicitly performed at the end of the statement (if execution was
+ successful, otherwise a rollback is done).
+ </para>
+
+ <para>
+ Statements are executed more quickly in a transaction block, because
transaction start/commit requires significant CPU and disk
activity. Execution of multiple statements inside a transaction is
- also useful to ensure consistency when changing several related
- tables: other sessions will be unable to see the intermediate states
+ also useful to ensure consistency when making several related changes:
+ other sessions will be unable to see the intermediate states
wherein not all the related updates have been done.
</para>
</refsect1>
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>BEGIN</computeroutput></term>
- <listitem>
- <para>
- This signifies that a new transaction has been started.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>WARNING: BEGIN: already a transaction in progress</computeroutput></term>
- <listitem>
- <para>
- This indicates that a transaction was already in progress. The
- current transaction is not affected.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<para>
Use <xref linkend="SQL-COMMIT" endterm="SQL-COMMIT-TITLE"> or
<xref linkend="SQL-ROLLBACK" endterm="SQL-ROLLBACK-TITLE">
- to terminate a transaction.
+ to terminate a transaction block.
+ </para>
+
+ <para>
+ Issuing <command>BEGIN</> when already inside a transaction block will
+ provoke a warning message. The state of the transaction is not affected.
</para>
</refsect1>
about the transaction semantics when porting database applications.
</para>
</refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-commit" endterm="sql-commit-title"></member>
+ <member><xref linkend="sql-rollback" endterm="sql-rollback-title"></member>
+ </simplelist>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/close.sgml,v 1.17 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/close.sgml,v 1.18 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
<para>
Every non-holdable open cursor is implicitly closed when a
transaction is terminated by <command>COMMIT</command> or
- <command>ROLLBACK</command>. Holdable cursors are implicitely
- closed if the transaction that created them aborts via
- <command>ROLLBACK</command>; if this does not happen, the holdable
+ <command>ROLLBACK</command>. A holdable cursor is implicitly
+ closed if the transaction that created it aborts via
+ <command>ROLLBACK</command>. If the creating transaction successfully
+ commits, the holdable
cursor remains open until an explicit <command>CLOSE</command> is
executed, or the client disconnects.
</para>
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CLOSE CURSOR</computeroutput></term>
- <listitem>
- <para>
- Message returned if the cursor is successfully closed.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: cursor "<replaceable class="PARAMETER">cursor</replaceable>" does not exist</computeroutput></term>
- <listitem>
- <para>
- Message returned if <replaceable
- class="PARAMETER">cursor</replaceable> is not declared or has
- already been closed.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/cluster.sgml,v 1.27 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/cluster.sgml,v 1.28 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CLUSTER</computeroutput></term>
- <listitem>
- <para>
- The clustering was done successfully.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/clusterdb.sgml,v 1.12 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/clusterdb.sgml,v 1.13 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
library will apply.
</para>
+ <para>
+ In case of difficulty, see <xref linkend="SQL-CLUSTER"
+ endterm="sql-cluster-title"> and <xref linkend="APP-PSQL"> for
+ discussions of potential problems and error messages.
+ </para>
+
</refsect1>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <para>
- <variablelist>
- <varlistentry>
- <term><computeroutput>CLUSTER</computeroutput></term>
- <listitem>
- <para>
- The database was successfully clustered.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>clusterdb: Cluster failed.</computeroutput></term>
- <listitem>
- <para>
- Something went wrong. <application>clusterdb</application> is only a wrapper
- script. See <xref linkend="SQL-CLUSTER" endterm="sql-cluster-title">
- and <xref linkend="APP-PSQL"> for a detailed
- discussion of error messages and potential problems.
- </para>
- </listitem>
- </varlistentry>
-
- </variablelist>
- </para>
- </refsect1>
-
-
<refsect1>
<title>Environment</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/comment.sgml,v 1.22 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/comment.sgml,v 1.23 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>COMMENT</computeroutput></term>
- <listitem>
- <para>
- Message returned if the comment was successfully changed.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/commit.sgml,v 1.16 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/commit.sgml,v 1.17 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>COMMIT</computeroutput></term>
- <listitem>
- <para>
- Message returned if the transaction was successfully committed.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>WARNING: COMMIT: no transaction in progress</computeroutput></term>
- <listitem>
- <para>
- Message if there is no transaction in progress.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Notes</title>
Use <xref linkend="SQL-ROLLBACK" endterm="SQL-ROLLBACK-TITLE"> to
abort a transaction.
</para>
+
+ <para>
+ Issuing <command>COMMIT</> when not inside a transaction does
+ no harm, but it will provoke a warning message.
+ </para>
</refsect1>
<refsect1>
WORK</literal>. Otherwise, this command is fully conforming.
</para>
</refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-begin" endterm="sql-begin-title"></member>
+ <member><xref linkend="sql-rollback" endterm="sql-rollback-title"></member>
+ </simplelist>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/copy.sgml,v 1.48 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/copy.sgml,v 1.49 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>COPY</computeroutput></term>
- <listitem>
- <para>
- The copy operation completed successfully.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_aggregate.sgml,v 1.27 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_aggregate.sgml,v 1.28 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
written in any order, not just the order illustrated above.
</para>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE AGGREGATE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command completes successfully.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Examples</title>
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_cast.sgml,v 1.12 2003/08/31 17:32:21 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_cast.sgml,v 1.13 2003/09/09 18:28:52 tgl Exp $ -->
<refentry id="SQL-CREATECAST">
<refmeta>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE CAST</computeroutput></term>
- <listitem>
- <para>
- Message returned if the cast was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1 id="sql-createcast-notes">
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_constraint.sgml,v 1.10 2003/08/31 17:32:21 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_constraint.sgml,v 1.11 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE TRIGGER</computeroutput></term>
- <listitem>
- <para>
- Message returned if successful.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_conversion.sgml,v 1.11 2003/08/31 17:32:21 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_conversion.sgml,v 1.12 2003/09/09 18:28:52 tgl Exp $ -->
<refentry id="SQL-CREATECONVERSION">
<refmeta>
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE CONVERSION</computeroutput></term>
- <listitem>
- <para>
- Message returned if the conversion was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1 id="sql-createconversion-notes">
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_domain.sgml,v 1.14 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_domain.sgml,v 1.15 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE DOMAIN</computeroutput></term>
- <listitem>
- <para>
- Message returned if the domain was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.49 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.50 2003/09/09 18:28:52 tgl Exp $
-->
<refentry id="SQL-CREATEFUNCTION">
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE FUNCTION</computeroutput></term>
- <listitem>
- <para>
- Message returned if the function was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1 id="sql-createfunction-notes">
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_group.sgml,v 1.12 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_group.sgml,v 1.13 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE GROUP</computeroutput></term>
- <listitem>
- <para>
- Message returned if the group was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_index.sgml,v 1.40 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_index.sgml,v 1.41 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE INDEX</computeroutput></term>
- <listitem>
- <para>
- Message returned if the index was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_language.sgml,v 1.34 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_language.sgml,v 1.35 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1 id="sql-createlanguage-diagnostics">
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE LANGUAGE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the language was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1 id="sql-createlanguage-notes">
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_opclass.sgml,v 1.9 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_opclass.sgml,v 1.10 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
clauses may appear in any order.
</para>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE OPERATOR CLASS</computeroutput></term>
- <listitem>
- <para>
- Message returned if the operator class was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.37 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.38 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</programlisting>
</para>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE OPERATOR</computeroutput></term>
- <listitem>
- <para>
- Message returned if the operator was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_rule.sgml,v 1.40 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_rule.sgml,v 1.41 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</para>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE RULE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the rule was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_schema.sgml,v 1.7 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_schema.sgml,v 1.8 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE SCHEMA</computeroutput></term>
- <listitem>
- <para>
- Message returned if the schema was successfully created.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: namespace "<replaceable class="parameter">schemaname</replaceable>" already exists</computeroutput></term>
- <listitem>
- <para>
- Message returned if the schema specified already exists.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.71 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.72 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
-
- <refsect1 id="SQL-CREATETABLE-diagnostics">
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE TABLE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the table was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
-
<refsect1 id="SQL-CREATETABLE-notes">
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.15 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.16 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <para>
- Refer to <xref linkend="sql-createtable"
- endterm="sql-createtable-title">, <xref linkend="sql-select"
- endterm="sql-select-title">, and <xref linkend="sql-execute"
- endterm="sql-execute-title"> for a summary of possible output
- messages.
- </para>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.35 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.36 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE TRIGGER</computeroutput></term>
- <listitem>
- <para>
- Message returned if the trigger was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1 id="SQL-CREATETRIGGER-notes">
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_type.sgml,v 1.44 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_type.sgml,v 1.45 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE TYPE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the type was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1 id="SQL-CREATETYPE-notes">
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_user.sgml,v 1.27 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_user.sgml,v 1.28 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>CREATE USER</computeroutput></term>
- <listitem>
- <para>
- Message returned if the user account was successfully created.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/deallocate.sgml,v 1.3 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/deallocate.sgml,v 1.4 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DEALLOCATE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the prepared statement was deallocated successfully.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Compatibility</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_aggregate.sgml,v 1.24 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_aggregate.sgml,v 1.25 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP AGGREGATE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: RemoveAggregate: aggregate '<replaceable class="parameter">name</replaceable>' for type <replaceable class="parameter">type</replaceable> does not exist</computeroutput></term>
- <listitem>
- <para>
- This message is returned if the specified aggregate function
- does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_domain.sgml,v 1.11 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_domain.sgml,v 1.12 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP DOMAIN</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: RemoveDomain: type '<replaceable class="parameter">domainname</replaceable>' does not exist</computeroutput></term>
- <listitem>
- <para>
- This message occurs if the specified domain does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1 id="SQL-DROPDOMAIN-examples">
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_function.sgml,v 1.26 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_function.sgml,v 1.27 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP FUNCTION</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command completes successfully.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>WARNING: RemoveFunction: Function <replaceable class="parameter">name</replaceable> (<replaceable class="parameter">types</replaceable>) does not exist</computeroutput></term>
- <listitem>
- <para>
- This message is output if the function specified does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1 id="SQL-DROPFUNCTION-examples">
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.6 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.7 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP GROUP</computeroutput></term>
- <listitem>
- <para>
- Message returned if the group was successfully removed.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_index.sgml,v 1.19 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_index.sgml,v 1.20 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP INDEX</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command completes successfully.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: index "<replaceable class="PARAMETER">name</replaceable>" does not exist</computeroutput></term>
- <listitem>
- <para>
- This message is returned if <replaceable
- class="PARAMETER">name</replaceable> is not an existing
- index.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_language.sgml,v 1.18 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_language.sgml,v 1.19 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP LANGUAGE</computeroutput></term>
- <listitem>
- <para>
- This message is returned if the language was successfully dropped.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: Language "<replaceable class="parameter">name</replaceable>" doesn't exist</computeroutput></term>
- <listitem>
- <para>
- This message is returned if a language called <replaceable
- class="parameter">name</replaceable> is not found in the
- database.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_opclass.sgml,v 1.5 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_opclass.sgml,v 1.6 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP OPERATOR CLASS</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_operator.sgml,v 1.20 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_operator.sgml,v 1.21 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP OPERATOR</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: RemoveOperator: binary operator '<replaceable class="PARAMETER">name</replaceable>' taking '<replaceable class="PARAMETER">lefttype</replaceable>' and '<replaceable class="PARAMETER">righttype</replaceable>' does not exist</computeroutput></term>
- <listitem>
- <para>
- This message is returned if the specified binary operator does not exist.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: RemoveOperator: left unary operator '<replaceable class="PARAMETER">name</replaceable>' taking '<replaceable class="PARAMETER">lefttype</replaceable>' does not exist</computeroutput></term>
- <listitem>
- <para>
- This message is returned if the specified left unary operator
- does not exist.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: RemoveOperator: right unary operator '<replaceable class="PARAMETER">name</replaceable>' taking '<replaceable class="PARAMETER">righttype</replaceable>' does not exist</computeroutput></term>
- <listitem>
- <para>
- This message is returned if the specified right unary operator
- does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_rule.sgml,v 1.18 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_rule.sgml,v 1.19 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP RULE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: Rule "<replaceable class="parameter">name</replaceable>" not found</computeroutput></term>
- <listitem>
- <para>
- Message if the specified rule does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_schema.sgml,v 1.4 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_schema.sgml,v 1.5 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP SCHEMA</computeroutput></term>
- <listitem>
- <para>
- Message returned if the schema was successfully dropped.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: Schema "<replaceable class="parameter">name</replaceable>" does not exist</computeroutput></term>
- <listitem>
- <para>
- This message is returned if the specified schema does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_sequence.sgml,v 1.18 2003/08/31 17:32:22 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_sequence.sgml,v 1.19 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP SEQUENCE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the sequence was successfully dropped.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: sequence "<replaceable class="parameter">name</replaceable>" does not exist</computeroutput></term>
- <listitem>
- <para>
- Message returned if the specified sequence does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_table.sgml,v 1.19 2003/08/31 17:32:23 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_table.sgml,v 1.20 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP TABLE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command completes successfully.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: table "<replaceable class="parameter">name</replaceable>" does not exist</computeroutput></term>
- <listitem>
- <para>
- Message returned if the specified table does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_trigger.sgml,v 1.16 2003/08/31 17:32:23 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_trigger.sgml,v 1.17 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP TRIGGER</computeroutput></term>
- <listitem>
- <para>
- Message returned if the trigger was successfully dropped.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: DropTrigger: there is no trigger <replaceable class="PARAMETER">name</replaceable> on relation "<replaceable class="parameter">table</replaceable>"</computeroutput></term>
- <listitem>
- <para>
- Message returned if the specified trigger does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1 id="SQL-DROPTRIGGER-examples">
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_type.sgml,v 1.22 2003/08/31 17:32:23 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_type.sgml,v 1.23 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP TYPE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: RemoveType: type '<replaceable class="parameter">typename</replaceable>' does not exist</computeroutput></term>
- <listitem>
- <para>
- Message returned if the specified type does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1 id="SQL-DROPTYPE-examples">
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_view.sgml,v 1.18 2003/08/31 17:32:23 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_view.sgml,v 1.19 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>DROP VIEW</computeroutput></term>
- <listitem>
- <para>
- Message returned if the command was successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>ERROR: view <replaceable class="parameter">name</replaceable> does not exist</computeroutput></term>
- <listitem>
- <para>
- Message returned if the specified view does not exist.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/explain.sgml,v 1.28 2003/09/08 22:33:13 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/explain.sgml,v 1.29 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <para>
- <command>EXPLAIN</command> prints the execution plan of the
- specified statement from the <productname>PostgreSQL</productname>
- planner.
- </para>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/fetch.sgml,v 1.31 2003/08/31 17:32:23 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/fetch.sgml,v 1.32 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ERROR: cursor "<replaceable class="PARAMETER">cursor</replaceable>" does not exist</computeroutput></term>
- <listitem>
- <para>
- There is no cursor with the specified name.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/lock.sgml,v 1.36 2003/08/31 17:32:23 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/lock.sgml,v 1.37 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>LOCK TABLE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the lock was successfully acquired.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/notify.sgml,v 1.21 2003/08/31 17:32:23 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/notify.sgml,v 1.22 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>NOTIFY</computeroutput></term>
- <listitem>
- <para>
- Message returned when the commmand has executed.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/prepare.sgml,v 1.6 2003/08/31 17:32:24 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/prepare.sgml,v 1.7 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>PREPARE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the statement has been prepared successfully.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/reindex.sgml,v 1.18 2003/08/31 17:32:24 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/reindex.sgml,v 1.19 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>REINDEX</computeroutput></term>
- <listitem>
- <para>
- Message returned if the indexes were successfully recreated.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/reset.sgml,v 1.21 2003/08/31 17:32:24 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/reset.sgml,v 1.22 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <para>
- See under the <xref linkend="sql-set" endterm="sql-set-title">.
- </para>
- </refsect1>
-
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/rollback.sgml,v 1.15 2003/08/31 17:32:24 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/rollback.sgml,v 1.16 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ROLLBACK</computeroutput></term>
- <listitem>
- <para>
- Message returned if successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>WARNING: ROLLBACK: no transaction in progress</computeroutput></term>
- <listitem>
- <para>
- If there is not any transaction currently in progress.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
Use <xref linkend="SQL-COMMIT" endterm="SQL-COMMIT-TITLE"> to
successfully terminate a transaction.
</para>
+
+ <para>
+ Issuing <command>ROLLBACK</> when not inside a transaction does
+ no harm, but it will provoke a warning message.
+ </para>
</refsect1>
<refsect1>
WORK</literal>. Otherwise, this command is fully conforming.
</para>
</refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-begin" endterm="sql-begin-title"></member>
+ <member><xref linkend="sql-commit" endterm="sql-commit-title"></member>
+ </simplelist>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/select_into.sgml,v 1.23 2003/08/31 17:32:24 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/select_into.sgml,v 1.24 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</para>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <para>
- Refer to
- <xref linkend="sql-createtable" endterm="sql-createtable-title">
- and
- <xref linkend="sql-select" endterm="sql-select-title">
- for a summary of possible output messages.
- </para>
- </refsect1>
-
<refsect1>
<title>Notes</title>
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_transaction.sgml,v 1.15 2003/08/31 17:32:24 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_transaction.sgml,v 1.16 2003/09/09 18:28:53 tgl Exp $ -->
<refentry id="SQL-SET-TRANSACTION">
<refmeta>
<refentrytitle id="SQL-SET-TRANSACTION-TITLE">SET TRANSACTION</refentrytitle>
<title>Compatibility</title>
<para>
- Both commands are defined in the SQL standard.
+ Both commands are defined in the <acronym>SQL</acronym> standard.
<literal>SERIALIZABLE</literal> is the default transaction
- isolation level in <acronym>SQL</acronym>; in PostgreSQL it is
- <literal>READ COMMITED</literal>, but you can change it as
+ isolation level in the standard; in PostgreSQL the default is
+ ordinarily <literal>READ COMMITTED</literal>, but you can change it as
described above. <productname>PostgreSQL</productname> does not
provide the isolation levels <literal>READ UNCOMMITTED</literal>
and <literal>REPEATABLE READ</literal>. Because of multiversion
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.31 2003/08/31 17:32:24 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.32 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>ERROR: Option '<replaceable>name</replaceable>' is not recognized</computeroutput></term>
- <listitem>
- <para>
- Message returned if <replaceable>name</replaceable> does not
- stand for a known parameter.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/start_transaction.sgml,v 1.6 2003/08/31 17:32:24 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/start_transaction.sgml,v 1.7 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</para>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>START TRANSACTION</computeroutput></term>
- <listitem>
- <para>
- Message returned if successful.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><computeroutput>WARNING: BEGIN: already a transaction in progress</computeroutput></term>
- <listitem>
- <para>
- Message returned if there was already a transaction in progress
- when the command was issued.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Compatibility</title>
endterm="sql-set-transaction-title">.
</para>
</refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-begin" endterm="sql-begin-title"></member>
+ <member><xref linkend="sql-commit" endterm="sql-commit-title"></member>
+ <member><xref linkend="sql-rollback" endterm="sql-rollback-title"></member>
+ <member><xref linkend="sql-set-transaction" endterm="sql-set-transaction-title"></member>
+ </simplelist>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/truncate.sgml,v 1.11 2003/08/31 17:32:24 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/truncate.sgml,v 1.12 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</varlistentry>
</variablelist>
</refsect1>
-
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>TRUNCATE TABLE</computeroutput></term>
- <listitem>
- <para>
- Message returned if the table was successfully truncated.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
<refsect1>
<title>Examples</title>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/unlisten.sgml,v 1.22 2003/08/31 17:32:24 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/unlisten.sgml,v 1.23 2003/09/09 18:28:53 tgl Exp $
PostgreSQL documentation
-->
</variablelist>
</refsect1>
- <refsect1>
- <title>Diagnostics</title>
-
- <variablelist>
- <varlistentry>
- <term><computeroutput>UNLISTEN</computeroutput></term>
- <listitem>
- <para>
- Message returned when the command has executed.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
<refsect1>
<title>Notes</title>
<para>
- You unlisten something you were not listening for; no warning or error will appear.
+ You may unlisten something you were not listening for; no warning or error
+ will appear.
</para>
<para>
- At the end of each session, <command>UNLISTEN *</command> ist
+ At the end of each session, <command>UNLISTEN *</command> is
automatically executed.
</para>
</refsect1>
projects / postgresql / commitdiff