Notationskonventionen

Folgende Notationskonventionen werden in der Snowflake-Dokumentation verwendet.

Wichtig

In Syntax- und Codebeschreibungen werden spitze Klammern (<>), eckige Klammern ([ ]), geschweifte Klammern ({ }) und senkrechte Striche (|) nur zu Notationszwecken verwendet. Fügen Sie diese nicht ein, wenn Sie einen Befehl eingeben oder Code schreiben, um Syntaxfehler zu verhindern.

Klammern haben jedoch bestimmte Bedeutungen in JSON und XML und müssen daher beim Arbeiten mit JSON- oder XML-Dokumenten bzw. -Daten einbezogen werden.

Syntax, Beispiele und Text

Notation

Beschreibung

ITEM , ITEM

Durchgängige Großbuchstaben kennzeichnen einen Snowflake SQL-Befehl, ein Schlüsselwort, einen Parameternamen oder einen Funktionsnamen.

item , item

Durchgängige Kleinbuchstaben kennzeichnen einen vom Benutzer angegebenen Wert für einen Bezeichner, einen Parameter oder ein Argument.

<Element>, Element

Eckige Klammern und Kursivschrift kennzeichnen Bezeichner, Parameter oder Argumente, die von Benutzern bereitgestellt werden.

( item1 item2 ... )

Runde Klammern dienen in SQL zum Gruppieren von Parametern oder Argumenten.

Sie sind zwingend erforderlich, wenn Sie einen Befehl eingeben (d. h. sie müssen genau so eingegeben werden, wie sie erscheinen).

{ item1 item2 ... }

Geschweifte Klammern kennzeichnen Gruppierungen von Bezeichnern, Parametern oder Argumenten. Sie müssen nicht eingegeben werden.

[ ITEM ] , [ item1 item2 ... ]

Eckige Klammern kennzeichnen optionale Teile einer Anweisung. Sie müssen nicht eingegeben werden.

In vielen Fällen sind Elemente in den eckigen Klammern optional, da Standardwerte angegeben werden.

|

Ein vertikaler Strich zeigt an, dass Sie zwischen zwei oder mehr Elementen bzw. Werten wählen können, normalerweise in eckigen oder geschweiften Klammern. Sie müssen nicht eingegeben werden.

JSON-Daten

Notation

Beschreibung

[ item1 ... ]

Eckige Klammern sind Trennzeichen für JSON-Arrays.

{ item1 item2 ... }

Geschweifte Klammern sind Trennzeichen für JSON-Objekte.

XML-Daten

Notation

Beschreibung

<Element> ... </Element>

Spitze Klammern kennzeichnen den Anfang oder das Ende eines XML-Elements.