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
• Token
• Cláusula
• Argumento

Palavra-chave

SELECT

As palavras-chave em SQL são sempre maiúsculas neste documento, mas não são sensíveis à capitalização.

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 símbolos

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 deve-se especificar exatamente um elemento dentre os vários componentes. Cada escolha é separada por um |.

Escolha opcional

[ ASC | DESC ]

Os colchetes [ ... ] indicam que você pode escolher no máximo um dos vários componentes. Cada escolha é separada por um |.

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 pode-se repetir o componente, agrupamento ou escolha imediatamente anteriores 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.