Een syntaxisdiagram lezen

Van toepassing op: Databricks Databricks Runtime

In deze sectie worden de verschillende syntaxispatronen beschreven die in de SQL-verwijzing worden gebruikt.

Basisonderdelen

• Trefwoord
• Token
• Component
• Argument

Trefwoord

SELECT

Trefwoorden in SQL worden in dit document altijd met hoofdletters gebruikt, maar zijn niet hoofdlettergevoelig.

Token

( )
<  >
.
*
,

De SQL-taal bevat ronde accolades ((, )) en schuine accolades (<, >), puntjes (.), komma's (,) en enkele andere tekens. Wanneer deze tekens aanwezig zijn in een syntaxisdiagram, moet u ze in de huidige staat invoeren.

Component

LIMIT clause

SELECT named_expression

named_expression
  expression AS alias

Een component vertegenwoordigt een benoemde subsectie van de syntaxis. Een lokale component wordt beschreven in hetzelfde syntaxisdiagram dat deze aanroept. Als de component gebruikelijk is, wordt deze gekoppeld aan een andere sectie van de Databricks SQL-verwijzing. Sommige componenten zijn bekend door hun hoofd keyword en worden weergegeven met een hoofdletter, gevolgd door een component. Andere componenten zijn altijd van kleine letters en gebruiken waar nodig onderstrepingsteken (_). Lokale componenten worden volledig uitgelegd in de volgende sectie. Alle andere componenten hebben een korte beschrijving met een koppeling naar de hoofdpagina.

Argument

mapExpr

Argumenten voor functies worden opgegeven in camelCase. Databricks SQL beschrijft de betekenis van argumenten in de sectie Argumenten.

Keten van tokens

SELECT expr

Onderdelen gescheiden door witruimte moeten onvoorwaardelijk op volgorde worden ingevoerd en alleen worden gescheiden door spaties of opmerkingen. Databricks SQL ondersteunt opmerkingen van het formulier /* ... */ (C-stijl) en -- ..., die zich uitstrekt tot het einde van de regel.

Keuze

Hiermee geeft u een fork in de syntaxis.

Verplichte keuze

{ INT | INTEGER }

Accolades { ... } betekenen dat u precies een van de meerdere onderdelen moet opgeven. Elke keuze wordt gescheiden door een |.

Optionele keuze

[ ASC | DESC ]

Vierkante haken [ ... ] geven aan dat u maximaal één van de onderdelen kunt kiezen. Elke keuze wordt gescheiden door een |.

Groeperen

{ SELECT expr }

{ SELECT
 expr }

Accolades { ... } geven aan dat u alle ingesloten onderdelen moet opgeven. Als een syntaxisdiagram meerdere regels omvat, verduidelijkt dit formulier dat dezelfde syntaxis wordt weergegeven.

Optie

[ NOT NULL ]

Vierkante haken [...] geven aan dat de ingesloten onderdelen optioneel zijn.

Herhaling

col_option [...]

col_alias [, ...]

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

De [...] beletseltekennotatie geeft aan dat u het direct voorafgaande onderdeel, de groepering of de keuze meerdere keren kunt herhalen. Als het beletselteken wordt voorafgegaan door een ander teken, zoals een gescheiden punt [. ...]of een komma [, ...], moet u elke herhaling scheiden door dat teken.