Compartir a través de

Uso de la referencia de SQL

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

En esta guía se explica cómo leer y navegar por la referencia del lenguaje SQL, incluidas las etiquetas de disponibilidad de la plataforma y la notación de sintaxis.

Etiquetas "Se aplica a"

La referencia de SQL cubre Databricks SQL, Databricks Runtime y Unity Catalog. Cada artículo incluye una etiqueta "Se aplica a" cerca de la parte superior que muestra qué productos y versiones admiten esa característica.

Lectura de la etiqueta

Etiqueta Meaning
comprobar sí marcado Comprobación de SQL de Databricks marcada como sí Databricks Runtime Todas las versiones de Databricks SQL y Databricks Runtime
comprobar sí marcado Databricks SQL Solo Databricks SQL (no se admite en Databricks Runtime)
comprobar sí marcado Comprobación de SQL de Databricks marcada como sí Databricks Runtime 11.3 LTS y versiones posteriores Todas las versiones de Databricks SQL y Databricks Runtime 11.3 LTS y versiones posteriores
comprobar sí marcado Comprobación de SQL de Databricks marcada como sí Databricks Runtime 11.3 LTS y versiones posteriores marcadas como sí en el catálogo de Unity Solo catálogo de Unity, todas las versiones de Databricks SQL y Databricks Runtime 11.3 LTS y versiones posteriores

Etiquetas de nivel de parámetro

Algunos artículos tienen una etiqueta "Se aplica a" en la parte superior y etiquetas adicionales para parámetros específicos dentro del artículo. La etiqueta de nivel de parámetro invalida la etiqueta de nivel de artículo solo para ese parámetro.

Ejemplo 1: El parámetro requiere una versión mínima de Databricks Runtime

Etiqueta de artículo: compruebe si Databricks SQL check marcado yes Databricks Runtime

Etiqueta de parámetro: compruebe que sí Databricks SQL check marcado yes Databricks Runtime 11.3 LTS y versiones posteriores

Esto significa que la mayoría del artículo se aplica a todas las versiones de Databricks SQL y Databricks Runtime, pero ese parámetro específico requiere Databricks Runtime 11.3 LTS o posterior.

Ejemplo 2: El parámetro no está disponible para cargas de trabajo de SQL Warehouse

Etiqueta de artículo: compruebe si Databricks SQL check marcado yes Databricks Runtime

Etiqueta de parámetro: compruebe si Databricks Runtime 11.3 LTS y versiones posteriores

Esto significa que la mayoría de la página se aplica a todas las versiones de ambos productos, pero ese parámetro específico solo se admite en Databricks Runtime 11.3 LTS y versiones posteriores (no se admite en Databricks SQL).

Diagramas de sintaxis

Las instrucciones SQL se documentan mediante diagramas de sintaxis que muestran cómo construir comandos válidos.

Elementos básicos

Los diagramas de sintaxis usan estos componentes fundamentales para representar instrucciones SQL. Cada componente va seguido de un ejemplo.

Palabra clave

Las palabras clave aparecen en mayúsculas, pero no distinguen mayúsculas de minúsculas.

SELECT

Token

Caracteres literales que debe escribir exactamente como se muestra: (, ), ><, , ., , *,

Cláusula

Las cláusulas se denominan secciones de sintaxis. Las cláusulas mayúsculas (como LIMIT clause) vinculan a su documentación. Las cláusulas minúsculas con caracteres de subrayado (como named_expression) se definen localmente.

LIMIT clause
named_expression

Argument

Los argumentos de función usan camelCase y se describen en la sección Argumentos de la referencia de la función SQL de Databricks.

mapExpr

Notación de sintaxis

Los símbolos especiales indican cómo se pueden combinar, repetir o omitir componentes.

Secuencia necesaria

Los componentes separados por espacios en blanco deben aparecer en orden.

SELECT expr

Opción obligatoria

Las llaves { } con | separadores significan que debe elegir exactamente una opción.

{ INT | INTEGER }

Opción opcional

Los corchetes [ ] con | separadores significan que puede elegir como máximo una opción.

[ ASC | DESC ]

Grouping

Llaves { } sin | significa que debe incluir todos los componentes.

{ SELECT expr }

Elemento opcional

Los corchetes [ ] significan que el componente incluido es opcional.

[ NOT NULL ]

Repetición

Los puntos suspensivos [...] significan que puede repetir el componente anterior. Si va precedido por un separador (, ...), debe usar ese separador entre repeticiones.

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

Comentarios

Databricks SQL admite comentarios de estilo C (/* ... */) y comentarios de línea (-- ...).

  • Last updated on