CREATE TABLE¶

Syntax¶

CREATE [ OR REPLACE ]
    [ { [ { LOCAL | GLOBAL } ] TEMP | TEMPORARY | VOLATILE | TRANSIENT } ]
  TABLE [ IF NOT EXISTS ] <table_name> (
    -- Column definition
    <col_name> <col_type>
      [ inlineConstraint ]
      [ NOT NULL ]
      [ COLLATE '<collation_specification>' ]
      [
        {
          DEFAULT <expr>
          | { AUTOINCREMENT | IDENTITY }
            [
              {
                ( <start_num> , <step_num> )
                | START <num> INCREMENT <num>
              }
            ]
            [ { ORDER | NOORDER } ]
        }
      ]
      [ [ WITH ] MASKING POLICY <policy_name> [ USING ( <col_name> , <cond_col1> , ... ) ] ]
      [ [ WITH ] PROJECTION POLICY <policy_name> ]
      [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
      [ COMMENT '<string_literal>' ]

    -- Additional column definitions
    [ , <col_name> <col_type> [ ... ] ]

    -- Out-of-line constraints
    [ , outoflineConstraint [ ... ] ]
  )
  [ CLUSTER BY ( <expr> [ , <expr> , ... ] ) ]
  [ ENABLE_SCHEMA_EVOLUTION = { TRUE | FALSE } ]
  [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
  [ CHANGE_TRACKING = { TRUE | FALSE } ]
  [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
  [ COPY GRANTS ]
  [ COMMENT = '<string_literal>' ]
  [ [ WITH ] ROW ACCESS POLICY <policy_name> ON ( <col_name> [ , <col_name> ... ] ) ]
  [ [ WITH ] AGGREGATION POLICY <policy_name> [ ENTITY KEY ( <col_name> [ , <col_name> ... ] ) ] ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]

Wobei:

inlineConstraint ::=
  [ CONSTRAINT <constraint_name> ]
  { UNIQUE
    | PRIMARY KEY
    | [ FOREIGN KEY ] REFERENCES <ref_table_name> [ ( <ref_col_name> ) ]
  }
  [ <constraint_properties> ]

Copy

Weitere Details zu Inline-Einschränkungen finden Sie unter CREATE | ALTER TABLE … CONSTRAINT.

outoflineConstraint ::=
  [ CONSTRAINT <constraint_name> ]
  { UNIQUE [ ( <col_name> [ , <col_name> , ... ] ) ]
    | PRIMARY KEY [ ( <col_name> [ , <col_name> , ... ] ) ]
    | [ FOREIGN KEY ] [ ( <col_name> [ , <col_name> , ... ] ) ]
      REFERENCES <ref_table_name> [ ( <ref_col_name> [ , <ref_col_name> , ... ] ) ]
  }
  [ <constraint_properties> ]
  [ COMMENT '<string_literal>' ]

Copy

Weitere Details zu Out-of-Line-Einschränkungen finden Sie unter CREATE | ALTER TABLE … CONSTRAINT.

Syntaxvariante¶

CREATE OR ALTER
    [ { [ { LOCAL | GLOBAL } ] TEMP | TEMPORARY | TRANSIENT } ]
  TABLE <table_name> (
    -- Column definition
    <col_name> <col_type>
      [ inlineConstraint ]
      [ NOT NULL ]
      [ COLLATE '<collation_specification>' ]
      [
        {
          DEFAULT <expr>
          | { AUTOINCREMENT | IDENTITY }
            [
              {
                ( <start_num> , <step_num> )
                | START <num> INCREMENT <num>
              }
            ]
            [ { ORDER | NOORDER } ]
        }
      ]
      [ COMMENT '<string_literal>' ]

    -- Additional column definitions
    [ , <col_name> <col_type> [ ... ] ]

    -- Out-of-line constraints
    [ , outoflineConstraint [ ... ] ]
  )
  [ CLUSTER BY ( <expr> [ , <expr> , ... ] ) ]
  [ ENABLE_SCHEMA_EVOLUTION = { TRUE | FALSE } ]
  [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
  [ CHANGE_TRACKING = { TRUE | FALSE } ]
  [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
  [ COMMENT = '<string_literal>' ]

Erforderliche Parameter¶

name

Gibt den Bezeichner (d. h. den Namen) für die Tabelle an. Dieser muss für das Schema, in dem die Tabelle erstellt wird, eindeutig sein.

Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Details dazu finden Sie unter Anforderungen an Bezeichner.

col_name

Gibt den Spaltenbezeichner (d. h. den Namen) an. Alle Anforderungen an Tabellenbezeichner gelten auch für Spaltenbezeichner.

Weitere Details dazu finden Sie unter Anforderungen an Bezeichner und Reservierte und beschränkte Schlüsselwörter.

Bemerkung

Zusätzlich zu den standardmäßig reservierten Schlüsselwörtern können die folgenden Schlüsselwörter nicht als Spaltenbezeichner verwendet werden, da sie für Kontextfunktionen nach ANSI-Standard reserviert sind:

• CURRENT_DATE

• CURRENT_ROLE

• CURRENT_TIME

• CURRENT_TIMESTAMP

• CURRENT_USER

Die Liste der reservierten Schlüsselwörter finden Sie unter Reservierte und beschränkte Schlüsselwörter.

col_type

Gibt den Datentyp für die Spalte an.

Einzelheiten zu den Datentypen, die für Tabellenspalten angegeben werden können, finden Sie unter Referenz der SQL-Datentypen.

query

Erforderlich für CTAS und USING TEMPLATE.

• Gibt bei CTAS die SELECT-Anweisung an, mit der die Tabelle aufgefüllt wird.

• Gibt bei CREATE TABLE … USING TEMPLATE die Unterabfrage an, die die Funktion INFER_SCHEMA aufruft und die Ausgabe als Array formatiert. Alternativ akzeptiert USING TEMPLATE die Ausgabe von INFER_SCHEMA als Zeichenfolgenliteral oder Variable.

source_table

Erforderlich für LIKE und CLONE.

• Gibt bei CREATE TABLE … LIKE die Tabelle an, aus der Eigenschaften und Spaltendefinitionen kopiert werden.

• Gibt bei CREATE TABLE … CLONE die Tabelle an, die als Quelle für den Klon verwendet werden soll.

Optionale Parameter¶

{ [ { LOCAL | GLOBAL } ] TEMP [ READ ONLY] | ` :newline:.` TEMPORARY [ READ ONLY] | . VOLATILE | ` :newline:.` TRANSIENT }

Legt fest, dass die Tabelle nur für die Dauer der Sitzung bestehen bleibt, in der Sie sie erstellt haben. Eine temporäre Tabelle mit allen Inhalten wird am Ende der Sitzung gelöscht.

Die Synonyme und Abkürzungen für TEMPORARY (z. B. GLOBAL TEMPORARY) sind aus Gründen der Kompatibilität mit anderen Datenbanken vorgesehen (z. B. um Fehler bei der Migration von CREATE TABLE-Anweisungen zu vermeiden). Tabellen, die mit einem dieser Schlüsselwörter erstellt wurden, werden wie Tabellen angezeigt, die mit dem Schlüsselwort TEMPORARY erstellt wurden.

Standard: Kein Wert. Wenn eine Tabelle nicht als TEMPORARY oder TRANSIENT deklariert ist, ist die Tabelle permanent.

Wenn Sie unerwartete Konflikte vermeiden möchten, benennen Sie temporäre Tabellen nicht nach Tabellen, die bereits im Schema vorhanden sind.

Wenn Sie eine temporäre Tabelle mit demselben Namen wie eine andere Tabelle im Schema erstellt haben, wirken sich alle Abfragen und Operationen, die auf der Tabelle ausgeführt werden, nur auf die temporäre Tabelle in der Sitzung aus, bis Sie die temporäre Tabelle löschen. Wenn Sie die Tabelle löschen, löschen Sie die temporäre Tabelle und nicht die Tabelle, die bereits im Schema vorhanden ist.

Weitere Informationen zu temporären und transienten Tabellen und wie diese sich auf den Speicherplatz und die Kosten auswirken können, finden Sie unter folgenden Themen:

• Verwenden von temporären und transienten Tabellen

• Speicherkosten für Time Travel und Fail-safe

READ ONLY

Gibt an, dass die Tabelle schreibgeschützt ist. READ ONLY ist nur für eine temporäre Tabelle gültig, die mit der CREATE TABLE … CLONE-Variante des CREATE TABLE-Befehls erstellt wird.

Eine schreibgeschützte Tabelle lässt keine DML-Operationen zu und erlaubt nur die folgende Teilmenge von DDL-Operationen:

• ALTER TABLE … { ALTER | MODIFY } COLUMN … { SET | UNSET } COMMENT

• ALTER TABLE … { ALTER | MODIFY } COLUMN … { SET | UNSET } MASKING POLICY

• ALTER TABLE … { ALTER | MODIFY } COLUMN … { SET | UNSET } TAG

• ALTER TABLE … RENAME COLUMN … TO

• ALTER TABLE … RENAME TO

• ALTER TABLE … { SET | UNSET } COMMENT

• ALTER TABLE … { SET | UNSET } TAG

• COMMENT

• DESCRIBE

• DROP

• SHOW

• UNDROP

Schreibgeschützte Tabellen haben eine METADATA$ROW_POSITION-Spalte. Diese Metadaten-Spalte weist jeder Zeile in der Tabelle eine Zeilennummer zu, die fortlaufend ist und bei 0 beginnt. Die Zeilennummer, die jeder Zeile zugewiesen wird, bleibt unverändert, bis die schreibgeschützte Tabelle gelöscht wird.

TRANSIENT

Gibt an, dass die Tabelle transient ist.

Wie eine permanente Tabelle existiert auch eine transiente Tabelle bis zum expliziten Löschen und ist für jeden Benutzer mit den entsprechenden Berechtigungen sichtbar. Transiente Tabellen haben jedoch ein niedrigeres Datenschutzniveau als permanente Tabellen, sodass im Falle eines Systemausfalls Daten in einer transienten Tabelle verloren gehen können. Daher sollten transiente Tabellen nur für Daten verwendet werden, die außerhalb von Snowflake wiederhergestellt werden können.

Standard: Kein Wert. Wenn eine Tabelle nicht als TRANSIENT oder TEMPORARY deklariert ist, ist die Tabelle permanent.

Bemerkung

Bei transienten Tabellen müssen einige Hinwiese zur Speicherung berücksichtigt werden.

Weitere Informationen zu diesen und anderen Überlegungen bei der Entscheidung, ob temporäre oder transiente Tabellen erstellt werden sollen, finden Sie unter Verwenden von temporären und transienten Tabellen und Speicherkosten für Time Travel und Fail-safe.

CONSTRAINT ...

Definiert eine Inline- oder Out-of-Line-Beschränkung für die angegebenen Spalten in der Tabelle.

Weitere Informationen zur Syntax finden Sie unter CREATE | ALTER TABLE … CONSTRAINT. Weitere Informationen zu Einschränkungen finden Sie unter Einschränkungen.

COLLATE 'collation_specification'

Gibt die Sortierung an, die für Spaltenoperationen wie den Zeichenfolgenvergleich verwendet werden soll. Diese Option gilt nur für Textspalten (z. B. VARCHAR, STRING, TEXT usw.). Weitere Details dazu finden Sie unter Sortierungsspezifikationen.

DEFAULT ... oder . AUTOINCREMENT ...

Gibt an, ob der Spalte ein Standardwert zugewiesen wird, wenn ein Wert nicht über eine INSERT- oder CREATE TABLE AS SELECT-Anweisung angegeben wird:

DEFAULT expr

Der Standardwert für die Spalte wird durch den angegebenen Ausdruck definiert. Eine der folgenden Optionen ist möglich:

• Konstantenwert

• Sequenzreferenz (seq_name.NEXTVAL)

• Einfacher Ausdruck, der einen skalaren Wert zurückgibt.

  Der einfache Ausdruck kann eine SQL-UDF (benutzerdefinierte Funktion) enthalten, wenn die UDF keine sichere UDF ist.

  Bemerkung

  Wenn sich ein Standardausdruck auf eine benutzerdefinierte SQL-UDF bezieht, wird die Funktion beim Erstellen der Tabelle durch deren Definition ersetzt. Wenn die benutzerdefinierte Funktion in Zukunft neu definiert wird, führt dies nicht zur Aktualisierung des Standardausdrucks der Spalte.

  Der einfache Ausdruck darf keine Referenzen enthalten auf:

  • Unterabfragen

  • Aggregationen

  • Fensterfunktionen

  • Sichere UDFs

  • UDFs, die in anderen Sprachen als SQL geschrieben sind (z. B. Java, JavaScript)

  • Externe Funktionen

{ AUTOINCREMENT | IDENTITY } . [ { ( start_num , step_num ) | START num INCREMENT num } ] . [ { ORDER | NOORDER } ]

Wenn Sie AUTOINCREMENT oder IDENTITY angeben, beginnt der Standardwert der Spalte mit einer bestimmten Zahl, und jeder nachfolgende Wert wird automatisch um den angegebenen Betrag erhöht.

AUTOINCREMENT und IDENTITY sind gleichbedeutend und können nur bei Spalten mit numerischen Datentypen wie NUMBER, INT, FLOAT verwendet werden.

Vorsicht

Snowflake verwendet eine Sequenz, um die Werte für eine automatisch inkrementierte Spalte zu generieren. Sequenzen haben Einschränkungen. Weitere Informationen dazu finden Sie unter Semantik von Sequenzen.

Der Standardwert sowohl für den Startwert als auch für den Schritt-/Erhöhungswert ist 1.

Bemerkung

Das manuelle Einfügen von Werten in eine AUTOINCREMENT- oder IDENTITY-Spalte kann zu doppelten Werten führen. Wenn Sie den Wert 5 manuell in eine AUTOINCREMENT- oder IDENTITY-Spalte einfügen, könnte eine später eingefügte Zeile denselben Wert 5 als Standardwert für die Spalte verwenden.

Verwenden Sie ORDER oder NOORDER, um anzugeben, ob die Werte für die Sequenz in aufsteigender oder absteigender Reihenfolge generiert werden sollen.

• ORDER gibt an, dass die Werte, die für eine Sequenz oder eine automatisch inkrementierte Spalte generiert werden, in aufsteigender Reihenfolge sind (oder, wenn das Intervall einen negativen Wert hat, in abnehmender Reihenfolge).

  Wenn beispielsweise eine Sequenz oder eine automatisch inkrementierte Spalte die Werte START 1 INCREMENT 2 hat, könnten die generierten Werte 1, 3, 5, 7, 9 usw. sein.

• NOORDER gibt an, dass nicht garantiert ist, dass die Werte in aufsteigender Reihenfolge sind.

  Wenn beispielsweise eine Sequenz die Werte START 1 INCREMENT 2 hat, könnten die generierten Werte 1, 3, 101, 5, 103 usw. sein.

  NOORDER kann die Leistung verbessern, wenn mehrere INSERT-Operationen gleichzeitig ausgeführt werden (z- B., wenn mehrere Clients mehrere INSERT-Anweisungen ausführen).

Wenn Sie weder ORDER noch NOORDER angeben, bestimmt der Parameter NOORDER_SEQUENCE_AS_DEFAULT, welche Eigenschaft eingestellt wird.

Bemerkung

DEFAULT oder AUTOINCREMENT schließen sich gegenseitig aus. Für eine Spalte kann nur eine Option angegeben werden.

MASKING POLICY = policy_name

Gibt die Maskierungsrichtlinie an, die für eine Spalte festgelegt werden soll.

Dieser Parameter wird von der CREATE OR ALTER-Syntaxvariante nicht unterstützt.

PROJECTION POLICY policy_name

Gibt die Projektionsrichtlinie an, die für eine Spalte festgelegt werden soll.

Dieser Parameter wird von der CREATE OR ALTER-Syntaxvariante nicht unterstützt.

COMMENT 'string_literal'

Gibt einen Kommentar für die Spalte an.

(Beachten Sie, dass Kommentare auf Spaltenebene oder auf Tabellenebene angegeben werden können. Die Syntax ist jeweils leicht unterschiedlich.)

USING ( col_name , cond_col_1 ... )

Gibt die Argumente an, die an den SQL-Ausdruck für die bedingte Maskierungsrichtlinie übergeben werden sollen.

Die erste Spalte in der Liste gibt die Spalte für die Richtlinienbedingungen zur Maskierung oder Tokenisierung der Daten an. Sie muss mit der Spalte übereinstimmen, für die die Maskierungsrichtlinie festgelegt ist.

Die zusätzlichen Spalten geben an, welche Spalten ausgewertet werden sollen, um zu ermitteln, ob die Daten in der jeweiligen Zeile des Abfrageergebnisses maskiert oder tokenisiert werden sollen, wenn auf der ersten Spalte eine Abfrage ausgeführt wird.

Wenn die USING-Klausel weggelassen wird, behandelt Snowflake die bedingte Maskierungsrichtlinie wie eine normale Maskierungsrichtlinie.

CLUSTER BY ( expr [ , expr , ... ] )

Gibt eine oder mehrere Spalten oder Spaltenausdrücke in der Tabelle als Gruppierungsschlüssel an. Weitere Details dazu finden Sie unter Gruppierungsschlüssel und geclusterte Tabellen.

Standard: Kein Wert (für die Tabelle ist kein Gruppierungsschlüssel definiert)

Wichtig

Gruppierungsschlüssel sind nicht für alle Tabellen vorgesehen oder empfehlenswert. Sie eignen sich vorrangig für sehr große Tabellen (im Multi-Terabyte-Bereich).

Bevor Sie Gruppierungsschlüssel für eine Tabelle angeben, sollten Sie sich erst mit Mikropartitionen vertraut machen. Weitere Informationen dazu finden Sie unter Grundlegendes zu Tabellenstrukturen in Snowflake.

ENABLE_SCHEMA_EVOLUTION = { TRUE | FALSE }

Aktiviert oder deaktiviert automatische Änderungen am Tabellenschema durch Daten, die aus Quelldateien in die Tabelle geladen werden, einschließlich:

• Hinzugefügte Spalten.

  Standardmäßig ist die Schemaentwicklung auf maximal 10 hinzugefügte Spalten pro Ladeoperation beschränkt. Um mehr als 10 hinzugefügte Spalten pro Ladeoperation anzufordern, wenden Sie sich an den Snowflake-Support.

• Die Einschränkung NOT NULL kann für eine beliebige Anzahl von Spalten, die in neuen Datendateien fehlen, gelöscht werden.

Wenn Sie diese Option auf TRUE setzen, wird die automatische Tabellenschemaentwicklung aktiviert. Die Standardeinstellung FALSE deaktiviert die automatische Tabellenschemaentwicklung.

Bemerkung

Beim Laden von Daten aus Dateien erfolgt eine Tabellenspaltenentwicklung, wenn die folgenden Bedingungen erfüllt sind:

• Die COPY INTO <Tabelle>-Anweisung enthält den Parameter MATCH_BY_COLUMN_NAME.

• Die Rolle, mit der die Daten geladen werden, hat die EVOLVE SCHEMA- oder die OWNERSHIP-Berechtigung für die Tabelle.

Außerdem muss für die Schemaentwicklung mit CSV bei Verwendung von MATCH_BY_COLUMN_NAME und PARSE_HEADER der Parameter ERROR_ON_COLUMN_COUNT_MISMATCH auf „false“ gesetzt sein.

DATA_RETENTION_TIME_IN_DAYS = integer

Gibt die Aufbewahrungsfrist für die Tabelle an, sodass Time Travel-Aktionen (SELECT, CLONE, UNDROP) für historische Daten in der Tabelle durchgeführt werden können. Weitere Details dazu finden Sie unter Verstehen und Verwenden von Time Travel und Verwenden von temporären und transienten Tabellen.

Eine ausführliche Beschreibung dieses Parameters auf Objektebene sowie weitere Informationen zu Objektparametern finden Sie unter Parameter.

Werte:

• Standardausführung: 0 oder 1

• Enterprise Edition:

  • 0 bis 90 für permanente Tabellen

  • 0 oder 1 für temporäre und transiente Tabellen

Standard:

• Standardausführung: 1

• Enterprise Edition (oder höher): 1 (es sei denn, es wurde ein anderer Standardwert auf Schema-, Datenbank- oder Kontoebene angegeben).

Bemerkung

Der Wert 0 deaktiviert Time Travel für die Tabelle.

MAX_DATA_EXTENSION_TIME_IN_DAYS = integer

Objektparameter, der die maximale Anzahl von Tagen angibt, für die Snowflake die Datenaufbewahrungsfrist für die Tabelle verlängern kann, um zu verhindern, dass Streams auf der Tabelle veraltet sind.

Eine detaillierte Beschreibung dieses Parameters finden Sie unter MAX_DATA_EXTENSION_TIME_IN_DAYS.

CHANGE_TRACKING = { TRUE | FALSE }

Gibt an, ob die Änderungsverfolgung für die Tabelle aktiviert werden soll.

• TRUE aktiviert die Änderungsverfolgung der Tabelle. Diese Einstellung fügt der Quelltabelle ein Paar versteckter Spalten hinzu und beginnt mit der Speicherung von Metadaten zur Änderungsverfolgung in den Spalten. Diese Spalten verbrauchen nur wenig Speicherplatz.

  Die Metadaten zur Änderungsverfolgung können mit der CHANGES Klausel für SELECT Anweisungen abgefragt werden, oder indem Sie einen oder mehrere Streams in der Tabelle erstellen und abfragen.

• FALSE aktiviert die Änderungsverfolgung in der Tabelle nicht.

Standard: FALSE

DEFAULT_DDL_COLLATION = 'collation_specification'

Gibt eine Standardsortierungsspezifikation für die Spalten in der Tabelle an, einschließlich der Spalten, die der Tabelle in Zukunft hinzugefügt werden.

Weitere Informationen zu diesem Parameter finden Sie unter DEFAULT_DDL_COLLATION.

COPY GRANTS

Gibt an, dass die Zugriffsberechtigungen aus der Originaltabelle beibehalten werden, wenn eine neue Tabelle mit einer der folgenden CREATE TABLE-Varianten erstellt wird:

• CREATE OR REPLACE TABLE

• CREATE TABLE … LIKE

• CREATE TABLE … CLONE

Der Parameter kopiert alle Berechtigungen, mit Ausnahme von OWNERSHIP, aus der bestehenden Tabelle in die neue Tabelle. Die neue Tabelle übernimmt keine zukünftigen Berechtigungen, die für den Objekttyp im Schema definiert werden. Standardmäßig ist die Rolle, die die Anweisung CREATE TABLE ausführt, Eigentümer der neuen Tabelle.

Wenn der Parameter nicht in der CREATE TABLE-Anweisung enthalten ist, übernimmt die neue Tabelle keine expliziten Zugriffsrechte für die ursprüngliche Tabelle, übernimmt aber alle zukünftigen Berechtigungen, die für den Objekttyp im Schema definiert werden.

Hinweis:

• Mit Datenfreigabe:

  • Wenn die vorhandene Tabelle für ein anderes Konto freigegeben wurde, wird auch die Ersetzungstabelle freigegeben.

  • Wenn die vorhandene Tabelle für Ihr Konto als Datenverbraucher freigegeben wurde und der Zugriff auf andere Rollen im Konto weiter gewährt wurde (unter Verwendung von GRANT IMPORTED PRIVILEGES auf der übergeordneten Datenbank), wird auch der Zugriff auf die Ersetzungstabelle gewährt.

• Die SHOW GRANTS-Ausgabe für die Ersetzungstabelle listet den Berechtigungsempfänger für die kopierten Berechtigungen als Rolle auf, die die CREATE TABLE-Anweisung ausgeführt hat, mit dem aktuellen Zeitstempel, als die Anweisung ausgeführt wurde.

• Die Operation zum Kopieren von Berechtigungen erfolgt atomar im Befehl CREATE TABLE (d. h. innerhalb derselben Transaktion).

• Dieser Parameter wird von der CREATE OR ALTER-Syntaxvariante nicht unterstützt.

COMMENT = 'string_literal'

Gibt einen Kommentar für die Tabelle an.

Standard: Kein Wert

(Beachten Sie, dass Kommentare auf Spaltenebene, Einschränkungsebene oder Tabellenebene angegeben werden können. Die Syntax ist jeweils leicht unterschiedlich.)

ROW ACCESS POLICY policy_name ON ( col_name [ , col_name ... ] )

Gibt die Zeilenzugriffsrichtlinie an, die für eine Tabelle festgelegt werden soll.

Dieser Parameter wird von der CREATE OR ALTER-Syntaxvariante nicht unterstützt.

AGGREGATION POLICY policy_name [ ENTITY KEY ( col_name [ , col_name ... ] ) ]

Gibt die Aggregationsrichtlinie an, die für eine Tabelle festgelegt werden soll.

Verwenden Sie den optionalen Parameter ENTITY KEY, um festzulegen, welche Spalten eine Entität innerhalb der Tabelle eindeutig identifizieren. Weitere Informationen dazu finden Sie unter Implementieren von Datenschutz auf Entitätsebene mit Aggregationsrichtlinien.

Dieser Parameter wird von der CREATE OR ALTER-Syntaxvariante nicht unterstützt.

TAG ( tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] )

Gibt den Namen des Tags und den Wert der Tag-Zeichenfolge an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

Weitere Informationen zur Angabe von Tags in einer Anweisung finden Sie unter Tag-Kontingente für Objekte und Spalten.

Dieser Parameter wird von der CREATE OR ALTER-Syntaxvariante nicht unterstützt.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise¶

• Ein Schema darf keine Tabellen und/oder Ansichten mit gleichem Namen enthalten. Beim Erstellen einer Tabelle:

  • Wenn im Schema bereits eine Ansicht mit dem gleichen Namen vorhanden ist, wird ein Fehler zurückgegeben und die Tabelle nicht erstellt.

  • Wenn bereits eine Tabelle mit dem gleichen Namen im Schema existiert, wird ein Fehler zurückgegeben, und die Tabelle wird nicht erstellt, es sei denn, das optionale Schlüsselwort OR REPLACE ist im Befehl enthalten.

    Wichtig

    Die Verwendung von OR REPLACE ist gleichbedeutend mit der Verwendung von DROP TABLE auf der bestehenden Tabelle und der anschließenden Erstellung einer neuen Tabelle mit dem gleichen Namen. Die gelöschte Tabelle wird jedoch nicht dauerhaft aus dem System entfernt. Stattdessen wird sie in Time Travel aufbewahrt. Dies muss beachtet werden, da gelöschte Tabellen in Time Travel wiederhergestellt werden können und auch Datenspeicher Ihres Kontos verbrauchen. Weitere Informationen dazu finden Sie unter Speicherkosten für Time Travel und Fail-safe.

    CREATE OR REPLACE <Objekt>-Anweisungen sind atomar. Das heißt, wenn ein Objekt ersetzt wird, erfolgt das Löschen des alten Objekts und das Erstellen des neuen Objekts in einer einzigen Transaktion.

    Das bedeutet, dass alle Abfragen, die gleichzeitig mit der Operation CREATE OR REPLACE TABLE ausgeführt werden, entweder die alte oder die neue Version der Tabelle verwenden.

    Wenn eine Tabelle neu erstellt oder ausgetauscht wird, werden ihre Änderungsdaten gelöscht. Jeder Stream auf der Tabelle veraltet. Außerdem veralten alle Streams auf einer Ansicht, die diese Tabelle als zugrunde liegende Tabelle hat. Ein veralteter Stream kann nicht mehr gelesen werden.

• Ähnlich wie bei reservierten Schlüsselwörtern können ANSI-reservierte Funktionsnamen (z. B. CURRENT_DATE, CURRENT_TIMESTAMP) nicht als Spaltennamen verwendet werden.

• CREATE OR ALTER TABLE:

  Weitere Informationen dazu finden Sie unter Nutzungshinweise zu CREATE OR ALTER TABLE.

• CREATE TABLE … CLONE:

  Wenn die Quelltabelle Gruppierungsschlüssel hat, dann hat auch die neue Tabelle Gruppierungsschlüssel. Standardmäßig wird Automatic Clustering für die neue Tabelle angehalten – auch wenn Automatic Clustering für die Quelltabelle nicht angehalten wurde.

• CREATE TABLE … CHANGE_TRACKING = TRUE:

  Wenn die Änderungsverfolgung aktiviert wird, wird die Tabelle für die Dauer der Operation gesperrt. Sperren können bei einigen damit verbundenen DDL/DML-Operationen eine Latenz verursachen. Weitere Informationen dazu finden Sie unter Ressourcensperrung.

• CREATE TABLE … LIKE:

  Wenn die Quelltabelle Gruppierungsschlüssel hat, dann hat auch die neue Tabelle Gruppierungsschlüssel. Standardmäßig wird Automatic Clustering für die neue Tabelle nicht angehalten – auch wenn Automatic Clustering für die Quelltabelle angehalten wurde.

• CREATE TABLE … AS SELECT (CTAS):

  • Wenn die Aliasse für die Spaltennamen in der SELECT-Liste gültige Spalten sind, dann sind die Spaltendefinitionen in der CTAS-Anweisung nicht erforderlich. Wenn sie weggelassen werden, werden die Spaltennamen und -typen aus der zugrunde liegenden Abfrage abgeleitet:

    CREATE TABLE <table_name> AS SELECT ...
    

    Copy

    Alternativ können die Namen auch explizit mit der folgenden Syntax angegeben werden:

    CREATE TABLE <table_name> ( <col1_name> , <col2_name> , ... ) AS SELECT ...
    

    Copy

    Die Anzahl der angegebenen Spaltennamen muss mit der Anzahl der SELECT-Listenelemente in der Abfrage übereinstimmen; die Typen der Spalten werden aus den von der Abfrage erzeugten Typen abgeleitet.

  • Wenn Gruppierungsschlüssel in einer CTAS-Anweisung angegeben werden, gilt Folgendes:

    • Spaltendefinitionen sind erforderlich und müssen in der Anweisung ausdrücklich angegeben werden.

    • Standardmäßig wird Automatic Clustering für die neue Tabelle nicht angehalten – auch wenn Automatic Clustering für die Quelltabelle angehalten wurde.

  • Wenn die Tabelle mit Zeilen in einer bestimmten Reihenfolge erstellt werden soll, dann verwenden Sie in der SELECT-Klausel der CTAS eine ORDER BY-Unterklausel. Durch die Angabe von CLUSTER BY werden die Daten nicht zum Zeitpunkt der Erstellung der Tabelle geclustert. Stattdessen verlässt sich CLUSTER BY auf das Automatic Clustering, um die Daten im Laufe der Zeit neu zu clustern.

    Die ORDER BY-Unterklausel in einer CREATE TABLE-Anweisung hat keinen Einfluss auf die Reihenfolge der Zeilen, die von zukünftigen SELECT-Anweisungen auf dieser Tabelle zurückgegeben werden. Um die Reihenfolge der Zeilen in zukünftigen SELECT-Anweisungen festzulegen, verwenden Sie in diesen Anweisungen eine ORDER BY-Unterklausel.

• Innerhalb einer Transaktion schreibt jede DDL-Anweisung (einschließlich CREATE TEMPORARY/TRANSIENT TABLE) die Transaktion fest, bevor die DDL-Anweisung selbst ausgeführt wird. Die DDL-Anweisung wird dann in einer eigenen Transaktion ausgeführt. Mit der nächsten Anweisung nach der DDL-Anweisung wird eine neue Transaktion gestartet. Daher können Sie keine temporäre oder vorübergehende Tabelle innerhalb einer einzelnen Transaktion erstellen, verwenden und löschen. Wenn Sie eine temporäre oder vorübergehende Tabelle in einer Transaktion verwenden möchten, erstellen Sie die Tabelle vor der Transaktion und löschen Sie die Tabelle nach der Transaktion.

• Wenn Sie eine Tabelle neu erstellen (mit dem optionalen Schlüsselwort OR REPLACE), wird deren Verlauf gelöscht, wodurch alle Streams auf der Tabelle veraltet sind. Ein veralteter Stream kann nicht mehr gelesen werden.

• Eine einzelne Maskierungsrichtlinie, die bedingte Spalten verwendet, kann auf mehrere Tabellen angewendet werden, sofern die Spaltenstruktur der Tabelle mit den in der Richtlinie angegebenen Spalten übereinstimmt.

• Wenn Sie eine Tabelle mit Maskierungsrichtlinie auf einer oder mehreren Tabellenspalten oder die Tabelle selbst mit Zeilenzugriffsrichtlinie ändern, dann können Sie mit der Funktion POLICY_CONTEXT eine Abfrage auf den mit Maskierungsrichtlinie geschützten Spalten bzw. auf der mit einer Zeilenzugriffsrichtlinie geschützten Tabelle simulieren.

• Hinweis zu Metadaten:

  Achtung

  Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „Benutzer“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.

Nutzungshinweise zu CREATE OR ALTER TABLE¶

• Einschränkungen

  • Derzeit werden nur permanente, temporäre und transiente Tabellen unterstützt. Schreibgeschützte, externe, dynamische, Apache Iceberg™-, und Hybridtabellen werden nicht unterstützt.

  • Es gelten alle Einschränkungen des Befehls ALTER TABLE.

  • Unterstützt derzeit nicht die folgenden Syntaxvarianten:

    • CREATE TABLE … AS SELECT (CTAS)

    • CREATE TABLE … USING TEMPLATE

    • CREATE TABLE … LIKE

    • CREATE TABLE … CLONE

• Tabellenparameter und Eigenschaften

  • Das Fehlen eines Eigenschafts- oder Parameterwerts, der zuvor in der geänderten Tabellendefinition festgelegt wurde, führt dazu, dass er als nicht festgelegt ist.

  • Wenn Sie einen expliziten Wert eines Parameters löschen, wird er auf den Standardparameterwert gesetzt. Wenn der Parameter in dem Schema oder der Datenbank festgelegt ist, in dem/der die Tabelle enthalten ist, erbt die Tabelle den in dem Schema oder der Datenbank festgelegten Parameterwert.

• Data Governance

  • Das Setzen oder Aufheben eines Tags oder einer Richtlinie für eine Tabelle oder Spalte mit einer CREATE OR ALTER TABLE-Anweisung wird nicht unterstützt.

    Bestehende Richtlinien oder Tags werden durch eine CREATE OR ALTER-Anweisung nicht verändert und bleiben unverändert.

• Einschränkungen

  Das Setzen oder Entfernen eines Inline-Primärschlüssels ändert die NULL-Zulässigkeit der Spalte entsprechend. Dies entspricht dem Verhalten des Befehls CREATE TABLE, unterscheidet sich aber vom Verhalten des Befehls ALTER TABLE.

• Spalten

  • Neue Spalten können nur am Ende der Spaltenliste hinzugefügt werden.

  • Spalten können nicht umbenannt werden. Wenn Sie versuchen, eine Spalte umzubenennen, wird die Spalte gelöscht und eine neue Spalte hinzugefügt.

  • Der Standardwert für eine Spalte kann nur bearbeitet werden, um eine Sequenz zu verwenden.

  • Die Standardsequenz einer Spalte (z. B. SET DEFAULT seq_name.NEXTVAL) kann nur geändert werden, wenn die Spalte bereits eine Sequenz hat.

  • Weitere Informationen zum Ändern von Spalten finden Sie unter ALTER TABLE … ALTER COLUMN.

• Sortierung

  • Sortierungsspezifikationen (Kollationierung) können nicht geändert werden.

  • Wenn Sie im CREATE OR ALTER TABLE-Befehl den Parameter DEFAULT_DDL_COLLATION setzen, wird für vorhandene Spalten die Standard-Sortierungsspezifikation festgelegt. Dadurch wird sichergestellt, dass der Befehl CREATE OR ALTER TABLE die gleichen Ergebnisse liefert wie der Befehl CREATE TABLE. Daher können Sie den Befehl CREATE OR ALTER TABLE nicht verwenden, um den Parameter DEFAULT_DDL_COLLATION in einer Tabelle mit vorhandenen Textspalten festzulegen. Sie können jedoch Sortierungen für vorhandene Spalten explizit machen, wenn Sie den Parameter DEFAULT_DDL_COLLATION einer Tabelle ändern.

    Erstellen Sie zum Beispiel eine neue Tabelle my_table, und setzen Sie die Standard-Sortierungsspezifikation für die Tabelle auf „fr“:

    CREATE OR ALTER TABLE my_table (
      a INT PRIMARY KEY,
      b VARCHAR(20)
    )
    DEFAULT_DDL_COLLATION = 'fr';
    

    Copy

    Die Sortierungsspezifikation für die Spalte b ist „fr“ und kann nicht geändert werden. Um die Standard-Sortierungsspezifikation für die Tabelle my_table zu ändern, müssen Sie die Sortierung für die Textspalte b in der Anweisung CREATE OR ALTER explizit festlegen:

    CREATE OR ALTER TABLE my_table (
      a INT PRIMARY KEY,
      b VARCHAR(200) COLLATE 'fr'
    )
    DEFAULT_DDL_COLLATION = 'de';
    

    Copy

• Atomarität

  Der Befehl CREATE OR ALTER TABLE garantiert derzeit keine Atomarität. Das bedeutet, dass beim Fehlschlagen einer CREATE OR ALTER TABLE-Anweisung während der Ausführung möglicherweise eine Teilmenge der Änderungen auf die Tabelle angewendet worden ist. Wenn die Möglichkeit von Teiländerungen besteht, enthält die Fehlermeldung in den meisten Fällen den folgenden Text:

  CREATE OR ALTER execution failed. Partial updates may have been applied.
  

  Wenn die Anweisung beispielsweise versucht, die Spalte A zu löschen und eine neue Spalte B zu einer Tabelle hinzuzufügen, und die Anweisung abgebrochen wird, ist es möglich, dass die Spalte A gelöscht, aber die Spalte B nicht hinzugefügt wurde.

  Bemerkung

  Wenn Änderungen teilweise übernommen werden, ist die resultierende Tabelle immer noch in einem gültigen Zustand und Sie können weitere ALTER TABLE-Anweisungen verwenden, um die ursprünglichen Änderungen zu vervollständigen.

  Zur Wiederherstellung von partiellen Updates empfiehlt Snowflake die folgenden Wiederherstellungsmechanismen:

  • Vorwärtskorrektur

    • Führen Sie die CREATE OR ALTER TABLE-Anweisung erneut aus: Wenn die Anweisungen beim zweiten Versuch erfolgreich sind, ist der Zielzustand erreicht.

    • Untersuchen Sie die Fehlermeldung. Beheben Sie, wenn möglich, den Fehler, und führen Sie die CREATE OR ALTER TABLE-Anweisung erneut aus.

  • Zurücksetzen (Rollback)

    Wenn eine Vorwärtskorrektur nicht möglich ist, empfiehlt Snowflake, partielle Änderungen manuell rückgängig zu machen:

    • Untersuchen Sie den Zustand der Tabelle mit den Befehlen DESCRIBE TABLE und SHOW TABLES. Ermitteln Sie, ob und welche Teiländerungen vorgenommen wurden.

    • Wenn partielle Änderungen vorgenommen wurden, führen Sie die entsprechenden ALTER TABLE-Anweisungen aus, um die Tabelle wieder in ihren ursprünglichen Zustand zu transformieren.

      Bemerkung

      In manchen Fällen ist es nicht möglich, partielle Änderungen rückgängig zu machen. Weitere Informationen dazu finden Sie unter den unterstützten und nicht unterstützten Aktionen zum Ändern von Spalteneigenschaften unter dem Thema ALTER TABLE … ALTER COLUMN.

  • Wenn Sie Unterstützung beim Wiederherstellen nach einer partiellen Aktualisierung benötigen, wenden Sie sich an den Snowflake-Support.

Beispiele¶

CREATE OR ALTER TABLE my_table(a INT);

CREATE OR ALTER TABLE my_table(
    a INT PRIMARY KEY,
    b VARCHAR(200)
  )
  DATA_RETENTION_TIME_IN_DAYS = 5
  DEFAULT_DDL_COLLATION = 'de';

CREATE OR ALTER TABLE my_table(
    a INT PRIMARY KEY,
    c VARCHAR(200)
  )
  DEFAULT_DDL_COLLATION = 'de';