mirror of
https://github.com/postgres/postgres.git
synced 2025-07-28 23:42:10 +03:00
Complete merge of all old man page information.
ecpg reference page still needs formatting.
This commit is contained in:
@ -1,6 +1,11 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/insert.sgml,v 1.6 1999/07/22 15:09:12 thomas Exp $
|
||||
Postgres documentation
|
||||
-->
|
||||
|
||||
<refentry id="SQL-INSERT">
|
||||
<refmeta>
|
||||
<refentrytitle>
|
||||
<refentrytitle id="SQL-INSERT-TITLE">
|
||||
INSERT
|
||||
</refentrytitle>
|
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
||||
@ -15,7 +20,7 @@
|
||||
</refnamediv>
|
||||
<refsynopsisdiv>
|
||||
<refsynopsisdivinfo>
|
||||
<date>1998-09-23</date>
|
||||
<date>1999-07-20</date>
|
||||
</refsynopsisdivinfo>
|
||||
<synopsis>
|
||||
INSERT INTO <replaceable class="PARAMETER">table</replaceable> [ ( <replaceable class="PARAMETER">column</replaceable> [, ...] ) ]
|
||||
@ -118,16 +123,27 @@ INSERT 0 <replaceable>#</replaceable>
|
||||
<title>
|
||||
Description
|
||||
</title>
|
||||
|
||||
<para>
|
||||
<command>INSERT</command> allows one to insert new rows into a table. One can insert
|
||||
<command>INSERT</command> allows one to insert new rows into a
|
||||
class or table. One can insert
|
||||
a single row at time or several rows as a result of a query.
|
||||
The columns in the target list may be listed in any order.
|
||||
In every column not present in the target list will be inserted
|
||||
the default value, if column has not a declared default value
|
||||
it will be assumed as NULL. If the expression for each column
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Each column not present in the target list will be inserted
|
||||
using a default value, either a declared DEFAULT value
|
||||
or NULL. <productname>Postgres</productname> will reject the new
|
||||
column if a NULL is inserted into a column declared NOT NULL.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
If the expression for each column
|
||||
is not of the correct data type, automatic type coercion will be
|
||||
attempted.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
You must have insert privilege to a table in order to append
|
||||
to it, as well as select privilege on any table specified
|
||||
@ -177,7 +193,8 @@ INSERT INTO films SELECT * FROM tmp;
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Insert into arrays (refer to <citetitle>The PostgreSQL User's Guide</citetitle> for further
|
||||
Insert into arrays (refer to
|
||||
<citetitle>The PostgreSQL User's Guide</citetitle> for further
|
||||
information about arrays):
|
||||
|
||||
<programlisting>
|
||||
@ -197,8 +214,6 @@ INSERT INTO tictactoe (game, board)
|
||||
<title>
|
||||
Compatibility
|
||||
</title>
|
||||
<para>
|
||||
</para>
|
||||
|
||||
<refsect2 id="R2-SQL-INSERT-4">
|
||||
<refsect2info>
|
||||
@ -211,7 +226,8 @@ INSERT INTO tictactoe (game, board)
|
||||
<command>INSERT</command> is fully compatible with <acronym>SQL92</acronym>.
|
||||
Possible limitations in features of the
|
||||
<replaceable class="PARAMETER">query</replaceable>
|
||||
clause are documented for the SELECT statement.
|
||||
clause are documented for
|
||||
<xref linkend="sql-select-title" endterm="sql-select-title">.
|
||||
</para>
|
||||
</refsect2>
|
||||
</refsect1>
|
||||
|
Reference in New Issue
Block a user