Referencia al lenguaje SQL

Este es un artículo de referencia sobre los comandos SQL para Databricks SQL y Databricks Runtime.

Para obtener información sobre cómo comprender y usar la notación de sintaxis y los símbolos de esta referencia, vea Uso de la referencia de SQL.

Para obtener información sobre el uso de SQL con canalizaciones declarativas de Spark de Lakeflow, consulte Referencia del lenguaje SQL de canalización.

Note

Databricks SQL Sin servidor no está disponible en Azure China. Databricks SQL no está disponible en las regiones de Azure Government.

Referencia general

Esta referencia general describe tipos de datos, funciones, identificadores, literales y semántica.

Aspectos básicos del lenguaje

Referencia	Description
Adición de comentarios a instrucciones SQL	Adición de comentarios al código SQL
Palabras y esquemas reservados	Palabras clave reservadas por el analizador de SQL
Identifiers	Reglas para asignar nombres a objetos de base de datos
Names	Convenciones de nomenclatura de objetos
Cláusula IDENTIFIER	Resolución de identificadores dinámicos
Expresión SQL	Sintaxis y evaluación de expresiones SQL
Semántica NULL	Cómo se controlan los valores NULL
Marcadores de parámetros	Marcadores de posición de consulta con parámetros
Variables	Variables temporales y de sesión
Resolución de nombres	Cómo se resuelven los nombres de objeto
Expresión de ruta de acceso JSON	Navegación por estructuras de datos JSON
Collation	Reglas de ordenación y comparación de cadenas
Partitions	Conceptos de creación de particiones de tablas

Tipos de datos

Referencia	Description
Tipos de datos	Información general de todos los tipos de datos admitidos
Reglas de tipo de datos de SQL	Reglas de conversión y coerción de tipos
Patrones de fecha y hora	Patrones de formato para fechas y horas

Parámetros de configuración

Referencia	Description
Parámetros de configuración	Información general sobre la configuración de SQL
ANSI_MODE	Modo de cumplimiento de ANSI SQL
LEGACY_TIME_PARSER_POLICY	Comportamiento de análisis de tiempo
MAX_FILE_PARTITION_BYTES	Límite de tamaño de partición de archivo
READ_ONLY_EXTERNAL_METASTORE	Modo de acceso de metastore externo
STATEMENT_TIMEOUT	Configuración de tiempo de espera de consulta
TIMEZONE	Zona horaria de sesión
USE_CACHED_RESULT	Almacenamiento en caché de resultados de la consulta

Funciones

Referencia	Description
Functions	Introducción a las funciones SQL
Funciones integradas	Todas las funciones integradas
Lista alfabética de funciones integradas	Referencia completa de la función A-Z
Funciones de ventana	Funciones analíticas y de clasificación
Funciones lambda	Expresiones de función anónimas
Funciones geoespaciales H3	Índice espacial jerárquico hexagonal
Funciones geoespaciales ST	Funciones geoespaciales estándar
Funciones de agregado definidas por el usuario (UDAF)	Funciones de agregación personalizadas
Funciones escalares externas definidas por el usuario (UDF)	Funciones escalares personalizadas
Integración con las UDF, UDAF y UDTF de Hive	Compatibilidad de funciones de Hive
function_invocation	Cómo llamar a funciones

Conceptos del catálogo de Unity

Referencia	Description
Entidad de seguridad	Usuarios, grupos y entidades de servicio
Privilegios y objetos protegibles en Unity Catalog (Databricks SQL)	Control de acceso en el catálogo de Unity
Privilegios y objetos protegibles en el metastore de Hive (Databricks SQL)	Control de acceso de metastore heredado
Ubicaciones externas	Ubicaciones de almacenamiento en la nube
tablas externas de	Tablas respaldadas por datos externos
Credentials	Credenciales de acceso de almacenamiento
Volumes	Almacenamiento de archivos administrado y externo

Temas especiales

Referencia	Description
Cumplimiento de ANSI en Databricks Runtime	Compatibilidad estándar de ANSI SQL
Compatibilidad con Apache Hive	Compatibilidad de SQL de Hive
Scripting de SQL	Lógica de SQL de procedimientos
Uso compartido delta	Uso compartido de datos entre organizaciones
Consultas federadas (Federación de Lakehouse)	Consulta de bases de datos externas
Esquema de información	Tablas del sistema de metadatos

Instrucciones DDL

Las instrucciones de definición de datos crean o modifican la estructura de los objetos de base de datos.

Instrucciones ALTER

Statement	Description
ALTER CATALOG	Modificación de las propiedades del catálogo
ALTER CONNECTION	Modificación de la configuración de conexión
ALTER CREDENTIAL	Modificación de las propiedades de credenciales
ALTER DATABASE	Modificación de las propiedades de la base de datos
ALTER EXTERNAL LOCATION	Modificación de la ubicación externa
ALTER MATERIALIZED VIEW	Modificación de la vista materializada
ALTER PROVIDER	Modificación del proveedor de datos
ALTER RECIPIENT	Modificación del destinatario del recurso compartido
ALTER SCHEMA	Modificación de las propiedades del esquema
ALTER SHARE	Modificación de la configuración del recurso compartido
ALTER STREAMING TABLE	Modificación de la tabla de streaming
ALTER TABLE	Modificar estructura de tabla
ALTER VIEW	Modificación de la definición de vista
ALTER VOLUME	Modificación de las propiedades del volumen

Instrucciones CREATE

Statement	Description
CREATE BLOOM FILTER INDEX	Creación de un índice de filtro bloom
CREATE CATALOG	Creación de un catálogo
CREATE CONNECTION	Creación de una conexión externa
CREATE DATABASE	Creación de una base de datos
CREATE FUNCTION (SQL y Python)	Creación de una función SQL
CREATE FUNCTION (externo)	Creación de una función externa
CREATE EXTERNAL LOCATION	Creación de una ubicación externa
CREATE MATERIALIZED VIEW	Creación de una vista materializada
CREAR PROCEDIMIENTO	Creación de un procedimiento almacenado
CREATE RECIPIENT	Crear destinatario de recurso compartido
CREATE SCHEMA	Creación de un nuevo esquema
CREATE SERVER	Creación de un servidor externo
CREATE SHARE	Creación de un recurso compartido de datos
CREATE STREAMING TABLE	Creación de una tabla de streaming
CREATE TABLE	Creación de una nueva tabla
CREATE VIEW	Crea una vista
CREATE VOLUME	Crear un volumen

Análisis de instrucciones

Otras instrucciones DDL

Statement	Description
COMMENT ON	Agregar comentarios a objetos
DECLARE VARIABLE	Declarar variable de sesión
REPAIR TABLE	Recuperación de particiones de tabla
REFRESH FOREIGN (CATALOG, SCHEMA, y TABLE)	Actualizar metadatos externos
REFRESH (MATERIALIZED VIEW o STREAMING TABLE)	Actualizar datos materializados
SET ETIQUETA	Adición de etiquetas a objetos
`SYNC`	Sincronizar metadatos
TRUNCATE TABLE	Eliminación de todos los datos de tabla
UNDROP	Restaurar tabla quitada
ETIQUETA UNSET	Quitar etiquetas de objetos

Instrucciones DML

Las instrucciones de manipulación de datos agregan, cambian o eliminan datos en tablas de Delta Lake.

Statement	Description
`COPY INTO`	Carga de datos de archivos en una tabla
DELETE FROM	Eliminación de filas de una tabla
INSERT	Insertar filas en una tabla
INSERT OVERWRITE DIRECTORY	Escribir los resultados de la consulta en el directorio
INSERT OVERWRITE DIRECTORY con formato Hive	Escritura de resultados en formato de Hive
LOAD DATA	Carga de datos desde archivos
MERGE INTO	Upsert data into a table (Upsert data into a table)
UPDATE	Actualización de filas en una tabla

Instrucciones de recuperación de datos

Recupere filas de tablas según las cláusulas especificadas. Azure Databricks admite la sintaxis estándar SELECT y la sintaxis de canalización de SQL.

Instrucciones de consulta

Statement	Description
Query	Referencia de sintaxis de consulta completa
SELECT (subselección)	Selección de datos de tablas
Cláusula VALUES	Construcción de una tabla insertada
Sintaxis de canalizaciones de SQL	Composición de consultas basada en canalizaciones
EXPLAIN	Mostrar plan de ejecución de consultas

Cláusulas de consulta

Cláusula	Description
Cláusula SELECT	Selección de columnas
* (star) cláusula	Selección de todas las columnas
Referencia de tabla	Orígenes de tabla y subconsulta
JOIN	Combinar filas de tablas
Cláusula WHERE	Filtrar filas
Cláusula GROUP BY	Agrupar filas para la agregación
Cláusula HAVING	Filtrar filas agrupadas
Cláusula QUALIFY	Filtrar los resultados de la función de ventana
Cláusula ORDER BY	Ordenar filas de resultados
Cláusula SORT BY	Ordenar dentro de particiones
Cláusula CLUSTER BY (SELECT)	Distribuir y ordenar datos
Cláusula DISTRIBUTE BY	Distribución de datos entre particiones
Cláusula LIMIT	Limitar filas de resultados
Cláusula OFFSET	Omitir filas de resultados
Cláusula PIVOT	Rotación de filas a columnas
Cláusula UNPIVOT	Rotación de columnas a filas
Cláusula LATERAL VIEW	Aplicación de la función de generación de tablas
Cláusula TABLESAMPLE	Filas de tabla de ejemplo
Invocación de función con valores de tabla (TVF)	Funciones que devuelven tablas
CTE common_table_expression	Subconsultas con nombre
Operadores de conjuntos	UNION, INTERSECT, EXCEPT
Cláusula WINDOW	Definiciones de ventana con nombre
Sugerencias	Sugerencias del optimizador de consultas

Instrucciones de Delta Lake

Administrar tablas almacenadas en formato Delta Lake. Para más información, consulte ¿Qué es Delta Lake en Azure Databricks?.

Statement	Description
CACHE SELECT	Resultados de la consulta de caché
CONVERT TO DELTA	Convertir Parquet a Delta
DESCRIBE HISTORY	Mostrar historial de tablas
FSCK REPAIR TABLE	Reparación de metadatos de tabla
GENERATE	Generar manifiesto de tabla
OPTIMIZE	Compactar archivos de tabla
REORG TABLE	Reorganización de datos de tabla
RESTORE	Restauración de la tabla a una versión anterior
VACUUM	Eliminación de archivos de tabla antiguos

Instrucciones de scripting de SQL

Ejecute la lógica de procedimientos en SQL. Consulte Scripting de SQL para obtener información general.

Statement	Description
Instrucción compuesta BEGIN END	Agrupar instrucciones en un bloque
Instrucción de CASE	Ramificación condicional.
Instrucción FOR	Bucle sobre un intervalo o cursor
GET Instrucción DIAGNOSTICS	Recuperación de la información de ejecución
Instrucción IF THEN ELSE	Ejecución condicional
Instrucción ITERATE	Continúe con la iteración del bucle siguiente.
Instrucción LEAVE	Salir de un bucle o un bloque
Instrucción LOOP	Bucle incondicional
Instrucción REPEAT	Loop until condition is true
Instrucción RESIGNAL	Volver a generar una excepción
Instrucción SIGNAL	Generar una excepción
Instrucción WHILE	Bucle mientras la condición es true

Declaraciones auxiliares

Recopile estadísticas, administre el almacenamiento en caché, explore metadatos, establezca configuraciones y administre recursos.

Instrucciones ANALYZE

Statement	Description
ANALYZE TABLE … ESTADÍSTICAS DE PROCESO	Estadísticas de columnas de tabla de proceso
ANALYZE TABLE … MÉTRICAS DE ALMACENAMIENTO DE PROCESO	Métricas de Almacenamiento de tablas de proceso

Instrucciones de caché

Se aplica a: Databricks Runtime

Statement	Description
CACHE TABLE	Tabla de caché en memoria
CLEAR CACHE	Eliminación de todos los datos almacenados en caché
REFRESH CACHE	Actualizar datos almacenados en caché
REFRESH FUNCTION	Actualizar metadatos de función
REFRESH TABLE	Actualizar metadatos de tabla
UNCACHE TABLE	Eliminación de la tabla de la caché

Describir instrucciones

Statement	Description
DESCRIBE CATALOG	Mostrar detalles del catálogo
DESCRIBE CONNECTION	Mostrar detalles de conexión
DESCRIBE CREDENTIAL	Mostrar los detalles de las credenciales
DESCRIBE DATABASE	Mostrar detalles de la base de datos
DESCRIBE FUNCTION	Mostrar detalles de la función
DESCRIBE EXTERNAL LOCATION	Mostrar detalles de ubicación
DESCRIBIR PROCEDIMIENTO	Mostrar detalles del procedimiento
DESCRIBE PROVIDER	Mostrar detalles del proveedor
DESCRIBE QUERY	Mostrar esquema de salida de consulta
DESCRIBE RECIPIENT	Mostrar los detalles del destinatario
DESCRIBE SCHEMA	Mostrar detalles del esquema
DESCRIBE SHARE	Mostrar detalles del recurso compartido
DESCRIBE TABLE	Mostrar detalles de la tabla
DESCRIBE VOLUME	Mostrar detalles del volumen

Instrucciones SHOW

Statement	Description
LIST	Enumerar archivos en una ruta de acceso
SHOW ALL IN SHARE	Mostrar todos los objetos del recurso compartido
SHOW CATALOGS	Enumerar catálogos
SHOW COLUMNS	Enumerar columnas de tabla
SHOW CONNECTIONS	Enumerar conexiones
SHOW CREATE TABLE	Mostrar DDL de tabla
SHOW CREDENTIALS	Enumerar credenciales
SHOW DATABASES	Enumerar bases de datos
SHOW FUNCTIONS	Enumerar funciones
SHOW GROUPS	Enumerar grupos
SHOW EXTERNAL LOCATIONS	Enumerar ubicaciones externas
SHOW PARTITIONS	Enumerar particiones de tabla
MOSTRAR PROCEDIMIENTOS	Enumerar procedimientos
SHOW PROVIDERS	Enumerar proveedores
SHOW RECIPIENTS	Enumerar destinatarios
SHOW SCHEMAS	Enumerar esquemas
SHOW SHARES	Compartir listas
SHOW SHARES IN PROVIDER	Enumeración de recursos compartidos del proveedor
SHOW TABLE EXTENDED	Mostrar información de tabla
SHOW TABLES	Enumerar tablas
SHOW TABLES DROPPED	Enumerar tablas quitadas
SHOW TBLPROPERTIES	Mostrar propiedades de tabla
SHOW USERS	Listar usuarios
SHOW VIEWS	Vistas de lista
SHOW VOLUMES	Enumerar volúmenes

Configuración y administración de variables

Statement	Description
CALL	Llamada a un procedimiento almacenado
EXECUTE IMMEDIATE	Ejecución de SQL dinámico
RESET	Restablecer la configuración al valor predeterminado
SET	Establecimiento del parámetro de configuración
SET RECIPIENT	Establecimiento del contexto del destinatario del recurso compartido
SET TIME ZONE	Establecimiento de la zona horaria de sesión
SET variable	Establecer el valor de variable
USE CATALOG	Establecimiento del catálogo actual
USE DATABASE	Establecimiento de la base de datos actual
USE SCHEMA	Establecimiento del esquema actual

Administración de recursos