Como ler um diagrama de sintaxe
Aplica-se a: Databricks SQL Databricks Runtime
Esta seção descreve os vários padrões de sintaxe usados em toda a referência SQL.
Componentes de base
Palavra-chave
SELECT
As palavras-chave em SQL são sempre maiúsculas neste documento, mas não diferenciam maiúsculas de minúsculas.
Token
( )
< >
.
*
,
A linguagem SQL inclui chaves redondas ((
, )
), bem como chaves angulares (<
, >
), pontos (.
), vírgulas (,
) e alguns outros caracteres. Quando esses caracteres estão presentes em um diagrama de sintaxe, você deve inseri-los como estã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 SQL do Databricks. Algumas cláusulas são conhecidas pelo seu principal keyword
e são representadas com uma palavra-chave maiúscula seguida de cláusula. Outras cláusulas são sempre minúsculas e usam sublinhado (_
) quando apropriado.
As cláusulas locais são explicadas na íntegra 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
Os argumentos para funções são especificados em camelCase. Databricks SQL 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 em ordem, incondicionalmente, e ser separados apenas por espaço em branco ou comentários. O Databricks SQL suporta comentários do formulário /* ... */
(estilo C) e -- ...
, que se estende até o final da linha.
Escolha
Especifica uma bifurcação na sintaxe.
Escolha obrigatória
{ INT | INTEGER }
As chaves { ... }
significam que você deve especificar exatamente um dos vários componentes.
Cada escolha é separada por um |
arquivo .
Escolha opcional
[ ASC | DESC ]
Os colchetes [ ... ]
indicam que você pode escolher no máximo um dos vários componentes.
Cada escolha é separada por um |
arquivo .
Agrupamento
{ SELECT expr }
{ SELECT
expr }
As chaves { ... }
especificam que você deve fornecer todos os componentes incorporados.
Se um diagrama de sintaxe abrange várias linhas, este formulário esclarece que ele representa a mesma sintaxe.
Opção
[ NOT NULL ]
Os 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 imediatamente anterior, agrupamento ou escolha várias vezes.
Se as reticências forem precedidas por outro caractere, como um ponto [. ...]
separado ou uma [, ...]
vírgula, você deve separar cada repetição por esse caractere.