Cómo leer un diagrama de sintaxis

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

En esta sección se describen los distintos patrones de sintaxis que se usan en la referencia de SQL.

Componentes básicos

Palabra clave

SELECT

Las palabras clave de SQL siempre se escribe en mayúsculas en este documento, pero no distinguen entre mayúsculas de minúsculas.

Token

( )
<  >
.
*
,

El SQL incluye corchetes redondeados ((, )), así como corchetes angulares (<, >), puntos (.), comas (,) y algunos otros caracteres. Cuando estos caracteres están en un diagrama de sintaxis, debe escribirlos tal y como están.

Cláusula

LIMIT clause

SELECT named_expression

named_expression
  expression AS alias

Una cláusula representa una subsección de sintaxis con nombre. Una cláusula local se describe en el mismo diagrama de sintaxis que la invoca. Si la cláusula es común, vincula a otra sección de la referencia de SQL Databricks. Algunas cláusulas se conocen por su principal keyword y se representan con una palabra clave capital seguida de la cláusula. Otras cláusulas siempre aparecen escritas en minúsculas y usan el carácter de subrayado (_) cuando corresponda. Las cláusulas locales se explican por completo en la sección siguiente. Todas las demás cláusulas tienen una breve descripción con un vínculo a la página principal.

Argumento

mapExpr

Los argumentos de las funciones se especifican en camelCase. Databricks SQL describe el significado de los argumentos en la sección Argumentos.

Cadena de tokens

SELECT expr

Los componentes separados por espacios en blanco deben especificarse en orden, sin condiciones, y estar separados solo por espacios en blanco o comentarios. Databricks SQL admite comentarios del formulario /* ... */ (estilo C) y -- ..., que se extiende hasta el final de la línea.

Opción

Especifica una bifurcación en la sintaxis.

Opción obligatoria

{ INT | INTEGER }

Los corchetes curvados { ... } significan que debe especificar exactamente uno de los varios componentes. Cada opción está separada por un |.

Opción opcional

[ ASC | DESC ]

Los corchetes cuadrados [ ... ] indican que puede elegir como máximo uno de varios componentes. Cada opción está separada por un |.

Agrupación

{ SELECT expr }

{ SELECT
 expr }

Los corchetes curvados { ... } especifican que debe proporcionar todos los componentes insertados. Si un diagrama de sintaxis abarca varias líneas, este formulario aclara que representa la misma sintaxis.

Opción

[ NOT NULL ]

Los corchetes cuadrados [...] especifican que los componentes incluidos son opcionales.

Repetición

col_option [...]

col_alias [, ...]

{ expr [ AS ] col_alias } [, ...]

La notación de puntos suspensivos [...] indica que puede repetir el componente, la agrupación o la elección inmediatamente anteriores varias veces. Si los puntos suspensivos van precedidos de otro carácter, como un punto separado [. ...]o una coma [, ...], debe separar cada repetición por ese carácter.