Verwenden der SQL-Referenz

Gilt für: Databricks SQL Databricks Runtime

In diesem Handbuch wird erläutert, wie Sie die SQL-Sprachreferenz lesen und navigieren, einschließlich Plattformverfügbarkeitsbezeichnungen und Syntaxnotation.

Bezeichnungen "Gilt für"

Die SQL-Referenz behandelt Databricks SQL, Databricks Runtime und Unity Catalog. Jeder Artikel enthält eine Bezeichnung "Gilt für" am oberen Rand, die zeigt, welche Produkte und Versionen dieses Features unterstützen.

Lesen der Beschriftung

Etikett	Bedeutung
Databricks Databricks Runtime" markiert	Alle Versionen von Databricks SQL und Databricks Runtime
Databricks SQL	Nur Databricks SQL (in Databricks Runtime nicht unterstützt)
Databricks SQL Databricks Runtime 11.3 LTS and above	Alle Versionen von Databricks SQL und Databricks Runtime 11.3 LTS und höher
Databricks SQL Databricks Runtime 11.3 LTS and above Unity Catalog only	Unity Catalog only, all versions of Databricks SQL, and Databricks Runtime 11.3 LTS and later

Beschriftungen auf Parameterebene

Einige Artikel haben oben eine Bezeichnung "Gilt für" und zusätzliche Bezeichnungen für bestimmte Parameter innerhalb des Artikels. Die Bezeichnung auf Parameterebene setzt die Bezeichnung auf Artikelebene nur für diesen Parameter außer Kraft.

Beispiel 1: Parameter erfordert eine minimale Databricks-Runtime-Version

Artikelbezeichnung: Databricks SQL Databricks Runtime" markiert

Parameterbezeichnung: Databricks SQL Databricks Runtime 11.3 LTS" und höher markiert

Dies bedeutet, dass der Großteil des Artikels für alle Versionen von Databricks SQL und Databricks Runtime gilt, aber dieser spezifische Parameter erfordert Databricks Runtime 11.3 LTS oder höher.

Beispiel 2: Parameter ist für SQL Warehouse-Workloads nicht verfügbar

Artikelbezeichnung: Databricks SQL Databricks Runtime" markiert

Parameterbezeichnung: Databricks Runtime 11.3 LTS und höher" markiert

Dies bedeutet, dass die meisten Seiten für alle Versionen beider Produkte gelten, aber dieser spezifische Parameter wird nur in Databricks Runtime 11.3 LTS und höher unterstützt (in Databricks SQL nicht unterstützt).

---

Syntaxdiagramme

SQL-Anweisungen werden mithilfe von Syntaxdiagrammen dokumentiert, die zeigen, wie gültige Befehle erstellt werden.

Grundlegende Elemente

Syntaxdiagramme verwenden diese grundlegenden Komponenten, um SQL-Anweisungen darzustellen. Auf jede Komponente folgt ein Beispiel.

Keyword

Schlüsselwörter werden in Großbuchstaben angezeigt, die Groß-/Kleinschreibung wird jedoch nicht beachtet.

SELECT

Token

Literale Zeichen, die Sie genau wie dargestellt eingeben müssen: , , ), , ><, , .*(,

Klausel

Klauseln sind benannte Syntaxabschnitte. Großgeschriebene Klauseln (z LIMIT clause. B. ) verknüpfen mit ihrer Dokumentation. Kleingeschriebene Klauseln mit Unterstrichen (z named_expression. B. ) werden lokal definiert.

LIMIT clause
named_expression

Argument

Funktionsargumente verwenden camelCase und werden im Abschnitt "Argumente" der SQL-Funktionsreferenz von Databricks beschrieben.

mapExpr

Syntaxnotation

Sondersymbole geben an, wie Komponenten kombiniert, wiederholt oder weggelassen werden können.

Erforderliche Sequenz

Durch Leerzeichen getrennte Komponenten müssen in der angegebenen Reihenfolge angezeigt werden.

SELECT expr

Obligatorische Auswahl

Geschweifte Klammern { } mit | Trennzeichen bedeuten, dass Sie genau eine Option auswählen müssen.

{ INT | INTEGER }

Optionale Auswahl

Eckige Klammern [ ] mit | Trennzeichen bedeuten, dass Sie höchstens eine Option auswählen können.

[ ASC | DESC ]

Grouping

Geschweifte geschweifte Klammern { } ohne | Mittel müssen Sie alle Komponenten einschließen.

{ SELECT expr }

Optionales Element

Eckige Klammern [ ] bedeuten, dass die eingeschlossene Komponente optional ist.

[ NOT NULL ]

Wiederholung

Ellipse [...] bedeutet, dass Sie die vorherige Komponente wiederholen können. Wenn ein Trennzeichen (, ...) vorangestellt ist, müssen Sie dieses Trennzeichen zwischen Wiederholungen verwenden.

col_option [...]
col_alias [, ...]
{ expr [ AS ] col_alias } [, ...]

---

Kommentare

Databricks SQL unterstützt C-Formatkommentare (/* ... */) und Zeilenkommentare (-- ...).