Come leggere un diagramma della sintassi

Si applica a:check contrassegnato con sì controllo SQL di Databricks contrassegnato con sì Databricks Runtime

In questa sezione vengono descritti i vari modelli di sintassi usati in tutto il riferimento SQL.

Componenti di base

Parola chiave

SELECT

Le parole chiave in SQL vengono sempre maiuscole in questo documento, ma senza 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 minuscole e usano il carattere di sottolineatura (_) dove 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.

Discussione

mapExpr

Gli argomenti delle funzioni vengono specificati in camelCase. Databricks SQL descrive il significato degli argomenti nella sezione Arguments.

Catena di token

SELECT expr

I componenti separati da spazi vuoti devono essere immessi in ordine, in modo 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 dei componenti multipli. 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.

Ripetizione

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.