Partilhar via


Como ler um diagrama de sintaxe

Aplica-se a: Marque Sim Databricks SQL Marque Sim 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.