Escritura de consultas y exploración de datos en el editor de SQL heredado

La interfaz de usuario de Azure Databricks incluye un editor de SQL que puede usar para crear consultas, examinar los datos disponibles y crear visualizaciones. También puede compartir las consultas guardadas con otros miembros del equipo en el área de trabajo. Este artículo explica cómo utilizar el editor SQL para escribir, ejecutar y administrar consultas. Para obtener información sobre cómo habilitar y trabajar con el nuevo editor de SQL, consulte Escritura de consultas y exploración de datos en el nuevo editor de SQL.

Después de abrir el editor, puede crear una consulta SQL o examinar los datos disponibles. El editor de texto admite autocompletar, formato automático y otros métodos abreviados de teclado.

Puede abrir varias consultas mediante las pestañas de consulta en la parte superior del editor de texto. Cada pestaña de consulta tiene controles para ejecutar la consulta, marcar la consulta como favorita y conectarse a un almacén de SQL. También puede Guardar, Programar o Compartir consultas.

Abra el editor de SQL

Para abrir el editor SQL en Azure Databricks UI, haz clic en Editor SQL en la barra lateral.

El editor SQL se abre con la última consulta abierta. Si no existe ninguna consulta, o todas sus consultas se han cerrado explícitamente, se abrirá una nueva consulta. Se llamará automáticamente Nueva consulta y se añadirá la fecha y hora de creación en el título.

Si el editor nuevo de SQL está activado, puede deshabilitarlo para acceder al editor de SQL heredado. Consulte Deshabilitar el nuevo editor de SQL.

Conectar al proceso

Debe tener al menos permisos CAN USE en un almacén SQL en ejecución para ejecutar consultas. Puede usar la lista desplegable cerca de la parte superior del editor para ver las opciones disponibles. Para filtrar la lista, escriba texto en el cuadro de texto.

La primera vez que cree una consulta, la lista de almacenes SQL disponibles aparecerá en orden alfabético. El último almacén SQL usado se seleccionará la próxima vez que cree una consulta.

El icono situado junto al almacén de SQL indica el estado:

• Ejecución
• Detenido

Nota:

Si no hay almacenes SQL en la lista, póngase en contacto con el administrador de su área de trabajo.

El almacén SQL seleccionado se reiniciará automáticamente cuando ejecute su consulta. Consulte Iniciar un almacén SQL para obtener otras formas de iniciar un almacén SQL.

Examinar objetos de datos en el editor de SQL

Si tiene permiso de lectura de metadatos, el navegador de esquemas del editor de SQL muestra las bases de datos y tablas disponibles. También puede examinar los objetos de datos desde el Explorador de catálogos.

Puede navegar por los objetos de base de datos regulados por Unity Catalog en Catalog Explorer sin proceso activo. Para explorar los datos en la hive_metastore y otros catálogos no regidos por Unity Catalog, debe asociarse al proceso con privilegios adecuados. Consulte Gobernanza de datos con Azure Databricks.

Nota:

Si no existen objetos de datos en el navegador de esquemas o en el Explorador de catálogos, póngase en contacto con el administrador de su área de trabajo.

Haga clic en cerca de la parte superior del navegador de esquemas para actualizar el esquema. Puede filtrar el esquema escribiendo cadenas de filtro en el cuadro de búsqueda.

Haga clic en el nombre de una tabla para mostrar las columnas de esa tabla.

Creación de una consulta

Puede escribir texto para crear una consulta en el editor de SQL. Puede insertar elementos desde el navegador de esquemas para hacer referencia a catálogos y tablas.

1. Introduzca su consulta en el editor SQL.

   El editor SQL admite la función autocompletar. A medida que escribe, autocompletar le sugiere terminaciones. Por ejemplo, si una finalización válida en la ubicación del cursor es una columna, autocompletar sugiere un nombre de columna. Si escribe select * from table_name as t where t., autocompletar reconoce que t es un alias para table_name y sugiere las columnas dentro de table_name.

   

2. (Opcional) Cuando haya terminado de editar, haga clic en Save (Guardar). Por defecto, la consulta se guarda en su carpeta de inicio de usuario, o puede seleccionar una ubicación diferente. A continuación, haga clic en Guardar.

Consultar orígenes de datos

Puede identificar un origen de consulta mediante un nombre de tabla completo en la propia consulta o seleccionando una combinación de catálogo y esquema en los selectores desplegables junto con el nombre de la tabla en la consulta. Un nombre de tabla completamente cualificado en la consulta anula los selectores de catálogo y esquema en el editor de SQL. Si un nombre de tabla o columna incluye espacios, pon esos identificadores entre comillas invertidas en tus consultas SQL.

En los ejemplos siguientes se muestra cómo consultar varios objetos similares a tablas que puede almacenar en un catálogo.

Consulta de una tabla o vista estándar

En el ejemplo siguiente se consulta una tabla del samples catálogo.

SELECT
  o_orderdate,
  o_orderkey,
  o_custkey,
  o_totalprice,
  o_shippriority
FROM
  samples.tpch.orders

Consultar una vista de métricas

En el ejemplo siguiente se consulta una vista de métrica que usa una tabla del catálogo de ejemplos como origen. Evalúa las tres medidas enumeradas y agrega sobre Order Month y Order Status. Devuelve los resultados ordenados por Order Month. Para crear una vista de métrica similar en el área de trabajo, consulte Creación de una vista de métricas.

Todas las evaluaciones de medida deben emplear la función MEASURE. Consulte función de agregación measure

SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Order Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC;

Activar y desactivar autocompletar

Autocompletar en directo puede completar los tokens de esquema, los identificadores de sintaxis de consulta (como SELECT y JOIN) y los títulos de fragmentos de consulta. Está habilitado de forma predeterminada, a menos que el esquema de la base de datos supere los cinco mil tokens (tablas o columnas).

Use el botón de alternancia situado bajo el Editor de SQL para desactivar o activar la función de autocompletar en directo.

• Para desactivar el autocompletado en directo, pulse Ctrl + Espacio o haga clic en el botón situado bajo el editor de SQL.

Optimización de una consulta con Databricks Assistant

El comando /optimize de barra inclinada solicita al Asistente que evalúe y optimice las consultas. Para obtener más información, consulte Optimizar Python, PySpark y código SQL.

Guardar consultas

El botón Guardar situado cerca de la parte superior derecha del editor de SQL guarda su consulta.

Importante

Al modificar una consulta, pero no hace clic explícitamente en Guardar, ese estado se conserva como borrador de consulta. Los borradores de consulta se conservan durante 30 días. Después de 30 días, los borradores de consulta se eliminan automáticamente. Para conservar los cambios, debe guardarlos explícitamente.

Edición de varias consultas

De manera predeterminada, el editor de SQL usa pestañas para que pueda editar varias consultas simultáneamente. Para abrir una nueva pestaña, haga clic en + y, luego, seleccione Create new query (Crear nueva consulta) o Open existing query (Abrir consulta existente). Haga clic en Abrir consulta existente para consultar la lista de consultas guardadas. Haga clic en My Queries (Mis consultas) o en Favorites (Favoritos) para filtrar la lista de consultas. En la fila que contiene la consulta que quiere ver, haga clic en Abrir.

Ejecutar una consulta única o consultas de varias instrucciones

Para ejecutar una instrucción de consulta o todas las instrucciones de consulta:

1. Seleccione un almacén de SQL.

2. Resalte una consulta en el editor de SQL (si hay varias consultas en el panel de consultas).

3. Presione Ctrl/Cmd + Entrar o haga clic en Ejecutar (1000) para mostrar los resultados como una tabla en el panel de resultados.

   

Nota:

De forma predeterminada, se selecciona Limitar 1000 para restringir los resultados de la consulta a 1000 filas.

• Si la consulta se guarda con límite 1000, esta configuración se aplica a todas las ejecuciones de consulta, incluidos los paneles.

• Para devolver todas las filas (hasta 64 000), desmarque Límite 1000 en el menú desplegable Ejecutar (1000).

• Para especificar un límite de filas diferente, agregue una LIMIT cláusula a la consulta SQL.

El número máximo de filas devueltas en una tabla es de 64 000.

Finalización de una consulta

Para finalizar una consulta mientras se ejecuta, haga clic en Cancelar. Un administrador puede detener una consulta en ejecución que otro usuario inició viendo la consulta Finalizar una consulta en ejecución.

Opciones de consulta

Puede usar el Menú contextual kebab situado cerca de la parte superior del editor de consultas para acceder a las opciones de menú para clonar, revertir, dar formato y editar información de consulta.

Revertir a la consulta guardada

Cuando se edita una consulta, aparece una opción Revertir cambios en el menú contextual de la consulta. Puede hacer clic en Revert (Revertir) para volver a la versión guardada.

Descartar y restaurar consultas

Para mover una consulta a la papelera:

• Haga clic en el menú contextual situado junto a la consulta en el editor de SQL y seleccione Mover a la papelera.
• Haga clic en Move to trash (Mover a la papelera) para confirmar.

Para restaurar una consulta de la papelera:

1. En la lista Todas las consultas, haga clic en .
2. Haga clic en una consulta.
3. Haga clic en el en la parte superior derecha del editor de SQL y haga clic en Restaurar.

Establecimiento de la descripción de la consulta y visualización de la información de consulta

Para establecer una descripción de la consulta:

1. Haga clic en el Menú contextual kebab situado junto a la consulta y haga clic en Editar información de consulta.

   

2. En el cuadro de texto Descripción, escriba la descripción. A continuación, haga clic en Guardar. También puede ver el historial de la consulta, incluido el momento en que se creó y actualizó, en este cuadro de diálogo.

Marcar como favorito y etiquetar consultas

Puede usar favoritos y etiquetas para filtrar las listas de consultas y paneles que se muestran en la página de aterrizaje del área de trabajo y en cada una de las páginas de lista de paneles y consultas.

Favoritos: para marcar como favorita una consulta, haga clic en la estrella situada a la izquierda de su título en la lista Consultas. La estrella se pondrá amarilla.

Etiquetas: puede etiquetar las consultas y los paneles con cualquier cadena significativa para su organización.

Agregar una etiqueta

Agregue etiquetas en el editor de consultas.

1. Haga clic en el Menú contextual kebab situado junto a la consulta y haga clic en Editar información de consulta. Aparecerá un cuadro de diálogo de Información de consulta.

2. Si la consulta no tiene etiquetas aplicadas,Agregar algunas etiquetas muestra el cuadro de texto donde aparecerán las etiquetas. Para crear una nueva etiqueta, escríbala en la casilla. Para escribir varias etiquetas, pulse el tabulador entre las entradas.

   

3. Haga clic en Guardar para aplicar las etiquetas y cerrar el cuadro de diálogo.

Eliminación de etiquetas

1. Haga clic en el Menú contextual kebab situado junto a la consulta y haga clic en Editar información de consulta.
2. Haga clic en X sobre cualquier etiqueta que quiera eliminar.
3. Haga clic en Guardar para cerrar el cuadro de diálogo.

Visualización de resultados de consultas

Después de ejecutar una consulta, los resultados aparecen en el panel inferior. La Tabla de nuevos resultados está ACTIVADA para las nuevas consultas. Si es necesario, haga clic en la lista desplegable para desactivarla. Las imágenes de esta sección usan la nueva tabla de resultados.

Puede interactuar con los resultados de la consulta y explorarlos mediante el panel de resultados. El panel de resultados incluye las siguientes características para explorar los resultados.

Visualizaciones, filtros y parámetros

Haga clic en el para agregar una visualización, un filtro o un parámetro. Aparecerán las siguientes opciones:

Visualización: las visualizaciones pueden ayudar a explorar el conjunto de resultados. Consulte Tipos de visualización del editor de CUADERNOs y SQL para obtener una lista completa de los tipos de visualización disponibles.

Filtro: los filtros permiten limitar el conjunto de resultados después de ejecutar una consulta. Puede aplicar filtros para mostrar de forma selectiva diferentes subconjuntos de los datos. Consulte Filtros de consulta para obtener información sobre cómo usar filtros.

Parámetro: los parámetros permiten limitar el conjunto de resultados sustituyendo los valores en una consulta en tiempo de ejecución. Consulte Trabajar con parámetros de consulta para obtener información sobre cómo aplicar parámetros.

Editar, descargar o agregar a un panel

Importante

Databricks recomienda utilizar paneles de IA o BI (anteriormente paneles de Lakeview). Las versiones anteriores de los paneles, anteriormente conocidas como paneles sql de Databricks, ahora se denominan paneles heredados.

Fin del plazo de soporte:

• 12 de enero de 2026: Los paneles y las API heredados ya no son accesibles directamente. Sin embargo, usted todavía puede convertirlos en paneles de IA/BI. La página de migración está disponible hasta el 2 de marzo de 2026.

Convierta paneles heredados mediante la herramienta de migración o la API de REST. Consulte Clonar un panel heredado en un panel de IA/BI para obtener instrucciones sobre cómo usar la herramienta de migración integrada. Consulte Uso de las API de Azure Databricks para administrar paneles para ver tutoriales sobre cómo crear y administrar paneles mediante la API REST.

Haga clic en en una pestaña de resultados para ver más opciones.

1. Haga clic en Editar para personalizar los resultados que se muestran en la visualización.
2. Haga clic en Eliminar para eliminar la pestaña de resultados.
3. Haga clic en Duplicar para clonar la pestaña de resultados.
4. Haga clic en Agregar al panel para copiar la consulta y la visualización en un nuevo panel.
   • Esta acción crea un nuevo panel que incluye todas las visualizaciones asociadas a la consulta. Consulte Paneles para obtener información sobre cómo editar el panel.
   • Se le pedirá que elija un nombre para el nuevo panel. El nuevo panel se guarda en la carpeta principal.
   • No se pueden agregar resultados a un panel existente.
5. Haga clic en Agregar al panel heredado para agregar la pestaña de resultados a un panel heredado existente.
6. Haga clic en cualquiera de las opciones de descarga para descargar los resultados. Consulte la descripción siguiente para obtener detalles y límites.

Descargar resultados: puede descargar los resultados como un archivo CSV, TSV o Excel.

Puede descargar hasta aproximadamente 1 GB de datos de resultados de Databricks SQL en formato CSV y TSV, y hasta 100 000 filas en un archivo de Excel.

El tamaño final de descarga de archivos puede ser ligeramente mayor o menor que 1 GB, ya que el límite de 1 GB se aplica a un paso anterior que la descarga final de archivos.

Nota:

Si no puede descargar una consulta, el administrador del área de trabajo ha deshabilitado la descarga del área de trabajo.

Ejecuciones anteriores

Puede ver las ejecuciones anteriores de la consulta, incluida la sintaxis de consulta completa. Las ejecuciones anteriores se abren en modo de solo lectura e incluyen botones para Clonar a una nueva consulta o Reanudar la edición. Esta pestaña no muestra ejecuciones programadas.

Exploración de los resultados

Los resultados de la consulta devueltos aparecen debajo de la consulta. La pestaña Resultados sin procesar se rellena con las filas devueltas. Puede usar los filtros integrados para reordenar los resultados por valores ascendentes o descendentes. También puede usar el filtro para buscar filas de resultados que incluyan un valor específico.

Puede usar pestañas en el panel de resultados para agregar visualizaciones, filtros y parámetros.

Filtrar la lista de consultas guardadas en la ventana de consultas

En la ventana de consultas, puede filtrar la lista de todas las consultas por la lista de consultas que ha creado (Mis consultas), por favoritos y por etiquetas.

Automatización de las actualizaciones

Puede usar el botón Programar para establecer una cadencia automática para las ejecuciones de consultas. Las actualizaciones automáticas pueden ayudar a mantener actualizados los paneles e informes con los datos más actuales. Las consultas programadas también pueden habilitar las alertas de Databricks SQL, un tipo especial de tarea programada que envía notificaciones cuando un valor alcanza un umbral especificado.

Consulte Programación de consultas.

Consulte Alertas de SQL de Databricks.

Compartir consultas

El botón Compartir le permite compartir su consulta con otros usuarios de su área de trabajo. Al compartir, elija entre las siguientes opciones:

• Ejecutar como propietario (credenciales del propietario): esta configuración significa que los visores pueden ver los mismos resultados de consulta que el propietario de la consulta. Esto se aplica a las ejecuciones de consultas programadas o manuales.
• Ejecutar como visor (credenciales de visor): esta configuración limita los resultados a los permisos asignados del visor.

Consulte Configuración de permisos de consulta.

Paso siguiente

Consulte Acceso y administración de consultas guardadas para aprender a trabajar con consultas con la interfaz de usuario de Azure Databricks.