Lesen eines Syntaxdiagramms

  • Artikel

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert 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.