rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: improve TABLE command by showing supported clauses 

Initial patch by Colin 't Hart
This commit is contained in:
Bruce Momjian 2014-03-07 20:56:00 -05:00
parent ea177a3ba7
commit b0cb40f93a
1 changed files with 8 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/src/sgml/ref/select.sgml
View File

@ -214,7 +214,7 @@ TABLE [ ONLY ] <replaceable class="parameter">table_name</replaceable> [ * ]
subqueries that can be referenced by name in the primary query.
The subqueries effectively act as temporary tables or views
for the duration of the primary query.
Each subquery can be a <command>SELECT</command>, <command>VALUES</command>,
Each subquery can be a <command>SELECT</command>, <command>TABLE</>, <command>VALUES</command>,
<command>INSERT</command>, <command>UPDATE</command> or
<command>DELETE</command> statement.
When writing a data-modifying statement (<command>INSERT</command>,
@ -1489,12 +1489,17 @@ SELECT * FROM (SELECT * FROM mytable FOR UPDATE) ss ORDER BY column1;
<programlisting>
TABLE <replaceable class="parameter">name</replaceable>
</programlisting>
is completely equivalent to
is equivalent to
<programlisting>
SELECT * FROM <replaceable class="parameter">name</replaceable>
</programlisting>
It can be used as a top-level command or as a space-saving syntax
variant in parts of complex queries.
variant in parts of complex queries. Only the <literal>WITH</>,
<literal>UNION</>, <literal>INTERSECT</>, <literal>EXCEPT</>,
<literal>ORDER BY</>, <literal>LIMIT</>, <literal>OFFSET</>,
<literal>FETCH</> and locking clauses can be used with <command>TABLE</>;
the <literal>WHERE</> clause and any form of aggregation cannot
be used.
</para>
</refsect2>
</refsect1>