Outputs
</TITLE>
<PARA>
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
Message returned if table or column is not available.
-</PARA>
-</LISTITEM>
-</VARLISTENTRY>
-</VARIABLELIST>
-</LISTITEM>
-</VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<PARA>
Error message returned if the user specified doesn't
exist.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
- </para>
- </listitem>
- </varlistentry>
+
</variablelist>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<PARA>
This indicates that a transaction was already in progress.
The current transaction is not affected.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </para>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <replaceable>
- status
- </replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
This warning is given if
<REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE> is not
declared or has already been closed.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</PARA>
</LISTITEM>
</VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</Chapter>
+<!--
+Disable this chapter until we have more functions documented.
+- thomas 1998-10-27
+
<chapter Id="sql-functions">
<title>SQL Functions</title>
</chapter>
+-->
+
<chapter Id="utilities">
<title>Utility Applications</title>
Outputs
</TITLE>
<PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
If there is no transaction in progress.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <Replaceable>status</Replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
The copy failed for the reason stated in the error message.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
Message returned if the command completes successfully.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
- </LISTITEM>
- </VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
There was a problem with creating the required directory; this operation will
- need permissions for the <literal>postgres</literal> user on the specified location.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+need permissions for the <literal>postgres</literal> user on the specified location.
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
This is returned if the command completes successfully.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
</TITLE>
<PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
This error occurs if it is impossible to create the index.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
This error is returned if the function
<replaceable class="parameter">funcname</replaceable>()
is not found.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<DATE>1998-09-09</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
-CREATE OPERATOR <replaceable>name</replaceable>
- ( PROCEDURE = <replaceable class="parameter">func_name</replaceable>
+CREATE OPERATOR <replaceable>name</replaceable> (
+ PROCEDURE = <replaceable class="parameter">func_name</replaceable>
[, LEFTARG = <replaceable class="parameter">type1</replaceable> ]
[, RIGHTARG = <replaceable class="parameter">type2</replaceable> ]
[, COMMUTATOR = <replaceable class="parameter">com_op</replaceable> ]
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
Message returned if the operator is successfully created.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
Message returned if the rule is successfully created.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
+
</VARLISTENTRY>
</VARIABLELIST>
of the following two rule definitions are accepted by
<productname>Postgres</productname>, the
retrieve command will cause <productname>Postgres</productname> to crash:
+
<example>
<title>Example of a circular rewrite rule combination.</title>
<programlisting>
select * from EMP
</programlisting></para>
</example>
+
</para>
<para>
You must have rule definition access to a class in order
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
If the minimum and maximum values are inconsistant.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <ReturnValue>status</ReturnValue>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<PARA>
if data type of default value doesn't match the
column definition's data type.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<REFENTRY ID="SQL-CREATETABLEAS">
<REFMETA>
<REFENTRYTITLE>
- CREATE TABLE
+ CREATE TABLE AS
</REFENTRYTITLE>
<REFMISCINFO>SQL - Language Statements</REFMISCINFO>
</REFMETA>
<REFNAMEDIV>
<REFNAME>
- CREATE TABLE
+ CREATE TABLE AS
</REFNAME>
<REFPURPOSE>
Creates a new table
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
This message is returned if the trigger is successfully created.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
CREATE TYPE <replaceable class="parameter">typename</replaceable> (
-<comment>
-Why are parentheses required around the length parameters?
-</comment>
- INPUT = <replaceable class="parameter">input_function</replaceable>
- , OUTPUT = <replaceable class="parameter">output_function</replaceable>
- , INTERNALLENGTH = (<replaceable class="parameter">internallength</replaceable> | VARIABLE)
+ INPUT = <replaceable class="parameter">input_function</replaceable>
+ , OUTPUT = <replaceable class="parameter">output_function</replaceable>
+ , INTERNALLENGTH = (<replaceable class="parameter">internallength</replaceable> | VARIABLE)
[ , EXTERNALLENGTH = (<replaceable class="parameter">externallength</replaceable> | VARIABLE) ]
[ , ELEMENT = <replaceable class="parameter">element</replaceable> ]
[ , DELIMITER = <replaceable class="parameter">delimiter</replaceable> ]
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
Message returned if the type is successfully created.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</TITLE>
<PARA>
</PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</PARA>
<comment>I don't understand this and I don't know how to get
this error message.</comment>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<programlisting>
CREATE VIEW vista AS SELECT 'Hello World'::text
</programlisting>
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<PARA>
To create the database <literal>demo</literal>
using the postmaster on the local host, port 5432:
+
<programlisting>
createdb demo
</programlisting>
To create the database <literal>demo</literal>
using the postmaster on host eden, port 5000:
+
<programlisting>
createdb -p 5000 -h eden demo
</programlisting>
<envar>PGREALM</envar>
environment variables will be passed on to
<application>psql</application>
-and processed as described in <xref linkend="app-psql" endterm="app-psql">.
+and processed as described in <xref linkend="app-psql" endterm="psql-ref">.
Once invoked, <application>createuser</application>
will ask a series of questions to obtain parameters not specified on
</REFMETA>
<REFNAMEDIV>
<REFNAME>
- SQL_CURRENT_DATE
+ CURRENT_DATE
</REFNAME>
<REFPURPOSE>
Returns the current date
Inputs
</TITLE>
<PARA>
- </PARA>
-<VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- </TERM>
- <LISTITEM>
- <PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <ReturnValue>None</ReturnValue>
- </TERM>
- <LISTITEM>
- <PARA>
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
+None.
</REFSECT2>
<REFSECT2 ID="R2-SQL-CURRENT-DATE-2">
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
- <ReturnValue>Returns "<replaceable class="parameter">today</replaceable>"</ReturnValue>
+<replaceable>date</replaceable>
+
</TERM>
<LISTITEM>
<PARA>
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+ Returns "<replaceable class="parameter">today</replaceable>".
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
</REFMETA>
<REFNAMEDIV>
<REFNAME>
- SQL_CURRENT_TIME
+ CURRENT_TIME
</REFNAME>
<REFPURPOSE>
Returns the current local time
Inputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- </TERM>
- <LISTITEM>
- <PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <ReturnValue>None</ReturnValue>
- </TERM>
- <LISTITEM>
- <PARA>
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
+None.
</REFSECT2>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
- <ReturnValue>Returns "<replaceable class="parameter">now</replaceable>"</ReturnValue>
- </TERM>
+ <replaceable>time</replaceable>
+
<LISTITEM>
<PARA>
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
- </LISTITEM>
- </VARLISTENTRY>
+ <ReturnValue>Returns "<replaceable class="parameter">now</replaceable>"</ReturnValue>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
</REFMETA>
<REFNAMEDIV>
<REFNAME>
- SQL_CURRENT_TIMESTAMP
+ CURRENT_TIMESTAMP
</REFNAME>
<REFPURPOSE>
Returns the current date and time
Inputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- </TERM>
- <LISTITEM>
- <PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <ReturnValue>None</ReturnValue>
- </TERM>
- <LISTITEM>
- <PARA>
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
+None.
+
</REFSECT2>
<REFSECT2 ID="R2-SQL-CURRENT-TIMESTAMP-2">
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
- <ReturnValue>Returns "<replaceable class="parameter">today</replaceable>" and "<replaceable class="parameter">now</replaceable>".</ReturnValue>
- </TERM>
+<replaceable>timestamp</replaceable>
+
<LISTITEM>
<PARA>
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
- </LISTITEM>
- </VARLISTENTRY>
+ Returns "<replaceable class="parameter">today</replaceable>" and "<replaceable class="parameter">now</replaceable>".
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
</REFMETA>
<REFNAMEDIV>
<REFNAME>
- SQL_CURRENT_USER
+ CURRENT_USER
</REFNAME>
<REFPURPOSE>
Returns the current user name
Inputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- </TERM>
- <LISTITEM>
- <PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <ReturnValue>None</ReturnValue>
- </TERM>
- <LISTITEM>
- <PARA>
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
+
+None.
</REFSECT2>
<REFSECT2 ID="R2-SQL-CURRENT-USER-2">
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
- <ReturnValue>The name of the current user.</ReturnValue>
+ <replaceable>username</replaceable>
</TERM>
<LISTITEM>
<PARA>
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+The name of the current user.
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
<VARIABLELIST>
<VARLISTENTRY>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<PARA>
If <replaceable class="parameter">count</replaceable> is 0,
no rows were deleted.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<envar>PGREALM</envar>
environment variables will be passed on to
<application>psql</application>
-and processed as described in <xref linkend="app-psql" endterm="app-psql">.
+and processed as described in <xref linkend="app-psql" endterm="psql-ref">.
<para>
Once invoked, <application>destroyuser</application>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<PARA>
This message occurs if the aggregate function specified does not
exist in the database.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
This message occurs if the specified database does not exist.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<PARA>
This message is given if the function specified does not
exist in the current database.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<PARA>
This message occurs if <REPLACEABLE CLASS="PARAMETER">index_name</REPLACEABLE>
is not an index in the database.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
This message occurs if the language
"<replaceable class="parameter">langname</replaceable>" is
not found.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<PARA>
This message occurs if the specified right unary operator
specified does not exist.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
This message occurs if the specified rule does not exist.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
This message occurs if the specified sequence does not exist.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
If the specified table or view does not exist in the database.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
- <VARIABLELIST>
+
+<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue>DROP</ReturnValue>
<LISTITEM>
<PARA>
This message occurs if the trigger specified does not exist.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
+
+</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<LISTITEM>
<PARA>
This message occurs if the specified type is not found.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</PARA>
</LISTITEM>
</VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
- </VARIABLELIST>
+ </VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
Outputs
</TITLE>
<PARA>
- </PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
-<replaceable>status</replaceable>
- </TERM>
- <LISTITEM>
- <PARA>
- <VARIABLELIST>
- <VARLISTENTRY>
- <TERM>
- <ReturnValue>DROP</ReturnValue>
- </TERM>
- <LISTITEM>
+
+<VARIABLELIST>
+<VARLISTENTRY>
+<TERM>
+<ReturnValue>DROP</ReturnValue>
+</TERM>
+<LISTITEM>
<PARA>
The message returned if the command is successful.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- <VARLISTENTRY>
- <TERM>
- <ReturnValue>
- ERROR: RewriteGetRuleEventRel: rule "_RET<REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE>" not found</ReturnValue>
- </TERM>
- <LISTITEM>
- <PARA>
- This message occurs if the specified view does not exist in
- the database.
- </PARA>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </LISTITEM>
- </VARLISTENTRY>
- </variablelist>
- </REFSECT2>
+
+<VARLISTENTRY>
+<TERM>
+<ReturnValue>
+ERROR: RewriteGetRuleEventRel: rule "_RET<REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE>" not found</ReturnValue>
+</TERM>
+<LISTITEM>
+<PARA>
+This message occurs if the specified view does not exist in
+the database.
+</variablelist>
+
+</REFSECT2>
</REFSYNOPSISDIV>
<REFSECT1 ID="R1-SQL-DROPVIEW-1">
<PARA>
Explicit query plan from the <productname>Postgres</productname> backend.
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
<VARLISTENTRY>
<TERM>
EXPLAIN
Flag sent after query plan is shown.
</VARIABLELIST>
-</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<SYNOPSIS>
FETCH [ <REPLACEABLE CLASS="PARAMETER">selector</REPLACEABLE> ] [ <REPLACEABLE CLASS="PARAMETER">count</REPLACEABLE> ]
{ IN | FROM } <REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE>
-FETCH [ RELATIVE ] [ { [ <REPLACEABLE CLASS="PARAMETER">#</REPLACEABLE> | ALL | NEXT | PRIOR ] } ] FROM ] <REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE>
+FETCH [ RELATIVE ] [ { [ <REPLACEABLE CLASS="PARAMETER">#</REPLACEABLE> | ALL | NEXT | PRIOR ] } ]
+ FROM ] <REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE>
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-FETCH-1">
<PARA>
The name of an object to which to grant access.
The possible objects are:
-<simplelist>
-<member>
- table
-<member>
- view
-<member>
- sequence
-<member>
- index
-</simplelist>
+
+<itemizedlist mark="bullet" spacing="compact">
+<listitem>
+<para>
+table
+
+<listitem>
+<para>
+view
+
+<listitem>
+<para>
+sequence
+
+<listitem>
+<para>
+index
+</itemizedlist>
<VARLISTENTRY>
<TERM>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
-
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
CHANGE
</TERM>
<LISTITEM>
to give privileges to the specified group or users.
</VARIABLELIST>
-</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<note>
<para>
-Only the Unix superuser can create a database system with a
-different user as <productname>Postgres</productname> superuser.
+Only the Unix superuser (<literal>root</literal>)
+ can create a database system with an owner
+different from the <productname>Postgres</productname> superuser.
</note>
</variablelist>
Outputs
</TITLE>
<PARA>
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
is the number of rows inserted.
</VARIABLELIST>
-</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
<returnvalue>LISTEN</returnvalue>
</TERM>
<LISTITEM>
<PARA>
If this backend is already registered for that notify condition.
</PARA>
-</LISTITEM>
-</VARLISTENTRY>
-</variablelist>
-</LISTITEM>
-</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
-
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
<returnvalue>LOAD</returnvalue>
</TERM>
<LISTITEM>
with the appropriate full path name specified, to avoid this message.
</VARIABLELIST>
-</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
-
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
DELETE 0
</TERM>
<LISTITEM>
does not exist.
</VARIABLELIST>
-</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
-
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
NOTIFY
</TERM>
<LISTITEM>
<PARA>
Acknowledgement that notify command has executed.
-</PARA>
-</LISTITEM>
-</VARLISTENTRY>
-</variablelist>
-</LISTITEM>
-</VARLISTENTRY>
+
<VARLISTENTRY>
<TERM>
Notify events
<REFENTRY ID="APP-PG-DUMP">
<REFMETA>
-<REFENTRYTITLE>
+<REFENTRYTITLE id="pg-dump">
<application>pg_dump</application>
</REFENTRYTITLE>
<REFMISCINFO>Application</REFMISCINFO>
</REFMETA>
<REFNAMEDIV>
-<REFNAME id="pg-dump">
+<REFNAME>
<application>pg_dump</application>
</REFNAME>
<REFPURPOSE>
<REFENTRY ID="APP-PSQL">
<REFMETA>
-<REFENTRYTITLE>
+<REFENTRYTITLE id="psql-ref">
<application>psql</application>
</REFENTRYTITLE>
<REFMISCINFO>Application</REFMISCINFO>
</REFMETA>
<REFNAMEDIV>
-<REFNAME id="psql-ref">
+<REFNAME>
<application>psql</application>
</REFNAME>
<REFPURPOSE>
</variablelist>
<para>
-The full set of command-line arguments and meta-commands are described in a following
+The full set of command-line arguments and meta-commands are described in a subsequent
section.
<para>
</TERM>
<LISTITEM>
<PARA>
+The port number on which a <productname>Postgres</productname> server is listening.
+Defaults to <literal>5432</literal>.
</PARA>
</LISTITEM>
</VARLISTENTRY>
</TERM>
<LISTITEM>
<PARA>
+The target for display of messages from the client support library.
+Not required.
</PARA>
</LISTITEM>
</VARLISTENTRY>
<PARA>
If <envar>PGOPTION</envar>
is specified, then the options it contains are parsed
-.BR before
+<emphasis>before</emphasis>
any command-line options.
</PARA>
</LISTITEM>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
-
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
RESET VARIABLE
</TERM>
<LISTITEM>
to its default value..
</VARIABLELIST>
-</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<PARA>
The name of an object from which to revoke access.
The possible objects are:
-<simplelist>
-<member>
- table
-<member>
- view
-<member>
- sequence
-<member>
- index
-</simplelist>
+<itemizedlist mark="bullet" spacing="compact">
+<listitem>
+<para>
+table
+
+<listitem>
+<para>
+view
+
+<listitem>
+<para>
+sequence
+
+<listitem>
+<para>
+index
+</itemizedlist>
<VARLISTENTRY>
<TERM>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
-
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
CHANGE
</TERM>
<LISTITEM>
to revoke privileges from a group or users.
</VARIABLELIST>
-</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<refentry id="SQL-SELECT">
<refmeta>
<refentrytitle>
- SELECT
+SELECT
</refentrytitle>
<refmiscinfo>SQL - Language Statements</refmiscinfo>
</refmeta>
<refnamediv>
<refname>
- SELECT
+SELECT
</refname>
<refpurpose>
Retrieve rows from a table or view.
<varlistentry>
<term>
- <replaceable>status</replaceable>
- </term>
- <listitem>
- <para>
-
- <variablelist>
- <varlistentry>
- <term>
<returnvalue><replaceable>count</replaceable></returnvalue>
</term>
<listitem>
<para>
The count of rows returned by the query.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
</variablelist>
</refsect2>
<refentry id="SQL-SELECTINTO">
<refmeta>
<refentrytitle>
- SELECT INTO
+SELECT INTO
</refentrytitle>
<refmiscinfo>SQL - Language Statements</refmiscinfo>
</refmeta>
<refnamediv>
<refname>
- SELECT INTO
+SELECT INTO
</refname>
<refpurpose>
- Create a new table from an existing table or view
+Create a new table from an existing table or view
</refpurpose></refnamediv>
<refsynopsisdiv>
<refsynopsisdivinfo>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
-
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
<returnvalue>SET VARIABLE</returnvalue>
</TERM>
<LISTITEM>
<LISTITEM>
<PARA>
If the command fails to set variable.
-</VARLISTENTRY>
-</VARIABLELIST>
+
</VARIABLELIST>
</REFSECT2>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-<REPLACEABLE>status</REPLACEABLE>
-</TERM>
-<LISTITEM>
-<PARA>
-
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
<returnvalue>NOTICE: <REPLACEABLE CLASS="PARAMETER">variable</REPLACEABLE> is <replaceable>value</replaceable></ReturnValue>
SHOW VARIABLE
</TERM>
If the TZ environment variable is not set.
</VARIABLELIST>
-</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-<replaceable>status</replaceable>
-</TERM>
-<LISTITEM>
-<PARA>
-<VARIABLELIST>
-<VARLISTENTRY>
-<TERM>
<returnvalue>UNLISTEN</returnvalue>
</TERM>
<LISTITEM>
<PARA>
Acknowledgement that statement has executed.
-</PARA>
-</LISTITEM>
-</VARLISTENTRY>
-</variablelist>
-</LISTITEM>
-</VARLISTENTRY>
+
</VARIABLELIST>
</REFSECT2>
</REFSYNOPSISDIV>
for the current session.
<para>
-<xref linkend="sql-notify-ref" endterm="sql-notify-ref">
+<xref linkend="sql-notify" endterm="sql-notify-ref">
contains a more extensive
discussion of the use of <command>LISTEN</command> and
<command>NOTIFY</command>.
Outputs
</TITLE>
<PARA>
-</PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>