Come leggere un diagramma della sintassi
Si applica a: Databricks SQL Databricks Runtime
Questa sezione descrive i vari modelli di sintassi usati in tutto il riferimento SQL.
Componenti di base
Parola chiave
SELECT
Le parole chiave in SQL sono sempre maiuscole in questo documento, ma non fanno distinzione tra maiuscole e minuscole.
Token
( )
< >
.
*
,
Il linguaggio SQL include parentesi graffe arrotondate ((
, )
) e parentesi graffe angolate (<
, >
), punti (.
), virgole (,
) e altri caratteri. Quando questi caratteri sono presenti in un diagramma della sintassi, è necessario immetterli così come sono.
Clausola
LIMIT clause
SELECT named_expression
named_expression
expression AS alias
Una clausola rappresenta una sottosezione denominata della sintassi. Una clausola locale è descritta nello stesso diagramma della sintassi che lo richiama. Se la clausola è comune, viene collegata a un'altra sezione del riferimento SQL di Databricks. Alcune clausole sono note dal relativo main keyword
e sono rappresentate con una parola chiave maiuscola seguita dalla clausola . Le altre clausole sono sempre in minuscolo e utilizzano il carattere di sottolineatura (_
) where in modo appropriato.
Le clausole locali sono descritte in modo completo nella sezione seguente.
Tutte le altre clausole hanno una breve descrizione con un collegamento alla pagina principale.
Argomento
mapExpr
Gli argomenti delle funzioni vengono specificati in camelCase. Databricks SQL descrive il significato degli argomenti nella sezione Argomenti.
Catena di token
SELECT expr
I componenti separati da spazi vuoti devono essere immessi in ordine, incondizionato e separati solo da spazi vuoti o commenti. Databricks SQL supporta i commenti del modulo /* ... */
(stile C) e -- ...
, che si estende fino alla fine della riga.
Scelta
Specifica un fork nella sintassi.
Scelta obbligatoria
{ INT | INTEGER }
Le { ... }
parentesi graffe indicano che è necessario specificare esattamente uno dei componenti multipli.
Ogni scelta è separata da un oggetto |
.
Scelta facoltativa
[ ASC | DESC ]
Le parentesi quadre [ ... ]
indicano che è possibile scegliere al massimo uno di più componenti.
Ogni scelta è separata da un oggetto |
.
Raggruppamento
{ SELECT expr }
{ SELECT
expr }
Le { ... }
parentesi graffe specificano che è necessario fornire tutti i componenti incorporati.
Se un diagramma di sintassi si estende su più righe, questo modulo chiarisce che illustra la stessa sintassi.
Opzione
[ NOT NULL ]
Le parentesi quadre specificano che i componenti racchiusi [...]
sono facoltativi.
Repetition
col_option [...]
col_alias [, ...]
{ expr [ AS ] col_alias } [, ...]
La [...]
notazione con i puntini di sospensione indica che è possibile ripetere più volte il componente, il raggruppamento o la scelta immediatamente precedente.
Se i puntini di sospensione sono preceduti da un altro carattere, ad esempio un punto [. ...]
separato o una virgola [, ...]
, è necessario separare ogni ripetizione in base a tale carattere.