1999-07-22 17:09:15 +02:00
|
|
|
<!--
|
2007-04-12 08:53:49 +02:00
|
|
|
$PostgreSQL: pgsql/doc/src/sgml/ref/reset.sgml,v 1.33 2007/04/12 06:53:46 neilc Exp $
|
2001-12-08 04:24:40 +01:00
|
|
|
PostgreSQL documentation
|
1999-07-22 17:09:15 +02:00
|
|
|
-->
|
|
|
|
|
1999-06-14 09:37:05 +02:00
|
|
|
<refentry id="SQL-RESET">
|
|
|
|
<refmeta>
|
2000-06-18 23:24:54 +02:00
|
|
|
<refentrytitle id="SQL-RESET-TITLE">RESET</refentrytitle>
|
1999-06-14 09:37:05 +02:00
|
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
|
|
</refmeta>
|
2003-05-04 04:23:16 +02:00
|
|
|
|
1999-06-14 09:37:05 +02:00
|
|
|
<refnamediv>
|
2000-06-18 23:24:54 +02:00
|
|
|
<refname>RESET</refname>
|
2006-04-25 16:11:59 +02:00
|
|
|
<refpurpose>restore the value of a run-time parameter to the default value</refpurpose>
|
1999-06-14 09:37:05 +02:00
|
|
|
</refnamediv>
|
2003-05-04 04:23:16 +02:00
|
|
|
|
2003-08-31 19:32:24 +02:00
|
|
|
<indexterm zone="sql-reset">
|
|
|
|
<primary>RESET</primary>
|
|
|
|
</indexterm>
|
|
|
|
|
1999-06-14 09:37:05 +02:00
|
|
|
<refsynopsisdiv>
|
2003-05-04 04:23:16 +02:00
|
|
|
<synopsis>
|
2006-04-25 16:56:04 +02:00
|
|
|
RESET <replaceable class="PARAMETER">configuration_parameter</replaceable>
|
2001-06-07 06:50:57 +02:00
|
|
|
RESET ALL
|
2007-04-12 08:53:49 +02:00
|
|
|
RESET { PLANS | SESSION | TEMP | TEMPORARY }
|
2003-05-04 04:23:16 +02:00
|
|
|
</synopsis>
|
1999-06-14 09:37:05 +02:00
|
|
|
</refsynopsisdiv>
|
2007-04-12 08:53:49 +02:00
|
|
|
|
2000-06-18 23:24:54 +02:00
|
|
|
<refsect1>
|
|
|
|
<title>Description</title>
|
2003-05-04 04:23:16 +02:00
|
|
|
|
1999-06-14 09:37:05 +02:00
|
|
|
<para>
|
2000-06-18 23:24:54 +02:00
|
|
|
<command>RESET</command> restores run-time parameters to their
|
2003-05-04 04:23:16 +02:00
|
|
|
default values. <command>RESET</command> is an alternative
|
|
|
|
spelling for
|
|
|
|
<synopsis>
|
2006-04-25 16:56:04 +02:00
|
|
|
SET <replaceable class="parameter">configuration_parameter</replaceable> TO DEFAULT
|
2003-05-04 04:23:16 +02:00
|
|
|
</synopsis>
|
|
|
|
Refer to <xref linkend="sql-set" endterm="sql-set-title"> for
|
|
|
|
details.
|
|
|
|
</para>
|
2002-05-17 03:19:19 +02:00
|
|
|
|
2003-05-04 04:23:16 +02:00
|
|
|
<para>
|
|
|
|
The default value is defined as the value that the parameter would
|
2007-04-12 08:53:49 +02:00
|
|
|
have had, if no <command>SET</> ever been issued for it in the
|
2002-05-17 03:19:19 +02:00
|
|
|
current session. The actual source of this value might be a
|
2003-05-04 04:23:16 +02:00
|
|
|
compiled-in default, the configuration file, command-line options,
|
|
|
|
or per-database or per-user default settings. See <xref
|
|
|
|
linkend="runtime-config"> for details.
|
1999-06-14 09:37:05 +02:00
|
|
|
</para>
|
2002-10-09 06:59:38 +02:00
|
|
|
|
|
|
|
<para>
|
2003-05-04 04:23:16 +02:00
|
|
|
See the <command>SET</> reference page for details on the
|
2006-04-25 20:58:37 +02:00
|
|
|
transaction behavior of <command>RESET</>.
|
2002-10-09 06:59:38 +02:00
|
|
|
</para>
|
2007-04-12 08:53:49 +02:00
|
|
|
|
|
|
|
<para>
|
|
|
|
<command>RESET</> can also be used to release internal resources
|
|
|
|
that are usually released at the end of session. <command>RESET
|
|
|
|
TEMP</> drops all temporary tables created in the current session.
|
|
|
|
<command>RESET PLANS</> releases all internally cached plans.
|
|
|
|
<command>RESET SESSION</> releases all externally visible temporary
|
|
|
|
resources associated with the current session.
|
|
|
|
</para>
|
2003-05-04 04:23:16 +02:00
|
|
|
</refsect1>
|
2002-10-09 06:59:38 +02:00
|
|
|
|
2003-05-04 04:23:16 +02:00
|
|
|
<refsect1>
|
|
|
|
<title>Parameters</title>
|
|
|
|
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
2006-04-25 16:56:04 +02:00
|
|
|
<term><replaceable class="PARAMETER">configuration_parameter</replaceable></term>
|
2003-05-04 04:23:16 +02:00
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
The name of a run-time parameter. See <xref linkend="sql-set"
|
|
|
|
endterm="sql-set-title"> for a list.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term><literal>ALL</literal></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
Resets all settable run-time parameters to default values.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
2007-04-12 08:53:49 +02:00
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term><literal>TEMP, TEMPORARY</literal></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
Drops all temporary tables created in the current session.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term><literal>PLANS</literal></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
Releases all cached query plans.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term><literal>SESSION</literal></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
Releases all temporary resources associated with the current
|
|
|
|
session. This has the same effect as executing the following
|
|
|
|
command sequence:
|
|
|
|
<synopsis>
|
|
|
|
SET SESSION AUTHORIZATION DEFAULT;
|
|
|
|
RESET ALL;
|
|
|
|
DEALLOCATE ALL;
|
|
|
|
CLOSE ALL;
|
|
|
|
UNLISTEN *;
|
|
|
|
RESET PLANS;
|
|
|
|
RESET TEMP;
|
|
|
|
</synopsis>
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2003-05-04 04:23:16 +02:00
|
|
|
</variablelist>
|
2000-06-18 23:24:54 +02:00
|
|
|
</refsect1>
|
1998-12-29 03:24:47 +01:00
|
|
|
|
2007-04-12 08:53:49 +02:00
|
|
|
<refsect1>
|
|
|
|
<title>Notes</title>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
<command>RESET SESSION</> cannot be executed inside a transaction block.
|
|
|
|
</para>
|
|
|
|
</refsect1>
|
|
|
|
|
2000-06-18 23:24:54 +02:00
|
|
|
<refsect1>
|
|
|
|
<title>Examples</title>
|
1999-07-06 19:16:42 +02:00
|
|
|
|
2003-05-04 04:23:16 +02:00
|
|
|
<para>
|
2003-12-14 01:15:03 +01:00
|
|
|
Set the <varname>geqo</> configuration variable to its default value:
|
2003-05-04 04:23:16 +02:00
|
|
|
<screen>
|
|
|
|
RESET geqo;
|
2000-06-18 23:24:54 +02:00
|
|
|
</screen>
|
1999-06-14 09:37:05 +02:00
|
|
|
</para>
|
|
|
|
</refsect1>
|
|
|
|
|
2000-06-18 23:24:54 +02:00
|
|
|
<refsect1>
|
|
|
|
<title>Compatibility</title>
|
1998-12-29 03:24:47 +01:00
|
|
|
|
2000-06-18 23:24:54 +02:00
|
|
|
<para>
|
2001-12-08 04:24:40 +01:00
|
|
|
<command>RESET</command> is a <productname>PostgreSQL</productname> extension.
|
2000-06-18 23:24:54 +02:00
|
|
|
</para>
|
1999-06-14 09:37:05 +02:00
|
|
|
</refsect1>
|
|
|
|
</refentry>
|