mirror of
https://github.com/postgres/postgres.git
synced 2025-12-21 05:21:08 +03:00
Separated set constraints and set transaction reference pages, revised set
reference page to new configuration system. Big update to administrator's guide, chapters Runtime environment, Client authentication, and User management, the latter two were part of the old Security chapter.
This commit is contained in:
Peter Eisentraut
@@ -1,5 +1,5 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.18 2000/04/14 15:17:28 thomas Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.19 2000/06/18 21:24:51 petere Exp $
|
||||
Postgres documentation
|
||||
Complete list of usable sgml source files in this directory.
|
||||
-->
|
||||
@@ -98,6 +98,8 @@ Complete list of usable sgml source files in this directory.
|
||||
<!entity select system "select.sgml">
|
||||
<!entity selectInto system "select_into.sgml">
|
||||
<!entity set system "set.sgml">
|
||||
<!entity setConstraints system "set_constraints.sgml">
|
||||
<!entity setTransaction system "set_transaction.sgml">
|
||||
<!entity show system "show.sgml">
|
||||
<!entity truncate system "truncate.sgml">
|
||||
<!entity unlisten system "unlisten.sgml">
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/commands.sgml,v 1.25 2000/04/14 15:17:28 thomas Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/commands.sgml,v 1.26 2000/06/18 21:24:51 petere Exp $
|
||||
Postgres documentation
|
||||
-->
|
||||
|
||||
@@ -72,6 +72,8 @@ Postgres documentation
|
||||
&select;
|
||||
&selectInto;
|
||||
&set;
|
||||
&setConstraints;
|
||||
&setTransaction;
|
||||
&show;
|
||||
&truncate;
|
||||
&unlisten;
|
||||
|
||||
@@ -1,47 +1,32 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/reset.sgml,v 1.8 2000/04/08 02:39:02 tgl Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/reset.sgml,v 1.9 2000/06/18 21:24:51 petere Exp $
|
||||
Postgres documentation
|
||||
-->
|
||||
|
||||
<refentry id="SQL-RESET">
|
||||
<refmeta>
|
||||
<refentrytitle id="SQL-RESET-TITLE">
|
||||
RESET
|
||||
</refentrytitle>
|
||||
<refentrytitle id="SQL-RESET-TITLE">RESET</refentrytitle>
|
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
||||
</refmeta>
|
||||
<refnamediv>
|
||||
<refname>
|
||||
RESET
|
||||
</refname>
|
||||
<refpurpose>
|
||||
Restores run-time parameters for session to default values
|
||||
</refpurpose>
|
||||
<refname>RESET</refname>
|
||||
<refpurpose>Restores run-time parameters to default values</refpurpose>
|
||||
</refnamediv>
|
||||
<refsynopsisdiv>
|
||||
<refsynopsisdivinfo>
|
||||
<date>1999-07-20</date>
|
||||
</refsynopsisdivinfo>
|
||||
<synopsis>
|
||||
RESET <replaceable class="PARAMETER">variable</replaceable>
|
||||
</synopsis>
|
||||
|
||||
<refsect2 id="R2-SQL-RESET-1">
|
||||
<refsect2info>
|
||||
<date>1998-09-24</date>
|
||||
</refsect2info>
|
||||
<title>
|
||||
Inputs
|
||||
</title>
|
||||
<title>Inputs</title>
|
||||
<para>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><replaceable class="PARAMETER">variable</replaceable></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Refer to
|
||||
<xref linkend="sql-set-title" endterm="sql-set-title">
|
||||
for more information on available variables.
|
||||
The name of a run-time parameter. See <xref
|
||||
linkend="sql-set-title" endterm="sql-set-title"> for a list.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@@ -49,107 +34,55 @@ RESET <replaceable class="PARAMETER">variable</replaceable>
|
||||
</para>
|
||||
</refsect2>
|
||||
|
||||
<refsect2 id="R2-SQL-RESET-2">
|
||||
<refsect2info>
|
||||
<date>1998-09-24</date>
|
||||
</refsect2info>
|
||||
<title>
|
||||
Outputs
|
||||
</title>
|
||||
<para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><computeroutput>
|
||||
RESET VARIABLE
|
||||
</computeroutput></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Message returned if
|
||||
<replaceable class="PARAMETER">variable</replaceable> is successfully reset
|
||||
to its default value.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</para>
|
||||
</refsect2>
|
||||
</refsynopsisdiv>
|
||||
|
||||
<refsect1 id="R1-SQL-RESET-1">
|
||||
<refsect1info>
|
||||
<date>1998-09-24</date>
|
||||
</refsect1info>
|
||||
<title>
|
||||
Description
|
||||
</title>
|
||||
<refsect1>
|
||||
<title>Description</title>
|
||||
<para>
|
||||
<command>RESET</command> restores variables to their
|
||||
default values.
|
||||
Refer to
|
||||
<command>RESET</command> restores run-time parameters to their
|
||||
default values. Refer to
|
||||
<xref linkend="sql-set-title" endterm="sql-set-title">
|
||||
for details on allowed values and defaults.
|
||||
<command>RESET</command> is an alternate form for
|
||||
for details. <command>RESET</command> is an alternate form for
|
||||
|
||||
<synopsis>
|
||||
SET <replaceable class="parameter">variable</replaceable> = DEFAULT
|
||||
SET <replaceable class="parameter">variable</replaceable> TO DEFAULT
|
||||
</synopsis>
|
||||
</para>
|
||||
|
||||
<refsect2 id="R2-SQL-RESET-3">
|
||||
<refsect2info>
|
||||
<date>1998-09-24</date>
|
||||
</refsect2info>
|
||||
<title>
|
||||
Notes
|
||||
</title>
|
||||
|
||||
<para>
|
||||
See also
|
||||
<xref linkend="sql-set-title" endterm="sql-set-title"> and
|
||||
<xref linkend="sql-show-title" endterm="sql-show-title">
|
||||
to manipulate variable values.
|
||||
</para>
|
||||
</refsect2>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 id="R1-SQL-RESET-2">
|
||||
<title>
|
||||
Usage
|
||||
</title>
|
||||
|
||||
<refsect1>
|
||||
<title>Diagnostics</title>
|
||||
<para>
|
||||
See under the <xref linkend="sql-set-title"
|
||||
endterm="sql-set-title"> command.
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>Examples</title>
|
||||
<para>
|
||||
Set DateStyle to its default value:
|
||||
|
||||
<programlisting>
|
||||
<screen>
|
||||
RESET DateStyle;
|
||||
</programlisting>
|
||||
</screen>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Set Geqo to its default value:
|
||||
|
||||
<programlisting>
|
||||
<screen>
|
||||
RESET GEQO;
|
||||
</programlisting>
|
||||
</screen>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 id="R1-SQL-RESET-3">
|
||||
<title>
|
||||
Compatibility
|
||||
</title>
|
||||
<refsect1>
|
||||
<title>Compatibility</title>
|
||||
|
||||
<refsect2 id="R2-SQL-RESET-4">
|
||||
<refsect2info>
|
||||
<date>1998-09-24</date>
|
||||
</refsect2info>
|
||||
<title>
|
||||
SQL92
|
||||
</title>
|
||||
<para>
|
||||
There is no <command>RESET</command> in <acronym>SQL92</acronym>.
|
||||
</para>
|
||||
</refsect2>
|
||||
<para>
|
||||
<command>RESET</command> is a <productname>Postgres</productname> extension.
|
||||
</para>
|
||||
</refsect1>
|
||||
</refentry>
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
53
doc/src/sgml/ref/set_constraints.sgml
Normal file
53
doc/src/sgml/ref/set_constraints.sgml
Normal file
@@ -0,0 +1,53 @@
|
||||
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_constraints.sgml,v 1.1 2000/06/18 21:24:54 petere Exp $ -->
|
||||
<refentry id="SQL-SET-CONSTRAINTS">
|
||||
<refmeta>
|
||||
<refentrytitle id="SQL-SET-CONSTRAINTS-title">SET CONSTRAINTS</refentrytitle>
|
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
||||
</refmeta>
|
||||
<refnamediv>
|
||||
<refname>SET CONSTRAINTS</refname>
|
||||
<refpurpose>Set the constraint mode of the current SQL-transaction</refpurpose>
|
||||
</refnamediv>
|
||||
<refsynopsisdiv>
|
||||
<refsynopsisdivinfo>
|
||||
<date>2000-06-01</date>
|
||||
</refsynopsisdivinfo>
|
||||
<synopsis>
|
||||
SET CONSTRAINTS { ALL | <replaceable class="parameter">constraint</replaceable> [, ...] } { DEFERRED | IMMEDIATE }
|
||||
</synopsis>
|
||||
</refsynopsisdiv>
|
||||
|
||||
<refsect1>
|
||||
<title>Description</title>
|
||||
|
||||
<para>
|
||||
<command>SET CONSTRAINTS</command> sets the behavior of constraint
|
||||
evaluation in the current transaction. In
|
||||
<option>IMMEDIATE</option> mode, constraints are checked at the end
|
||||
of each statement. In <option>DEFERRED</option> mode, constraints
|
||||
are not checked until transaction commit.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Upon creation, a constraint is always give one of three
|
||||
characteristics: <option>INITIALLY DEFERRED</option>,
|
||||
<option>INITIALLY IMMEDIATE DEFERRABLE</option>, or
|
||||
<option>INITIALLY IMMEDIATE NOT DEFERRABLE</option>. The third
|
||||
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>
|
||||
|
||||
<refsect1>
|
||||
<title>Compatibility</title>
|
||||
<para>
|
||||
SQL92, SQL99
|
||||
</para>
|
||||
</refsect1>
|
||||
</refentry>
|
||||
93
doc/src/sgml/ref/set_transaction.sgml
Normal file
93
doc/src/sgml/ref/set_transaction.sgml
Normal file
@@ -0,0 +1,93 @@
|
||||
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_transaction.sgml,v 1.1 2000/06/18 21:24:54 petere Exp $ -->
|
||||
<refentry id="SQL-SET-TRANSACTION">
|
||||
<refmeta>
|
||||
<refentrytitle id="SQL-SET-TRANSACTION-title">SET TRANSACTION</refentrytitle>
|
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
||||
</refmeta>
|
||||
<refnamediv>
|
||||
<refname>SET TRANSACTION</refname>
|
||||
<refpurpose>Set the characteristics of the current SQL-transaction</refpurpose>
|
||||
</refnamediv>
|
||||
<refsynopsisdiv>
|
||||
<refsynopsisdivinfo>
|
||||
<date>2000-06-01</date>
|
||||
</refsynopsisdivinfo>
|
||||
<synopsis>
|
||||
SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
|
||||
</synopsis>
|
||||
</refsynopsisdiv>
|
||||
|
||||
<refsect1>
|
||||
<title>Description</title>
|
||||
|
||||
<para>
|
||||
The <command>SET TRANSACTION</command> command sets the
|
||||
characteristics for the current SQL-transaction. It has no effect
|
||||
on any subsequent transactions. This command cannot be used after
|
||||
the first DML statement (<command>SELECT</command>,
|
||||
<command>INSERT</command>, <command>DELETE</command>,
|
||||
<command>UPDATE</command>, <command>FETCH</command>,
|
||||
<command>COPY</command>) of a transaction has been executed.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The isolation level of a transaction determines what data the
|
||||
transaction can see when other transactions are running concurrently.
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>READ COMMITTED</term>
|
||||
<listitem>
|
||||
<para>
|
||||
A statement can only see rows committed before it began. This
|
||||
is the default.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>SERIALIZABLE</term>
|
||||
<listitem>
|
||||
<para>
|
||||
The current transaction can only see rows committed before
|
||||
first DML statement was executed in this transaction.
|
||||
</para>
|
||||
<tip>
|
||||
<para>
|
||||
Intuitively, serializable means that two concurrent
|
||||
transactions will leave the database in the same state as if
|
||||
the two has been executed strictly after one another in either
|
||||
order.
|
||||
</para>
|
||||
</tip>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>Compatibility</title>
|
||||
|
||||
<para>
|
||||
SQL92, SQL99
|
||||
</para>
|
||||
|
||||
<para>
|
||||
SERIALIZABLE is the default level in <acronym>SQL</acronym>.
|
||||
Postgres does not provide the isolation levels <option>READ
|
||||
UNCOMMITTED</option> and <option>REPEATABLE READ</option>. Because
|
||||
of multi-version concurrency control, the serializable level is not
|
||||
truly serializable. See the <citetitle>User's Guide</citetitle> for
|
||||
details.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
In <acronym>SQL</acronym> there are two other transaction
|
||||
characteristics that can be set with this command: whether the
|
||||
transaction is read-only and the size of the diagnostics area.
|
||||
Neither of these concepts are supported in Postgres.
|
||||
</para>
|
||||
</refsect1>
|
||||
</refentry>
|
||||
|
||||
@@ -1,48 +1,34 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.9 2000/04/08 02:39:02 tgl Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.10 2000/06/18 21:24:54 petere Exp $
|
||||
Postgres documentation
|
||||
-->
|
||||
|
||||
<refentry id="SQL-SHOW">
|
||||
<refmeta>
|
||||
<refentrytitle id="SQL-SHOW-TITLE">
|
||||
SHOW
|
||||
</refentrytitle>
|
||||
<refentrytitle id="SQL-SHOW-TITLE">SHOW</refentrytitle>
|
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
||||
</refmeta>
|
||||
<refnamediv>
|
||||
<refname>
|
||||
SHOW
|
||||
</refname>
|
||||
<refpurpose>
|
||||
Shows run-time parameters for session
|
||||
</refpurpose>
|
||||
<refname>SHOW</refname>
|
||||
<refpurpose>Shows run-time parameters</refpurpose>
|
||||
</refnamediv>
|
||||
<refsynopsisdiv>
|
||||
<refsynopsisdivinfo>
|
||||
<date>1999-07-20</date>
|
||||
</refsynopsisdivinfo>
|
||||
<synopsis>
|
||||
SHOW <replaceable class="PARAMETER">keyword</replaceable>
|
||||
SHOW <replaceable class="PARAMETER">name</replaceable>
|
||||
</synopsis>
|
||||
|
||||
<refsect2 id="R2-SQL-SHOW-1">
|
||||
<refsect2info>
|
||||
<date>1998-09-24</date>
|
||||
</refsect2info>
|
||||
<title>
|
||||
Inputs
|
||||
</title>
|
||||
<title>Inputs</title>
|
||||
|
||||
<para>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><replaceable class="PARAMETER">keyword</replaceable></term>
|
||||
<term><replaceable class="PARAMETER">name</replaceable></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Refer to
|
||||
The name of a run-time parameter. See
|
||||
<xref linkend="sql-set-title" endterm="sql-set-title">
|
||||
for more information on available variables.
|
||||
for a list.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@@ -50,41 +36,43 @@ SHOW <replaceable class="PARAMETER">keyword</replaceable>
|
||||
</para>
|
||||
</refsect2>
|
||||
|
||||
<refsect2 id="R2-SQL-SHOW-2">
|
||||
<refsect2info>
|
||||
<date>1998-09-24</date>
|
||||
</refsect2info>
|
||||
<title>
|
||||
Outputs
|
||||
</title>
|
||||
</refsynopsisdiv>
|
||||
|
||||
<refsect1 id="R1-SQL-SHOW-1">
|
||||
<title>Description</title>
|
||||
<para>
|
||||
<command>SHOW</command> will display the current setting of a
|
||||
run-time parameter. These variables can be set using the
|
||||
<command>SET</command> statement or are determined at server start.
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>Diagnostics</title>
|
||||
|
||||
<para>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><computeroutput>
|
||||
NOTICE: <replaceable class="PARAMETER">variable</replaceable> is <replaceable>value</replaceable>
|
||||
</computeroutput></term>
|
||||
<term><computeroutput>ERROR: not a valid option name: <replaceable>name</replaceable></computeroutput></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Message returned if successful.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><computeroutput>
|
||||
NOTICE: Unrecognized variable <replaceable>value</replaceable>
|
||||
</computeroutput></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Message returned if <returnvalue>variable</returnvalue> does not exist.
|
||||
Message returned if <replaceable>variable</replaceable> does
|
||||
not stand for an existing parameter.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><computeroutput>
|
||||
NOTICE: Time zone is unknown
|
||||
</computeroutput></term>
|
||||
<term><computeroutput>ERROR: permission denied</computeroutput></term>
|
||||
<listitem>
|
||||
<para>
|
||||
You must be a superuser to be allowed to see certain settings.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><computeroutput>NOTICE: Time zone is unknown</computeroutput></term>
|
||||
<listitem>
|
||||
<para>
|
||||
If the <envar>TZ</envar> or <envar>PGTZ</envar> environment
|
||||
@@ -94,82 +82,35 @@ NOTICE: Time zone is unknown
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</para>
|
||||
</refsect2>
|
||||
</refsynopsisdiv>
|
||||
|
||||
<refsect1 id="R1-SQL-SHOW-1">
|
||||
<refsect1info>
|
||||
<date>1998-09-24</date>
|
||||
</refsect1info>
|
||||
<title>
|
||||
Description
|
||||
</title>
|
||||
<para>
|
||||
<command>SHOW</command> will display the current setting of a
|
||||
run-time parameter during a session.
|
||||
</para>
|
||||
<para>
|
||||
These variables can be set using the <command>SET</command> statement,
|
||||
and
|
||||
can be restored to the default values using the <command>RESET</command>
|
||||
statement.
|
||||
Parameters and values are case-insensitive.
|
||||
</para>
|
||||
|
||||
<refsect2 id="R2-SQL-SHOW-3">
|
||||
<refsect2info>
|
||||
<date>1998-09-24</date>
|
||||
</refsect2info>
|
||||
<title>
|
||||
Notes
|
||||
</title>
|
||||
<para>
|
||||
See also
|
||||
<xref linkend="sql-set-title" endterm="sql-set-title"> and
|
||||
<xref linkend="sql-reset-title" endterm="sql-reset-title">
|
||||
to manipulate variable values.
|
||||
</para>
|
||||
</refsect2>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 id="R1-SQL-SHOW-2">
|
||||
<title>
|
||||
Usage
|
||||
</title>
|
||||
<title>Examples</title>
|
||||
<para>
|
||||
Show the current <literal>DateStyle</literal> setting:
|
||||
|
||||
<programlisting>
|
||||
<screen>
|
||||
SHOW DateStyle;
|
||||
NOTICE: DateStyle is ISO with US (NonEuropean) conventions
|
||||
</programlisting>
|
||||
</screen>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Show the current genetic optimizer (<literal>geqo</literal>) setting:
|
||||
<programlisting>
|
||||
<screen>
|
||||
SHOW GEQO;
|
||||
NOTICE: GEQO is ON beginning with 11 relations
|
||||
</programlisting>
|
||||
NOTICE: geqo = true
|
||||
</screen>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 id="R1-SQL-SHOW-3">
|
||||
<title>
|
||||
Compatibility
|
||||
</title>
|
||||
<title>Compatibility</title>
|
||||
|
||||
<refsect2 id="R2-SQL-SHOW-4">
|
||||
<refsect2info>
|
||||
<date>1998-09-24</date>
|
||||
</refsect2info>
|
||||
<title>
|
||||
SQL92
|
||||
</title>
|
||||
<para>
|
||||
There is no <command>SHOW</command> defined in <acronym>SQL92</acronym>.
|
||||
</para>
|
||||
</refsect2>
|
||||
<para>
|
||||
The <command>SHOW</command> command is a
|
||||
<productname>Postgres</productname> extension.
|
||||
</para>
|
||||
</refsect1>
|
||||
</refentry>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user