Läsa ett syntaxdiagram

  • Artikel

Gäller för:check markerad ja Databricks SQL-kontroll markerad ja Databricks Runtime

Det här avsnittet beskriver de olika syntaxmönstren som används i SQL-referensen.

Baskomponenter

Sökord

SELECT

Nyckelord i SQL är alltid versaler i det här dokumentet, men de är skiftlägesokänsliga.

Token

( )
<  >
.
*
,

SQL-språket innehåller runda klammerparenteser ((, )) samt vinklade klammerparenteser (<, >), punkter (.), kommatecken (,) och några andra tecken. När dessa tecken finns i ett syntaxdiagram måste du ange dem som de är.

Klausul

LIMIT clause

SELECT named_expression

named_expression
  expression AS alias

En sats representerar ett namngivet underavsnitt av syntax. En lokal sats beskrivs i samma syntaxdiagram som anropar den. Om satsen är vanlig länkar den till ett annat avsnitt i Databricks SQL-referensen. Vissa satser är kända av deras huvud keyword - och avbildas med ett nyckelord följt av sats. Andra satser är alltid gemener och använder understreck (_) där det är lämpligt. Lokala satser förklaras fullständigt i följande avsnitt. Alla andra satser har en kort beskrivning med en länk till huvudsidan.

Argument

mapExpr

Argument till funktioner anges i camelCase. Databricks SQL beskriver innebörden av argument i avsnittet Argument.

Kedja av token

SELECT expr

Komponenter avgränsade med blanksteg måste anges i ordning, villkorslöst och avgränsas endast med blanksteg eller kommentarer. Databricks SQL stöder kommentarer i formuläret /* ... */ (C-format) och -- ..., som sträcker sig till slutet av raden.

Val

Anger en förgrening i syntaxen.

Obligatoriskt val

{ INT | INTEGER }

Klammerparenteser { ... } innebär att du måste ange exakt en av de flera komponenterna. Varje val avgränsas med en |.

Valfritt val

[ ASC | DESC ]

Hakparenteser [ ... ] anger att du kan välja högst en av flera komponenter. Varje val avgränsas med en |.

Gruppering

{ SELECT expr }

{ SELECT
 expr }

Klammerparenteser { ... } anger att du måste ange alla inbäddade komponenter. Om ett syntaxdiagram sträcker sig över flera rader förtydligar det här formuläret att det visar samma syntax.

Alternativet

[ NOT NULL ]

Hakparenteser [...] anger att de omslutna komponenterna är valfria.

Upprepning

col_option [...]

col_alias [, ...]

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

[...] Ellipsnotationen anger att du kan upprepa omedelbart föregående komponent, gruppering eller val flera gånger. Om ellipsen föregås av ett annat tecken, till exempel en avgränsad punkt [. ...]eller ett kommatecken [, ...], måste du avgränsa varje upprepning med det tecknet.