Lesen eines Syntaxdiagramms
Gilt für: Databricks SQL Databricks Runtime
In diesem Abschnitt werden die verschiedenen Syntaxmuster beschrieben, die in der SQL-Referenz verwendet werden.
Basiskomponenten
Schlüsselwort
SELECT
Schlüsselwörter in SQL werden in diesem Dokument immer großgeschrieben, die Groß-/Kleinschreibung spielt aber keine Rolle.
Tokenverschlüsselung
( )
< >
.
*
,
Die SQL-Sprache umfasst runde Klammern ((
, )
) sowie spitze Klammern (<
, >
), Punkte (.
), Kommas (,
) und einige andere Zeichen. Wenn diese Zeichen in einem Syntaxdiagramm vorhanden sind, müssen Sie sie wie angegeben eingeben.
Klausel
LIMIT clause
SELECT named_expression
named_expression
expression AS alias
Eine Klausel stellt einen benannten Unterabschnitt der Syntax dar. Eine lokale Klausel wird im gleichen Syntaxdiagramm beschrieben, in dem sie aufgerufen wird. Wenn die Klausel gebräuchlich ist, wird sie mit anderen Abschnitten der Databricks SQL-Referenz verknüpft. Einige Klauseln sind durch ihr Hauptschlüsselwort keyword
bekannt und werden mit einem Schlüsselwort in Großbuchstaben gefolgt von der Klausel dargestellt. Andere Klauseln werden immer in Kleinbuchstaben angegeben und verwenden ggf. Unterstriche (_
).
Lokale Klauseln werden im folgenden Abschnitt ausführlich erläutert.
Alle anderen Klauseln verfügen über eine kurze Beschreibung mit einem Link zur Hauptseite.
Argument
mapExpr
Argumente für Funktionen werden in Höckerschreibweise (camelCase) angegeben. Databricks SQL beschreibt die Bedeutung von Argumenten im Abschnitt „Argumente“.
Tokenkette
SELECT expr
Komponenten, die durch Leerzeichen getrennt sind, müssen in der angegebenen Reihenfolge so wie dargestellt eingegeben werden und dürfen nur durch Leerzeichen oder Kommentare getrennt werden. Databricks SQL unterstützt Kommentare im Format /* ... */
(C-Format) und -- ...
, das bis zum Ende der Zeile reicht.
Auswahl
Gibt eine Verzweigung in der Syntax an.
Obligatorische Auswahl
{ INT | INTEGER }
Geschweifte Klammern, { ... }
, bedeuten, dass Sie genau eine von mehreren Komponenten angeben müssen.
Die einzelnen Auswahlmöglichkeiten werden durch |
getrennt.
Optionale Auswahl
[ ASC | DESC ]
Eckige Klammern, [ ... ]
, geben an, dass Sie höchstens eine von mehreren Komponenten auswählen können.
Die einzelnen Auswahlmöglichkeiten werden durch |
getrennt.
Gruppierung
{ SELECT expr }
{ SELECT
expr }
Geschweifte Klammern, { ... }
, geben an, dass Sie alle eingebetteten Komponenten angeben müssen.
Wenn sich ein Syntaxdiagramm über mehrere Zeilen erstreckt, verdeutlicht diese Form, dass die gleiche Syntax dargestellt wird.
Option
[ NOT NULL ]
Eckige Klammern [...]
geben an, dass die eingeschlossenen Komponenten optional sind.
Wiederholung
col_option [...]
col_alias [, ...]
{ expr [ AS ] col_alias } [, ...]
Auslassungspunkte, [...]
, geben an, dass Sie die unmittelbar davor stehende Komponente, Gruppierung oder Auswahlmöglichkeit mehrmals wiederholen können.
Wenn vor den Auslassungspunkten ein anderes Zeichen steht, z. B. ein allein stehender Punkt ([. ...]
) oder ein Komma ([, ...]
), müssen Sie jede Wiederholung durch das betreffende Zeichen trennen.