<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/reset.sgml,v 1.15 2002/09/21 18:32:54 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/reset.sgml,v 1.16 2002/10/09 04:59:38 momjian Exp $
PostgreSQL documentation
-->
switches, or per-database or per-user default settings. See the
<citetitle>Administrator's Guide</citetitle> for details.
</para>
+
+ <para>
+ See the <command>SHOW</> manual page for details on the transaction
+ behavior of <command>RESET</>.
+ </para>
+
</refsect1>
<refsect1>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/set.sgml,v 1.65 2002/09/21 18:32:54 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/set.sgml,v 1.66 2002/10/09 04:59:38 momjian Exp $
PostgreSQL documentation
-->
is committed) the <command>SET</command> value will take effect.
</para>
+ <para>
+ With <literal>autocommit</> set to <literal>off</>, <command>SET</>
+ does not start a new transaction block. See the
+ <literal>autocommit</> section of the documentation for details.
+ </para>
+
<para>
Here are additional details about a few of the parameters that can be set:
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.143 2002/10/03 02:26:49 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.144 2002/10/09 04:59:38 momjian Exp $
-->
<Chapter Id="runtime">
that is not inside an explicit transaction block (that is, unless a
<command>BEGIN</> with no matching <command>COMMIT</> has been
given).
- If set to false, <productname>PostgreSQL</productname> will commit
- the effects of commands only on receiving an explicit
- <command>COMMIT</> command. This mode can also be thought of as
- implicitly issuing <command>BEGIN</> whenever a command is received
- and <productname>PostgreSQL</productname> is not already inside
- a transaction block.
- The default is true, for compatibility with historical
- <productname>PostgreSQL</productname> behavior. But for maximum
- compatibility with the SQL specification, set it to false.
- </para>
+ If set to false, <productname>PostgreSQL</productname> will
+ commit the commands only when receiving an explicit
+ <command>COMMIT</> command. This mode can also be thought of as
+ implicitly issuing <command>BEGIN</> whenever a command is
+ received that is not already inside a transaction block. The
+ default is true, for compatibility with historical
+ <productname>PostgreSQL</productname> behavior. However, for
+ maximum compatibility with the SQL specification, set it to
+ false.
+ </para>
+ <note>
+ <para>
+ With <varname>autocommit</> set to false, <command>SET</>,
+ <command>SHOW</>, and <command>RESET</> do not start new
+ transaction blocks. They are run in their own transactions.
+ Once another command is issued, multi-statement transaction
+ behavior begins and any <command>SET</>, <command>SHOW</>, or
+ <command>RESET</> commands are considered to be part of the
+ transaction, i.e. they are committed or rolled back depending
+ on the completion status of the transaction. To have
+ <command>SET</>, <command>SHOW</>, and <command>RESET</>
+ commands at the start of a transaction, use <command>BEGIN</>
+ first.
+ </para>
+ </note>
+
</listitem>
</varlistentry>
*
*
* IDENTIFICATION
- * $Header: /cvsroot/pgsql/src/backend/tcop/postgres.c,v 1.299 2002/10/08 17:17:19 tgl Exp $
+ * $Header: /cvsroot/pgsql/src/backend/tcop/postgres.c,v 1.300 2002/10/09 04:59:38 momjian Exp $
*
* NOTES
* this is the "main" module of the postgres backend and
CommandDest whereToSendOutput = Debug;
extern int StatementTimeout;
+extern bool autocommit;
static bool dontExecute = false;
static List *pg_parse_query(StringInfo query_string, Oid *typev, int nargs);
static List *pg_analyze_and_rewrite(Node *parsetree);
static void start_xact_command(void);
-static void finish_xact_command(void);
+static void finish_xact_command(bool forceCommit);
static void SigHupHandler(SIGNAL_ARGS);
static void FloatExceptionHandler(SIGNAL_ARGS);
static const char *CreateCommandTag(Node *parsetree);
*/
if (isTransactionStmt)
{
- finish_xact_command();
+ finish_xact_command(false);
xact_started = false;
}
} /* end loop over queries generated from a
*/
if (lnext(parsetree_item) == NIL && xact_started)
{
- finish_xact_command();
+ /*
+ * Don't allow SET/SHOW/RESET to start a new transaction
+ * with autocommit off. We do this by forcing a COMMIT
+ * when these commands start a transaction.
+ */
+ if (autocommit ||
+ IsTransactionState() ||
+ (strcmp(commandTag, "SET") != 0 &&
+ strcmp(commandTag, "SHOW") != 0 &&
+ strcmp(commandTag, "RESET") != 0))
+ finish_xact_command(false);
+ else
+ finish_xact_command(true);
xact_started = false;
}
* will only happen if the querystring was empty.)
*/
if (xact_started)
- finish_xact_command();
+ finish_xact_command(false);
if (save_Log_duration)
{
}
static void
-finish_xact_command(void)
+finish_xact_command(bool forceCommit)
{
/* Invoke IMMEDIATE constraint triggers */
DeferredTriggerEndQuery();
/* Now commit the command */
elog(DEBUG1, "CommitTransactionCommand");
- CommitTransactionCommand(false);
+ CommitTransactionCommand(forceCommit);
#ifdef SHOW_MEMORY_STATS
/* Print mem stats at each commit for leak tracking */
if (!IsUnderPostmaster)
{
puts("\nPOSTGRES backend interactive interface ");
- puts("$Revision: 1.299 $ $Date: 2002/10/08 17:17:19 $\n");
+ puts("$Revision: 1.300 $ $Date: 2002/10/09 04:59:38 $\n");
}
/*
}
/* commit the function-invocation transaction */
- finish_xact_command();
+ finish_xact_command(false);
break;
/*