diff --git a/doc/src/sgml/ref/allfiles.sgml b/doc/src/sgml/ref/allfiles.sgml index 89a7ed52c06876b38803374150609c9e485b8977..aef598d8a3a1c34d5cb0ff74c3fc807ea3c3553b 100644 --- a/doc/src/sgml/ref/allfiles.sgml +++ b/doc/src/sgml/ref/allfiles.sgml @@ -1,5 +1,5 @@ <!-- -$Header: /cvsroot/pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.17 2000/04/08 05:11:03 tgl Exp $ +$Header: /cvsroot/pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.18 2000/04/14 15:17:28 thomas Exp $ Postgres documentation Complete list of usable sgml source files in this directory. --> @@ -50,6 +50,7 @@ Complete list of usable sgml source files in this directory. <!entity commit system "commit.sgml"> <!entity copyTable system "copy.sgml"> <!entity createAggregate system "create_aggregate.sgml"> +<!entity createConstraint system "create_constraint.sgml"> <!entity createDatabase system "create_database.sgml"> <!entity createFunction system "create_function.sgml"> <!entity createGroup system "create_group.sgml"> diff --git a/doc/src/sgml/ref/commands.sgml b/doc/src/sgml/ref/commands.sgml index 45f609647f0ce92e59ba2cb0cffd6c72132b47b3..28f7f0cbde5e8c79cfc3f327fe84e69b39cbf1d5 100644 --- a/doc/src/sgml/ref/commands.sgml +++ b/doc/src/sgml/ref/commands.sgml @@ -1,5 +1,5 @@ <!-- -$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/commands.sgml,v 1.24 2000/04/08 05:11:03 tgl Exp $ +$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/commands.sgml,v 1.25 2000/04/14 15:17:28 thomas Exp $ Postgres documentation --> @@ -24,6 +24,7 @@ Postgres documentation &commit; ©Table; &createAggregate; + &createConstraint; &createDatabase; &createFunction; &createGroup; diff --git a/doc/src/sgml/ref/create_constraint.sgml b/doc/src/sgml/ref/create_constraint.sgml new file mode 100644 index 0000000000000000000000000000000000000000..474b848a91bcd34516c1f79a0ca4c0a7793e98a3 --- /dev/null +++ b/doc/src/sgml/ref/create_constraint.sgml @@ -0,0 +1,150 @@ +<!-- +$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_constraint.sgml,v 1.1 2000/04/14 15:17:28 thomas Exp $ +Postgres documentation +--> + +<refentry id="SQL-CREATECONSTRAINT"> + <refmeta> + <refentrytitle id="sql-createconstraint-title"> + CREATE CONSTRAINT TRIGGER + </refentrytitle> + <refmiscinfo>SQL - Language Statements</refmiscinfo> + </refmeta> + <refnamediv> + <refname> + CREATE CONSTRAINT TRIGGER + </refname> + <refpurpose> + Create a trigger to support a constraint + </refpurpose> + </refnamediv> + <refsynopsisdiv> + <refsynopsisdivinfo> + <date>2000-04-13</date> + </refsynopsisdivinfo> + <synopsis> +CREATE CONSTRAINT TRIGGER <replaceable class="parameter">name</replaceable> + AFTER <replaceable class="parameter">events</replaceable> ON + <replaceable class="parameter">relation</replaceable> <replaceable class="parameter">constraint</replaceable> <replaceable class="parameter">attributes</replaceable> + FOR EACH ROW EXECUTE PROCEDURE <replaceable class="parameter">func</replaceable> '(' <replaceable class="parameter">args</replaceable> ')' + </synopsis> + + <refsect2 id="R2-SQL-CREATECONSTRAINT-1"> + <title> + Inputs + </title> + <para> + + <variablelist> + <varlistentry> + <term><replaceable class="PARAMETER">name</replaceable></term> + <listitem> + <para> + The name of the constraint trigger. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><replaceable class="PARAMETER">events</replaceable></term> + <listitem> + <para> + The event categories for which this trigger should be fired. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><replaceable class="PARAMETER">relation</replaceable></term> + <listitem> + <para> + Table name of the triggering relation. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><replaceable class="PARAMETER">constraint</replaceable></term> + <listitem> + <para> + Actual onstraint specification. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><replaceable class="PARAMETER">attributes</replaceable></term> + <listitem> + <para> + Contraint attributes. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><replaceable class="PARAMETER">func</replaceable>(<replaceable class="PARAMETER">args</replaceable>)</term> + <listitem> + <para> + Function to call as part of the trigger processing. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id="R2-SQL-CREATECONSTRAINT-2"> + <title> + Outputs + </title> + <para> + + <variablelist> + <varlistentry> + <term><computeroutput> +CREATE CONSTRAINT + </computeroutput></term> + <listitem> + <para> + Message returned if successful. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + </refsynopsisdiv> + + <refsect1 id="R1-SQL-CREATECONSTRAINT-1"> + <title> + Description + </title> + <para> + <command>CREATE CONSTRAINT TRIGGER</command> is used from inside of + <command>CREATE/ALTER TABLE</command> and by + <application>pg_dump</application> to create the special triggers for + referential integrity. + </para> + + <para> + It is not intended for general use. + </para> + </refsect1> +</refentry> + +<!-- 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: +--> diff --git a/doc/src/sgml/ref/set.sgml b/doc/src/sgml/ref/set.sgml index 76f65975474a748cb7e8f489c6a12fe92f5386b0..0628ed673a6cdf0dfaebae3f45b5b24ffab8dc29 100644 --- a/doc/src/sgml/ref/set.sgml +++ b/doc/src/sgml/ref/set.sgml @@ -1,5 +1,5 @@ <!-- -$Header: /cvsroot/pgsql/doc/src/sgml/ref/set.sgml,v 1.39 2000/04/11 17:23:35 momjian Exp $ +$Header: /cvsroot/pgsql/doc/src/sgml/ref/set.sgml,v 1.40 2000/04/14 15:17:28 thomas Exp $ Postgres documentation --> @@ -24,6 +24,7 @@ Postgres documentation </refsynopsisdivinfo> <synopsis> SET <replaceable class="PARAMETER">variable</replaceable> { TO | = } { <replaceable class="PARAMETER">value</replaceable> | '<replaceable class="PARAMETER">value</replaceable>' | DEFAULT } +SET CONSTRAINTS {ALL | <replaceable class="parameter">constraintlist</replaceable>} <replaceable>mode</replaceable> SET TIME ZONE { '<replaceable class="PARAMETER">timezone</replaceable>' | LOCAL | DEFAULT } SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE } </synopsis> @@ -92,7 +93,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE } </varlistentry> <varlistentry> - <term>DateStyle</term> + <term>DATESTYLE</term> <listitem> <para> Set the date/time representation style. Affects the output format, @@ -202,7 +203,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE } </varlistentry> <varlistentry> - <term>Seed</term> + <term>SEED</term> <listitem> <para> Sets the internal seed for the random number generator. @@ -243,14 +244,14 @@ SELECT setseed(<replaceable>value</replaceable>); <term>SERVER_ENCODING</term> <listitem> <para> - Sets the multi-byte server encoding + Sets the multi-byte server encoding to: <variablelist> <varlistentry> <term><replaceable class="parameter">value</replaceable></term> <listitem> <para> - Sets the multi-byte server encoding. + The identifying value for the server encoding. </para> </listitem> </varlistentry> @@ -265,6 +266,47 @@ SELECT setseed(<replaceable>value</replaceable>); </varlistentry> <varlistentry> + <term>CONSTRAINT</term> + <listitem> + <para> + SET CONSTRAINTS is the SQL3 specified command to change the + default behaviour of constraints with respect to deferring in the current + transaction. Allowed parameters are: + + <variablelist> + <varlistentry> + <term><replaceable class="parameter">constraintlist</replaceable></term> + <listitem> + <para> + Comma separated list of deferrable constraint names. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><replaceable class="parameter">mode</replaceable></term> + <listitem> + <para> + The constraint mode. Allowed values are + <option>DEFERRED</option> and <option>IMMEDIATE</option>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + + <para> + In deferred mode, the actual check of the constraint is held + back until either its mode is explicitly set to <option>IMMEDIATE</option>, + or until COMMIT. This is actually only done for foreign key + constraints, so it does not apply to UNIQUE or other + constraints. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>TIME ZONE</term> <term>TIMEZONE</term> <listitem> <para> @@ -862,7 +904,7 @@ SET VARIABLE </computeroutput></term> <listitem> <para> - Message returned if successfully. + Message returned if successful. </para> </listitem> </varlistentry>