Escritura de consultas en el nuevo editor de SQL

En esta página se explica cómo conectarse a una instancia de SQL Warehouse, examinar archivos y datos y escribir consultas en el nuevo editor de SQL de Databricks.

Conectar al proceso

Debe tener al menos permisos CAN USE en una instancia de SQL Warehouse 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 búsqueda.

Si tiene un almacenamiento SQL predeterminado, el editor de SQL lo usa automáticamente al crear una consulta. Si no se establece ningún almacén predeterminado, seleccione una lista alfabética de almacenes disponibles. Las consultas posteriores usan el último almacén seleccionado. Para establecer un almacenamiento predeterminado, consulte Establecimiento de un almacenamiento predeterminado de nivel de usuario.

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

• Ejecución
• Detenido

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 activos y obtener ayuda

Use el panel izquierdo del editor de SQL para buscar archivos del área de trabajo, ver objetos de datos y obtener ayuda de Genie Code.

Examinar archivos del área de trabajo

Haga clic en el para abrir la carpeta de usuario del área de trabajo. Puede ir a todos los archivos del área de trabajo a los que tiene acceso desde esta parte de la interfaz de usuario.

Explorar objetos de datos

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.

Haga clic en cerca de la parte superior del navegador de esquemas para actualizar el esquema. Puede escribir texto en la barra de búsqueda para filtrar los recursos por nombre. Haga clic en el Icono de filtro para filtrar objetos por tipo.

Haga clic en el nombre de un objeto en el explorador para ver más detalles sobre el objeto. Por ejemplo, haga clic en un nombre de esquema para mostrar las tablas de ese esquema. Haga clic en un nombre de tabla para mostrar las columnas de esa tabla.

Obtener ayuda de Genie Code

Haga clic en Icono de Genie Code para abrir una ventana de chat con Genie Code. Haga clic en una pregunta sugerida o escriba su propia pregunta para interactuar con Genie Code.

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. Escriba la consulta en el editor de 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. También puede utilizar la función de autocompletar para hacer referencia a los fragmentos de consulta.

   

2. (Opcional) Cuando haya terminado de editar, haga clic en Save (Guardar). De forma predeterminada, la consulta se guarda en la carpeta Inicio del usuario. Para guardar la consulta en otra ubicación, seleccione la carpeta de destino y haga clic en Mover.

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 Tutorial: Creación de una vista de métrica completa con combinaciones.

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

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;

Optimización de una consulta con Genie Code

Haga clic en el Icono del asistente en el lado derecho del editor para obtener ayuda y sugerencias insertadas al escribir consultas. 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.

Editar varias pestañas de consulta

De forma predeterminada, el editor de SQL usa pestañas para que pueda abrir y 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 ver una lista de consultas. En la pestaña For you se ofrece una lista seleccionada de sugerencias basadas en tu uso. Use la pestaña Todo para buscar cualquier consulta a la que tenga acceso.

Almacenamiento de una consulta

El contenido de la consulta en el nuevo editor de SQL se guarda automáticamente continuamente. El botón Guardar controla si el contenido de la consulta de borrador debe aplicarse a recursos relacionados, como flujos de trabajo o alertas heredadas. Si la consulta se comparte con el Ejecutar como propietario credencial, solo el propietario de la consulta puede usar el botón Guardar para propagar los cambios. Si la credencial se establece en Ejecutar como visor, cualquier usuario con al menos CAN MANAGE permiso puede guardar la consulta.

Control de código fuente de una consulta

Los archivos de consulta SQL de Databricks (extensión: .dbquery.ipynb) se admiten en carpetas de Git de Databricks. Puede usar una carpeta de Git para controlar el código fuente de los archivos de consulta y compartirlos en otras áreas de trabajo con carpetas de Git que tengan acceso al mismo repositorio de Git. Si decide no participar en el nuevo editor de SQL después de confirmar o clonar una consulta en una carpeta de Git de Databricks, elimine y vuelva a incluir esa carpeta de Git para evitar comportamientos inesperados.