2003-09-22 02:16:58 +02:00
|
|
|
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_constraints.sgml,v 1.9 2003/09/22 00:16:58 petere Exp $ -->
|
2000-06-18 23:24:54 +02:00
|
|
|
<refentry id="SQL-SET-CONSTRAINTS">
|
|
|
|
<refmeta>
|
|
|
|
<refentrytitle id="SQL-SET-CONSTRAINTS-title">SET CONSTRAINTS</refentrytitle>
|
|
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
|
|
</refmeta>
|
2003-05-04 04:23:16 +02:00
|
|
|
|
2000-06-18 23:24:54 +02:00
|
|
|
<refnamediv>
|
|
|
|
<refname>SET CONSTRAINTS</refname>
|
2001-09-03 14:57:50 +02:00
|
|
|
<refpurpose>set the constraint mode of the current transaction</refpurpose>
|
2000-06-18 23:24:54 +02:00
|
|
|
</refnamediv>
|
2003-05-04 04:23:16 +02:00
|
|
|
|
2003-08-31 19:32:24 +02:00
|
|
|
<indexterm zone="sql-set-constraints">
|
|
|
|
<primary>SET CONSTRAINTS</primary>
|
|
|
|
</indexterm>
|
|
|
|
|
2000-06-18 23:24:54 +02:00
|
|
|
<refsynopsisdiv>
|
2003-05-04 04:23:16 +02:00
|
|
|
<synopsis>
|
2003-09-22 02:16:58 +02:00
|
|
|
SET CONSTRAINTS { ALL | <replaceable class="parameter">name</replaceable> [, ...] } { DEFERRED | IMMEDIATE }
|
2003-05-04 04:23:16 +02:00
|
|
|
</synopsis>
|
2000-06-18 23:24:54 +02:00
|
|
|
</refsynopsisdiv>
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>Description</title>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
<command>SET CONSTRAINTS</command> sets the behavior of constraint
|
2003-05-04 04:23:16 +02:00
|
|
|
evaluation in the current transaction. In
|
|
|
|
<literal>IMMEDIATE</literal> mode, constraints are checked at the
|
|
|
|
end of each statement. In <literal>DEFERRED</literal> mode,
|
|
|
|
constraints are not checked until transaction commit.
|
2002-08-17 14:15:49 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2003-05-04 04:23:16 +02:00
|
|
|
When you change the mode of a constraint to be
|
|
|
|
<literal>IMMEDIATE</literal>, the new constraint mode takes effect
|
|
|
|
retroactively: any outstanding data modifications that would have
|
|
|
|
been checked at the end of the transaction (when using
|
|
|
|
<literal>DEFERRED</literal>) are instead checked during the
|
2002-08-17 14:15:49 +02:00
|
|
|
execution of the <command>SET CONSTRAINTS</command> command.
|
2000-06-18 23:24:54 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Upon creation, a constraint is always give one of three
|
2003-05-04 04:23:16 +02:00
|
|
|
characteristics: <literal>INITIALLY DEFERRED</literal>,
|
|
|
|
<literal>INITIALLY IMMEDIATE DEFERRABLE</literal>, or
|
|
|
|
<literal>INITIALLY IMMEDIATE NOT DEFERRABLE</literal>. The third
|
2000-06-18 23:24:54 +02:00
|
|
|
class is not affected by the <command>SET CONSTRAINTS</command>
|
|
|
|
command.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Currently, only foreign key constraints are affected by this
|
|
|
|
setting. Check and unique constraints are always effectively
|
|
|
|
initially immediate not deferrable.
|
|
|
|
</para>
|
|
|
|
</refsect1>
|
|
|
|
|
2003-05-04 04:23:16 +02:00
|
|
|
<refsect1>
|
|
|
|
<title>Notes</title>
|
2000-07-14 17:27:14 +02:00
|
|
|
|
2003-05-04 04:23:16 +02:00
|
|
|
<para>
|
|
|
|
This command only alters the behavior of constraints within the
|
|
|
|
current transaction. Thus, if you execute this command outside of a
|
|
|
|
transaction block
|
|
|
|
(<command>BEGIN</command>/<command>COMMIT</command> pair), it will
|
|
|
|
not appear to have any effect. If you wish to change the behavior
|
|
|
|
of a constraint without needing to issue a <command>SET
|
|
|
|
CONSTRAINTS</command> command in every transaction, specify
|
|
|
|
<literal>INITIALLY DEFERRED</literal> or <literal>INITIALLY
|
|
|
|
IMMEDIATE</literal> when you create the constraint.
|
|
|
|
</para>
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>Compatibility</title>
|
2000-07-14 17:27:14 +02:00
|
|
|
|
2003-05-04 04:23:16 +02:00
|
|
|
<para>
|
|
|
|
This command complies with the behavior defined in the SQL
|
2003-09-11 23:42:20 +02:00
|
|
|
standard, except for the limitation that, in
|
|
|
|
<productname>PostgreSQL</productname>, it only applies to
|
|
|
|
foreign-key constraints.
|
2003-05-04 04:23:16 +02:00
|
|
|
</para>
|
2000-06-18 23:24:54 +02:00
|
|
|
</refsect1>
|
|
|
|
</refentry>
|
2000-07-14 17:27:14 +02:00
|
|
|
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
|
|
Local variables:
|
|
|
|
mode:sgml
|
|
|
|
sgml-omittag:nil
|
|
|
|
sgml-shorttag:t
|
|
|
|
sgml-minimize-attributes:nil
|
|
|
|
sgml-always-quote-attributes:t
|
|
|
|
sgml-indent-step:1
|
|
|
|
sgml-indent-data:t
|
|
|
|
sgml-parent-document:nil
|
|
|
|
sgml-default-dtd-file:"../reference.ced"
|
|
|
|
sgml-exposed-tags:nil
|
|
|
|
sgml-local-catalogs:("/usr/lib/sgml/catalog")
|
|
|
|
sgml-local-ecat-files:nil
|
|
|
|
End:
|
|
|
|
-->
|