head	1.5;
access;
symbols
	REL7_2_8:1.4
	REL7_2_7:1.4
	REL7_2_6:1.4
	REL7_2_5:1.4
	REL7_2_4:1.4
	REL7_2_3:1.4
	REL7_2_STABLE:1.4.0.6
	REL7_2:1.4
	REL7_2_RC2:1.4
	REL7_2_RC1:1.4
	REL7_2_BETA5:1.4
	REL7_2_BETA4:1.4
	REL7_2_BETA3:1.4
	REL7_2_BETA2:1.4
	REL7_2_BETA1:1.4
	REL7_1_2:1.4
	REL7_1_STABLE:1.4.0.4
	REL7_1_BETA:1.4
	REL7_1_BETA3:1.4
	REL7_1_BETA2:1.4
	REL7_1:1.4
	REL7_0_PATCHES:1.4.0.2
	REL7_0:1.4
	REL6_5_PATCHES:1.1.0.2;
locks; strict;
comment	@# @;


1.5
date	2002.08.30.16.48.43;	author momjian;	state dead;
branches;
next	1.4;

1.4
date	99.10.30.16.18.51;	author momjian;	state Exp;
branches;
next	1.3;

1.3
date	99.10.30.16.01.14;	author momjian;	state dead;
branches;
next	1.2;

1.2
date	99.09.20.22.30.47;	author scrappy;	state Exp;
branches;
next	1.1;

1.1
date	99.09.13.18.47.31;	author momjian;	state dead;
branches
	1.1.2.1;
next	;

1.1.2.1
date	99.09.13.18.47.31;	author momjian;	state Exp;
branches;
next	;


desc
@@


1.5
log
@Remove pgaccess from CVS.  It has its own home now.
@
text
@.pgaw:Help.f.t insert end "INSERT" {bold} "  allows one to insert new rows into a 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 is not of the \
correct data type, automatic type coercion will be attempted. 

" {} "Synopsis" {bold} "
" {} "
   INSERT INTO table \[ ( column \[, ...\] ) \]
   \{ VALUES ( expression \[, ...\] ) | SELECT query \}

" {code} "Usage" {bold} "
" {} "
                --Insert a single row into table films;
                --(in the second example the column date_prod is omitted 
                --therefore will be stored in it a default value of NULL):
                --
                INSERT INTO films VALUES
                ('UA502','Bananas',105,'1971-07-13','Comedy',INTERVAL '82 minute');
                
                INSERT INTO films (code, title, did, date_prod, kind)
                VALUES ('T_601', 'Yojimbo', 106, DATE '1961-06-16', 'Drama');
          

                --Insert a single row into table distributors, note that
                --only column \"name\" is specified, to the non specified
                --column \"did\" will be assigned its default value:
                --
                INSERT INTO distributors (name) VALUES ('British Lion');
          

                --Insert several rows into table films from table tmp:
                --
                INSERT INTO films
                SELECT * FROM tmp;
          

                --Insert into arrays:
                --Create an empty 3x3 gameboard for noughts-and-crosses
                --(all of these queries create the same board attribute)
                --(Refer to the PostgreSQL User's Guide for further
                --information about arrays).
                
                INSERT INTO tictactoe (game, board\[1:3\]\[1:3\])
                    VALUES (1,'\{\{\"\",\"\",\"\"\},\{\},\{\"\",\"\"\}\}');
                INSERT INTO tictactoe (game, board\[3\]\[3\])
                    VALUES (2,'\{\}');
                INSERT INTO tictactoe (game, board)
                    VALUES (3,'\{\{,,\},\{,,\},\{,,\}\}');

" {code} "Compatibility" {bold} "

SQL92 

The INSERT statement is fully compatible with SQL92. Possible limitations in features of the query clause are documented for the SELECT statement. 
"
@


1.4
log
@Add 0.98.
@
text
@@


1.3
log
@Remove 0.96 for update to 0.98
@
text
@@


1.2
log
@
bring it all into -current again
@
text
@@


1.1
log
@file insert.hlp was initially added on branch REL6_5_PATCHES.
@
text
@d1 54
@


1.1.2.1
log
@Update pgaccess 0.98
@
text
@a0 54
.pgaw:Help.f.t insert end "INSERT" {bold} "  allows one to insert new rows into a 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 is not of the \
correct data type, automatic type coercion will be attempted. 

" {} "Synopsis" {bold} "
" {} "
   INSERT INTO table \[ ( column \[, ...\] ) \]
   \{ VALUES ( expression \[, ...\] ) | SELECT query \}

" {code} "Usage" {bold} "
" {} "
                --Insert a single row into table films;
                --(in the second example the column date_prod is omitted 
                --therefore will be stored in it a default value of NULL):
                --
                INSERT INTO films VALUES
                ('UA502','Bananas',105,'1971-07-13','Comedy',INTERVAL '82 minute');
                
                INSERT INTO films (code, title, did, date_prod, kind)
                VALUES ('T_601', 'Yojimbo', 106, DATE '1961-06-16', 'Drama');
          

                --Insert a single row into table distributors, note that
                --only column \"name\" is specified, to the non specified
                --column \"did\" will be assigned its default value:
                --
                INSERT INTO distributors (name) VALUES ('British Lion');
          

                --Insert several rows into table films from table tmp:
                --
                INSERT INTO films
                SELECT * FROM tmp;
          

                --Insert into arrays:
                --Create an empty 3x3 gameboard for noughts-and-crosses
                --(all of these queries create the same board attribute)
                --(Refer to the PostgreSQL User's Guide for further
                --information about arrays).
                
                INSERT INTO tictactoe (game, board\[1:3\]\[1:3\])
                    VALUES (1,'\{\{\"\",\"\",\"\"\},\{\},\{\"\",\"\"\}\}');
                INSERT INTO tictactoe (game, board\[3\]\[3\])
                    VALUES (2,'\{\}');
                INSERT INTO tictactoe (game, board)
                    VALUES (3,'\{\{,,\},\{,,\},\{,,\}\}');

" {code} "Compatibility" {bold} "

SQL92 

The INSERT statement is fully compatible with SQL92. Possible limitations in features of the query clause are documented for the SELECT statement. 
"
@
