INSERT

INSERT - Insert in a database table

Variants:

1. INSERT INTO dbtab VALUES wa. or
INSERT INTO (dbtabname) VALUES wa.
2. INSERT dbtab. or
INSERT *dbtab. or
INSERT (dbtabname) ...
3. INSERT dbtab FROM TABLE itab. or
INSERT (dbtabname) FROM TABLE itab.

Effect

Inserts new lines in a

database table.

You can specify the name of the database table either in the program itself in the form dbtab or at runtime as the contents of the field dbtabname. In both cases, the database table must be defined in the ABAP/4 Dictionary. If the program contains the name of the database table, it must also include a corresponding TABLES statement. Data can only be inserted using a view if the view refers to a single table and was defined in the ABAP/4 Dictionary with the maintenance status "No restriction".
By default, data are inserted only in the current client. If you use CLIENT SPECIFIED , automatic client handling is switched off. This allows you to insert data across all clients even when dealing withclient-specific tables. The client field is then treated like a normal table field which you can program to accept values in the work area wa that contains the line to be inserted.

INSERT belongs to the Open SQL command set.

You cannot insert a line if a line with the same primary key already exists or if a UNIQUE index already has a line with identical key field values.

Variant 1

INSERT INTO dbtab [CLIENT SPECIFIED] VALUES wa. or
INSERT INTO (dbtabname) [CLIENT SPECIFIED] VALUES wa.


The line to be inserted is taken from the work area wa and the data read from left to right according to the structure of the table work area dbtab (see TABLES). Here, the structure of wa is not taken into account. For this reason, the work area wa must be at least as wide (see DATA) as the table work area dbtab and the alignment of the work area wa must correspond to the alignment of the table work area. Otherwise, a runtime error occurs.

When the command has been executed, the system field SY-DBCNT contains the number of inserted lines (0 or 1).

SY-SUBRC = 4:

Line could not be inserted since a line with the same key already exists.

TABLES SCUSTOM. 
SCUSTOM-ID		= '12400177'. 
SCUSTOM-NAME	= 'Robinson'. 
SCUSTOM-POSTCODE  = '69542'. 
SCUSTOM-CITY	= 'Heidelberg'. 
SCUSTOM-CUSTTYPE  = 'P'. 
SCUSTOM-DISCOUNT  = '003'. 
SCUSTOM-TELEPHONE = '06201/44889'. 
 
INSERT INTO SCUSTOM VALUES SCUSTOM.
TABLES SCUSTOM. 
SCUSTOM-MANDT	 = '002'. 
SCUSTOM-ID		= '12400177'. 
SCUSTOM-NAME	= 'Robinson'. 
SCUSTOM-POSTCODE  = '69542'. 
SCUSTOM-CITY	= 'Heidelberg'. 
SCUSTOM-CUSTTYPE  = 'P'. 
SCUSTOM-DISCOUNT  = '003'. 
SCUSTOM-TELEPHONE = '06201/44889'. 
 
INSERT INTO SCUSTOM CLIENT SPECIFIED VALUES SCUSTOM.

Variant 2

INSERT dbtab [CLIENT SPECIFIED]. or
INSERT *dbtab [CLIENT SPECIFIED]. or
INSERT (dbtabname) [CLIENT SPECIFIED] ...

... FROM wa

Effect

These are the SAP-specific short forms for the statements explained under variant 1.

If the name of the databse table is determined at runtime, you have to specifiy the addition ...FROM wa . When the command has been executed, the system field SY-DBCNT contains the number of inserted lines (0 or 1).

SY-SUBRC = 4:

Line could not be inserted, since a line with the same key already exists.

TABLES SAIRPORT. 
SAIRPORT-ID   = 'NEW'. 
SAIRPORT-NAME = 'NEWPORT APT'. 
 
INSERT SAIRPORT. 

Effect

The values for the line to be inserted are not taken from the table work area dbtab, but from the explicitly specified work area wa. The work area wa must also satisfy the conditions described in variant 1. As with this variant, the addition allows you to specify the name of the database table directly or indirectly.

Note

If a work area is not explicitly specified, the values for the line to be inserted are taken from the table work area dbtab if the statement is in a FORM or FUNCTION where the table work area is stored in a formal parameter or local variable of the same name.

Variant 3

INSERT dbtab FROM TABLE itab. or
INSERT (dbtabname) [CLIENT SPECIFIED] FROM TABLE itab.

... ACCEPTING DUPLICATE KEYS

Effect

Mass insert: Inserts all lines of the internal table itab in a single operation. The lines of itab must satisfy the same conditions as the work area wa in variant 1.

When the command has been executed, the system field SY-DBCNT contains the number of inserted lines.

SY-SUBRC = 0:

All lines successfully inserted. Any other result causes a runtime error.

Note

If the internal table itab is empty, SY-SUBRC and SY-DBCNT are set to 0 after the call.

Effect

If a line cannot be inserted, the processing does not terminate with a runtime error, but the return code of SY-SUBRC is merely set to 4. All the remaining lines are inserted when the command is executed.