Mit dieser Anweisung fügen Sie eine einzelne Zeile (Syntax 1) oder eine Reihe von Zeilen von einer anderen Stelle in der Datenbank (Syntax 2) in eine Tabelle ein.

Syntax 1

INSERT [ INTO ] [ Eigentümer.]Tabellenname [ ( Spaltenname, ... ) ]
[ ON EXISTING { 
   ERROR 
   | SKIP 
   | UPDATE [ DEFAULTS { ON | OFF } ] 
   } ]
{ DEFAULT VALUES 
   | VALUES ( [ Ausdruck | DEFAULT, ...) ] }
[ OPTION( Abfrage-Hint, ... ) ]

Syntax 2

INSERT [ INTO ] [ Eigentümer.]Tabellenname [ ( Spaltenname, ... ) ]
[ ON EXISTING { 
   ERROR 
   | SKIP 
   | UPDATE [ DEFAULTS { ON | OFF } ] 
   } ]
[ WITH AUTO NAME ]
Select-Anweisung
[ OPTION( Abfragen-Hint, ... ) ]

Abfrage-Hint :
MATERIALIZED VIEW OPTIMIZATION Optionswert
| FORCE OPTIMIZATION
| FORCE NO OPTIMIZATION
| Optionsname = Optionswert

Optionsname : Bezeichner

Optionswert : Hostvariable (Bezeichner zulässig), Zeichenfolge, Bezeichner oder Zahl

Parameter

Bemerkungen

Die INSERT-Anweisung wird verwendet, um Zeilen in eine Datenbanktabelle einzufügen.

Da Textindizes und materialisierte Ansichten von Änderungen an den darunterliegenden Tabellendaten betroffen sind, ist es sinnvoll, abhängige Textindizes oder materialisierte Ansichten vor dem Massenimport von Daten (LOAD TABLE, INSERT, MERGE) in die Basistabellen zu kürzen. Weitere Hinweise finden Sie unter TRUNCATE-Anweisung und TRUNCATE TEXT INDEX-Anweisung.

Syntax 1   Fügt eine einzelne Zeile mit den angegebenen Ausdruckswerten für die Spalte ein. Das Schlüsselwort DEFAULT kann verwendet werden, um den Standardwert für die Spalte einzufügen. Wenn die optionale Liste der Spaltennamen angegeben ist, werden die Werte einzeln in die angegebenen Spalten eingefügt. Wird keine Liste für die Spaltennamen definiert, werden die Werte in der Reihenfolge in die Tabelle eingefügt, in der sie generiert werden (dieselbe Reihenfolge wie mit SELECT *). Die Zeile wird an einer beliebigen Stelle in die Tabelle eingefügt. (In relationalen Datenbanken werden Tabellen nicht sortiert.)

Syntax 2   Führt eine Masseneinfügung in eine Tabelle mit den Ergebnismengen einer vollständigen allgemeinen SELECT-Anweisung aus. Einfügungen werden in einer beliebigen Reihenfolge vorgenommen, es sei denn, die SELECT-Anweisung enthält eine ORDER BY-Klausel. Weitere Hinweise finden Sie unter SELECT-Anweisung.

Die Spalten aus der Auswahlliste werden ordinal den in der Spaltenliste angegebenen Spalten oder sequentiell in der Reihenfolge, in der die Spalten erstellt wurden, zugeordnet.

INSERT-Anweisungen können in Ansichten ausgeführt werden, wenn die Abfragespezifikation, die die Ansicht definiert, aktualisierbar ist. Weitere Hinweise zur Erkennung von Ansichten, die inhärent nicht aktualisierbar sind, finden Sie unter Mit regulären Ansichten arbeiten.

In Tabellen eingefügte Zeichenfolgen werden immer in der gleichen Schreibung (groß oder klein) gespeichert, in der sie eingegeben wurden, unabhängig davon, ob die Datenbank die Groß-/Kleinschreibung berücksichtigt oder nicht. So wird z.B. die Zeichenfolge Value, die in eine Tabelle eingegeben wurde, in der Datenbank immer mit einem großen V und dem Rest in Kleinbuchstaben gespeichert. SELECT-Anweisungen geben die Zeichenfolge als Value zurück. Wenn die Datenbank die Groß-/Kleinschreibung jedoch nicht berücksichtigt, ist Value dasselbe wie value, VALUE usw. Wenn außerdem ein Primärschlüssel für eine Spalte einen Eintrag mit Value enthält, wird ein INSERT von value zurückgewiesen, da der Primärschlüssel dann nicht eindeutig wäre.

Das Einfügen großer Datenmengen mit der INSERT-Anweisung aktualisiert auch die Spaltenstatistiken.

Berechtigungen

INSERT-Berechtigung für die Tabelle ist erforderlich.

Wenn die Klausel ON EXISTING UPDATE angegeben ist, sind zusätzlich UPDATE-Berechtigungen für die Tabelle erforderlich.

Nebenwirkungen

Keine.

Siehe auch

• Daten importieren
• MERGE-Anweisung
• INPUT-Anweisung [Interactive SQL]
• LOAD TABLE-Anweisung
• UPDATE-Anweisung
• DELETE-Anweisung
• PUT-Anweisung [ESQL]
• Auf Daten auf Clientcomputern zugreifen

Standards und Kompatibilität

Beispiele

Fügen Sie "Eastern Sales department" zur Datenbank hinzu:

INSERT
INTO Departments ( DepartmentID, DepartmentName )
VALUES ( 230, 'Eastern Sales' );

Erstellen Sie die Tabelle 'DepartmentHead' mit den Namen der Abteilungsleiter (department heads) und ihren Abteilungen (departments) unter Verwendung der Syntax WITH AUTO NAME:

CREATE TABLE DepartmentHead(
      pk INT PRIMARY KEY DEFAULT AUTOINCREMENT,
      DepartmentName VARCHAR(128),
      ManagerName VARCHAR(128) );
INSERT
INTO DepartmentHead WITH AUTO NAME
SELECT GivenName || ' ' || Surname AS ManagerName,
      DepartmentName
FROM Employees JOIN Departments
ON EmployeeID = DepartmentHeadID;

Erstellen Sie die Tabelle 'MyTable5' und fügen Sie mithilfe der WITH AUTO NAME-Syntax Daten ein.

CREATE TABLE MyTable5(
      pk INT PRIMARY KEY DEFAULT AUTOINCREMENT,
      TableName CHAR(128),
      TableNameLen INT );
INSERT INTO MyTable5 WITH AUTO NAME
SELECT
      length(t.table_name) AS TableNameLen,
      t.table_name AS TableName
FROM SYS.SYSTAB t
WHERE table_id <= 10;

Fügen Sie eine neue Abteilung ein, wobei Sie die Anweisung auf Isolationsstufe 3 ausführen und nicht die aktuelle Isolationsstufeneinstellung der Datenbank verwenden.

INSERT INTO Departments
   (DepartmentID, DepartmentName, DepartmentHeadID)
   VALUES(600, 'Foreign Sales', 129)
   OPTION( isolation_level = 3 );