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
• Token
• Clause
• Argument

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.