INSERT (mehrere Tabellen)¶

Syntax¶

-- Unconditional multi-table insert
INSERT [ OVERWRITE ] ALL
  intoClause [ ... ]
<subquery>

-- Conditional multi-table insert
INSERT [ OVERWRITE ] { FIRST | ALL }
  { WHEN <condition> THEN intoClause [ ... ] }
  [ ... ]
  [ ELSE intoClause ]
<subquery>

Wobei:

intoClause ::=
  INTO <target_table> [ ( <target_col_name> [ , ... ] ) ] [ VALUES ( { <source_col_name> | DEFAULT | NULL } [ , ... ] ) ]

Copy

Erforderliche Parameter¶

ALL

Nur bedingungsloses Einfügen in mehrere Tabellen

Gibt an, dass jede Zeile jede INTO-Klausel in der INSERT-Anweisung ausführt.

Bemerkung

Wenn das Schlüsselwort FIRST bei einem bedingungslosen Einfügen in mehrere Tabellen angegeben wird (oder das Schlüsselwort ALL nicht angegeben wird), gibt Snowflake einen Syntaxfehler zurück.

FIRST oder ALL

Nur bedingtes Einfügen in mehrere Tabellen

FIRST

Gibt an, dass jede Zeile nur die erste WHEN-Klausel ausführt, für die die Bedingung TRUE ergibt. Wenn keine WHEN-Klausel den Wert TRUE ergibt, wird die ELSE-Klausel, falls vorhanden, ausgeführt.

ALL

Gibt an, dass jede Zeile alle WHEN-Klauseln ausführt. Wenn keine WHEN-Klausel den Wert TRUE ergibt, wird die ELSE-Klausel, falls vorhanden, ausgeführt.

Bemerkung

• Ein bedingtes Einfügen in mehrere Tabellen muss mindestens eine WHEN-Klausel enthalten.

• Jede WHEN-Klausel kann mehrere INTO-Klauseln enthalten, und die INTO-Klauseln können Einfügungen in dieselbe Zieltabelle vornehmen.

• Damit eine WHEN-Klausel immer ausgeführt wird, verwenden Sie Folgendes:

  WHEN 1=1 THEN ...

condition

Nur bedingtes Einfügen in mehrere Tabellen

Gibt die Bedingung an, die TRUE ergeben muss, damit die in der INTO-Klausel angegebenen Werte eingefügt werden können. Die Bedingung kann eine SELECT-Liste sein.

target_table

Gibt eine Zieltabelle an, in die Zeilen eingefügt werden sollen. Auf dieselbe Tabelle kann mehr als einmal verwiesen werden (in separaten WHEN-Klauseln).

Es können mehrere Zieltabellen angegeben werden, indem für jede Tabelle eine INTO-Klausel eingefügt wird.

subquery

Gibt die SELECT-Liste an, die die Quelle der Werte bestimmt, die in die Zieltabellen eingefügt werden sollen.

Optionale Parameter¶

OVERWRITE

Gibt an, dass die Zieltabellen vor dem Einfügen in die Tabellen gekürzt werden, während die Zugriffssteuerungsrechte an den Tabellen erhalten bleiben.

INSERT-Anweisungen mit OVERWRITE können im Rahmen der aktuellen Transaktion verarbeitet werden, wodurch DDL-Anweisungen vermieden werden, die eine Transaktion bestätigen (Commit), wie z. B.:

DROP TABLE t;
CREATE TABLE t AS SELECT * FROM ... ;

Copy

Standard: Kein Wert (die Zieltabellen werden vor dem Einfügen nicht gekürzt)

( target_col_name [ , ... ] )

Gibt eine oder mehrere Spalten in der Zieltabelle an, in die die Werte aus der entsprechenden Spalte der Quelle eingefügt werden. Die Anzahl der angegebenen Zielspalten muss mit der Anzahl der in der Quelle angegebenen Werte übereinstimmen.

Standard: Kein Wert (alle Spalten in der Zieltabelle werden aktualisiert)

VALUES ( source_col_name | DEFAULT | NULL [ , ... ] )

Gibt einen oder mehrere Werte an, die in die entsprechenden Spalten der Zieltabelle eingefügt werden sollen. Folgende Werte sind möglich:

• source_col_name: Gibt die Spalte in der Quelle an, die den Wert enthält, der in die entsprechende Spalte der Zieltabelle eingefügt werden soll.

• DEFAULT: Fügt den Standardwert für die entsprechende Spalte in die Zieltabelle ein.

• NULL: Fügt einen NULL-Wert ein.

Jeder Wert in der Klausel muss durch ein Komma getrennt werden. Außerdem muss die Anzahl der angegebenen Werte mit der Anzahl der für die Zieltabelle angegebenen Spalten übereinstimmen.

Standard: Kein Wert (Werte aus allen Spalten der Quelle werden in die entsprechenden Spalten in der Zieltabelle eingefügt)

Nutzungshinweise¶

• In einer INTO-Klausel ist die VALUES-Klausel optional. Wird sie weggelassen, werden die Werte aus der SELECT-Liste in natürlicher Reihenfolge in die Zieltabelle eingefügt.

• Ausdrücke in WHEN-Klauseln (bei bedingtem Einfügen in mehrere Tabellen) und VALUES-Klauseln können nur über einen Alias auf die Unterabfrage verweisen. Der Alias muss einer der folgenden sein:

  • Expliziter Alias, der für einen SELECT-Ausdruck angegeben wird.

  • Standard-Alias für einen Ausdruck.

  • Positionsalias ($1, $2 usw.).

  Darüber hinaus können Spalten und Ausdrücke der Unterabfrage, die sich nicht in der äußersten SELECT-Liste befinden, nicht in WHEN- und VALUES-Klauseln referenziert werden. Weitere Details dazu finden Sie unter Beispiele (unter diesem Thema).

• In jeder von der Unterabfrage subquery erzeugten Zeile muss der Wert in der Quellspalte source_col_name mit dem Datentyp der entsprechenden Zielspalte target_col_name kompatibel sein. Diese Regel gilt auch für Zeilen, die durch die condition-Bedingung in der WHEN-Klausel herausgefiltert werden würden. Die Reihenfolge der Operationen garantiert nicht, dass der Filter in der WHEN-Klausel angewendet wird, bevor der Wert in der Quellspalte mit dem Namen source_col_name auf Datentypkompatibilität ausgewertet wird.

Beispiele¶