Como ler um diagrama de sintaxe
Aplica-se a:
SQL do Databricks Runtime do Databricks
Esta seção descreve os vários padrões de sintaxe usados em toda a referência do SQL.
Componentes básicos
Palavra-chave
SELECT
As palavras-chave no SQL são sempre maiúsculas neste documento, mas não diferenciam maiúsculas de minúsculas.
Token
( )
< >
.
*
,
A linguagem SQL inclui parênteses ((, )), bem como colchetes angulares (<, >), pontos (.), vírgulas (,) e alguns outros caracteres. Quando esses caracteres estão presentes em um diagrama de sintaxe, você deve inseri-los como são.
Cláusula
LIMIT clause
SELECT named_expression
named_expression
expression AS alias
Uma cláusula representa uma subseção nomeada da sintaxe. Uma cláusula local é descrita no mesmo diagrama de sintaxe que a invoca. Se a cláusula for comum, ela será vinculada a outra seção da referência do SQL do Databricks. Algumas cláusulas são conhecidas por sua keyword principal e são representadas com uma palavra-chave maiúscula seguida pela cláusula. Outras cláusulas são sempre em letra minúscula e usam sublinhado (_) quando apropriado.
As cláusulas locais são totalmente explicadas na seção a seguir.
Todas as outras cláusulas têm uma breve descrição com um link para a página principal.
Argumento
mapExpr
Argumentos para funções são especificados em minúsculas concatenadas, como mapExpr. O SQL do Databricks descreve o significado dos argumentos na seção Argumentos.
Cadeia de tokens
SELECT expr
Os componentes separados por espaço em branco devem ser inseridos na ordem, incondicionalmente, e separados somente por espaço em branco ou comentários. O SQL do Databricks dá suporte a comentários do formulário /* ... */ (estilo C) e -- ..., que se estende até o final da linha.
Opção
Especifica uma bifurcação na sintaxe.
Opção obrigatória
{ INT | INTEGER }
Chaves { ... } significam que você deve especificar exatamente um dos vários componentes.
Cada opção é separada por um |.
Escolha opcional
[ ASC | DESC ]
Colchetes [ ... ] indicam que você pode escolher no máximo um dos vários componentes.
Cada opção é separada por um |.
Agrupamento
{ SELECT expr }
{ SELECT
expr }
Chaves { ... } especificam que você deve fornecer todos os componentes inseridos.
Se um diagrama de sintaxe abrange várias linhas, essa forma esclarece que ele ilustra a mesma sintaxe.
Opção
[ NOT NULL ]
Colchetes [...] especificam que os componentes incluídos são opcionais.
Repetição
col_option [...]
col_alias [, ...]
{ expr [ AS ] col_alias } [, ...]
A notação de reticências [...] indica que você pode repetir o componente, agrupamento ou a escolha imediatamente anterior várias vezes.
Se as reticências são precedidas por outro caractere, como um ponto separado [. ...] ou uma vírgula [, ...], você deve separar cada repetição por esse caractere.