Cómo usar el Ejecutor de SQL para crear consultas y exploraciones

El ejecutor de SQL proporciona una forma de acceder directamente a tu base de datos y aprovechar ese acceso de varias maneras. Con SQL Runner, puedes navegar fácilmente por las tablas en tu esquema, usar una exploración ad hoc a partir de una consulta en SQL, ejecutar consultas descriptivas predefinidas en tus datos, ver tu historial de SQL Runner, descargar resultados, compartir consultas, agregar consultas a un proyecto de LookML como una tabla derivada y realizar otras tareas útiles.

En esta página, se describe cómo ejecutar consultas en el Ejecutor de SQL, crear exploraciones ad hoc y cómo usar el Ejecutor de SQL para depurar consultas. Consulta estas otras páginas de documentación para obtener información sobre lo siguiente:

Ejecutar consultas en el Ejecutor de SQL

Para ejecutar una consulta en tu base de datos, puedes escribir la consulta en SQL desde cero, usar una exploración para crear la consulta o ejecutar una consulta en un modelo de LookML. También puedes usar el historial para volver a ejecutar una consulta anterior.

Escribir una consulta en SQL desde cero

Puedes usar el Ejecutor de SQL para escribir y ejecutar tus propias consultas en SQL en tu base de datos. Looker pasa la consulta a la base de datos tal como la escribiste, así que asegúrate de que la sintaxis de la consulta en SQL sea válida para el dialecto de la base de datos. Por ejemplo, cada dialecto tiene funciones SQL ligeramente diferentes con parámetros específicos que se deben pasar a la función.

  1. Ingresa una consulta en SQL en el cuadro de texto debajo de la barra de Consultas.
  2. De manera opcional, selecciona un nombre o campo de tabla de la lista de campos para incluirlos en tu consulta en la ubicación del cursor.
  3. Selecciona Ejecutar para ejecutar la consulta en tu base de datos.
  4. Visualiza los resultados en el área Resultados. El Ejecutor de SQL cargará hasta 5,000 filas del conjunto de resultados de la consulta. Para los dialectos de SQL que admiten la transmisión, puedes descargar los resultados para ver el conjunto de resultados completo.

Algunos programas de SQL te permiten ejecutar varias consultas en una serie. Sin embargo, solo puedes ejecutar una consulta a la vez en el Ejecutor de SQL. El Ejecutor de SQL también tiene un límite de 65,535 caracteres en las consultas, incluido el espacio en blanco.

Después de ejecutar una consulta, puedes agregar la consulta a un proyecto, obtener LookML para una tabla derivada o compartir la consulta.

También puedes usar el Ejecutor de SQL para experimentar con consultas nuevas o probar las existentes. El resaltado de errores de SQL Runner ayuda a probar y depurar consultas.

Cómo usar una exploración para crear una consulta en SQL

También puedes usar una exploración para crear una consulta y, luego, obtener el comando de SQL para que esa consulta lo use en el Ejecutor de SQL:

  1. En una exploración, selecciona la pestaña SQL de la barra Datos.
  2. La consulta en SQL aparecerá en la barra Datos.
  3. Selecciona Abrir en el Ejecutor de SQL o Explicar en el Ejecutor de SQL para abrir la consulta en el Ejecutor de SQL.

Una vez que se agrega una consulta al cuadro de texto debajo de la barra Consulta, puedes seleccionar Ejecutar para consultar la base de datos. Como alternativa, puedes editar la consulta y, luego, ejecutar la nueva consulta.

Crea visualizaciones con el Ejecutor de SQL

Si tu administrador de Looker habilitó la función de Labs SQL Runner Vis, puedes crear visualizaciones directamente en SQL Runner.

Con la visualización de SQL Runner habilitada, se reorganizan los paneles de SQL Runner. El panel de visualización aparece en la parte superior, el panel de resultados está en el medio y el panel de consultas, en la parte inferior.

  1. Después de crear y ejecutar una consulta en SQL, puedes abrir la pestaña Visualization para verla y elegir un tipo de visualización, tal como lo harías en la página Explorar.
  2. Puedes editar la visualización usando el menú Configuración.
  3. Puedes compartir las visualizaciones creadas con el Ejecutor de SQL si compartes la URL. Todas las personalizaciones que realice mediante el menú Configuración de la visualización se guardarán y el vínculo no cambiará.

Hay algunas cosas para tener en cuenta sobre cómo funcionan las visualizaciones de SQL Runner:

  • La tabla de resultados y la visualización interpretan cualquier campo numérico como una medida.
  • El nombre completo del campo siempre se usa en la tabla de resultados y en la visualización. Por lo tanto, la opción Show Full Field Name del menú Settings está inactiva.
  • Para usar campos personalizados, cálculos basados en tablas, tablas dinámicas, totales de columnas y subtotales, explora desde tu consulta de SQL Runner.
  • Las visualizaciones de mapas estáticos (regiones) no son compatibles con las visualizaciones de SQL Runner; sin embargo, sí se admiten los mapas que usan datos de latitud y longitud (mapas y visualizaciones de mapas estáticos [puntos]).
  • Las visualizaciones de cronograma no son compatibles con las visualizaciones del Runner de SQL.

Dimensiones dinámicas

Puedes editar los resultados de la consulta para dinamizar una o más dimensiones en las visualizaciones de SQL Runner. Para alternar un campo, haz lo siguiente:

  1. Selecciona el menú de ajustes de una columna en el área Resultados para mostrar las opciones de la columna.
  2. Selecciona Columna dinámica.

Los resultados dinámicos se muestran en la visualización del Runner de SQL.

Los resultados en el área Resultados no aparecen dinámicos.

Para anular la dinamización de los resultados, selecciona el menú de ajustes de la columna dinámica y elige Anular la dinamización de la columna.

Cambia el tipo de campo

Cuando se muestran los resultados y la visualización de tu consulta, el Ejecutor de SQL interpreta automáticamente cualquier campo numérico como una medida y cualquier campo no numérico como una dimensión. Puedes anular el tipo de campo predeterminado y convertir una dimensión en una medición, o viceversa, siguiendo estos pasos:

  1. Selecciona el menú de ajustes de una columna en el área Resultados para mostrar las opciones de la columna.
  2. Selecciona Convertir en dimensión o Convertir en medición para cambiar el tipo de campo.

La visualización mostrará el nuevo tipo de campo.

Ejecuta una consulta en un modelo de LookML

Puedes usar el Ejecutor de SQL para escribir y ejecutar consultas en SQL en un modelo de LookML, en lugar de hacerlo directamente en tu base de datos. Cuando construyes tu consulta a partir de un modelo, puedes usar operadores de sustitución de LookML, como ${view_name.field_name} o ${view_name.SQL_TABLE_NAME}. Esto puede ahorrar tiempo cuando se construye una consulta para solucionar problemas de una tabla derivada, por ejemplo.

Looker resuelve cualquier sustitución de LookML y, luego, pasa la consulta a la base de datos, por lo que debe estar en SQL válido para el dialecto de la base de datos. Por ejemplo, cada dialecto tiene funciones SQL ligeramente diferentes con parámetros específicos que se deben pasar a la función.

Para ejecutar una consulta en tu modelo de LookML en el Ejecutor de SQL, haz lo siguiente:

  1. Selecciona la pestaña Modelo.
  2. Selecciona el modelo que deseas consultar.
  3. En el cuadro de texto debajo de la barra Datos, ingresa tu consulta en SQL con los campos de LookML.
  4. De manera opcional, selecciona una vista de la lista de vistas para incluirla en tu consulta en la ubicación del cursor.
  5. Para ver la lista de campos en una vista, selecciónala en la sección Vistas. De manera opcional, puedes seleccionar un campo de la lista de campos para incluirlo en tu consulta en la ubicación del cursor.
  6. En el área Consulta en SQL preparada, puedes ver la consulta en SQL resultante que se compila después de que cualquier sustitución de LookML se tradujo a SQL.
  7. Selecciona Ejecutar para ejecutar la consulta en tu modelo.
  8. Visualiza los resultados en el área Resultados. El ejecutor de SQL carga hasta 5,000 filas del conjunto de resultados de la consulta. Para los dialectos de SQL que admiten la transmisión, puedes descargar los resultados para ver el conjunto de resultados completo.

Puedes usar SQL Runner para probar consultas nuevas, probar las existentes o abrir una nueva Exploración a partir de los resultados. El resaltado de errores de SQL Runner ayuda a probar y depurar consultas.

Cuando tengas una consulta que te guste, puedes compartirla o incluso agregarla a un proyecto de LookML.

Visualiza LookML de un campo desde el Ejecutor de SQL

En la lista de campos de la pestaña Modelo, también puedes ver el LookML de un campo. Coloca el cursor sobre el campo en la lista de campos y selecciona el ícono de Looker a la derecha del nombre del campo.

Looker abrirá el IDE de LookML y cargará el archivo en el que se define el campo.

Historial del ejecutor de SQL

También puedes ver un historial reciente de todas las consultas que ejecutaste en el Ejecutor de SQL.

Para ver tu historial, selecciona la pestaña Historial en la parte superior del panel de navegación. El ejecutor de SQL muestra todas las consultas que se ejecutaron en la conexión de la base de datos. El rojo indica que una consulta no se ejecutó debido a un error.

Selecciona una consulta del historial para propagarla en el Ejecutor de SQL y, luego, selecciona Ejecutar para volver a ejecutar la consulta.

Cómo ordenar tu consulta

El orden de clasificación de una tabla se indica con una flecha hacia arriba o hacia abajo junto al nombre del campo ordenado, dependiendo de si los resultados están en orden ascendente o descendente. Para ordenar por varias columnas, mantén presionada la tecla Mayús y, a continuación, selecciona los encabezados de las columnas en el orden en que deseas que se ordenen. El orden de clasificación de un campo también se indica mediante un número que distingue su orden de clasificación de otros campos, con una flecha junto al nombre del campo que muestra la dirección de ordenamiento (ascendente o descendente) y con una ventana emergente que aparece cuando se desplaza sobre el nombre de un campo.

Para obtener más información y ejemplos, consulta la sección Ordena datos de la página de documentación Explora datos en Looker.

Consultas compartidas

Puedes compartir una consulta en el Ejecutor de SQL con otro usuario que tenga acceso al Ejecutor de SQL. Para compartir una consulta, copia la URL que aparece en la barra de direcciones del navegador.

Descargando los resultados

Una vez que hayas ejecutado tu consulta en SQL, puedes descargar los resultados en una variedad de formatos.

  1. Escribe una consulta en el cuadro Consulta en SQL. (en este punto, no es necesario que ejecutes la consulta en el Ejecutor de SQL).
  2. Selecciona Descargar en el menú de ajustes de la esquina superior derecha.
  3. Selecciona el formato de archivo de la descarga (archivo de texto, CSV, JSON, etcétera).

  4. Selecciona Abrir en el navegador para ver los resultados en una nueva ventana del navegador o Descargar para descargar los resultados en un archivo en tu computadora.

    Cuando selecciones Abrir en el navegador o Descargar, Looker volverá a ejecutar la consulta y, luego, realizará la descarga.

Para los dialectos de SQL que admiten la transmisión, la opción Download del Runner de SQL descargará todo el conjunto de resultados. Para los dialectos de SQL que no admiten la transmisión, la opción Descargar del Ejecutor de SQL descargará solo las filas de la consulta que se muestran en la sección Resultados (hasta 5,000 filas).

Cómo copiar valores de columnas

Puedes copiar los valores de la columna desde la sección Resultados en SQL Runner. Selecciona el menú de ajustes de una columna para copiar los valores en el portapapeles. Desde allí, puedes pegar los valores de las columnas en un archivo de texto, una hoja de cálculo de Excel u otra ubicación.

Si el administrador de Looker habilitó la función SQL Runner Vis Labs, también tienes otras opciones en el menú de ajustes de la columna:

También puedes mover, fijar y resize de las columnas de forma manual en la tabla de resultados.

Estimaciones de costo para las consultas del Ejecutor de SQL

Para conexiones BigQuery, MySQL, Amazon RDS para MySQL, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL para PostgreSQL y Microsoft Azure PostgreSQL, SQL Runner proporciona una estimación del costo de la consulta. Una vez que ingresas la consulta en SQL, el ejecutor de SQL calculará la cantidad de datos que requerirá la consulta y mostrará la información cerca del botón Ejecutar.

Para las conexiones de BigQuery, MySQL y Amazon RDS para MySQL, las estimaciones de costos siempre están habilitadas. En el caso de las conexiones de bases de datos de Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL para PostgreSQL y Microsoft Azure PostgreSQL, debes habilitar la opción Estimación de costos para la conexión. Puedes habilitar la Estimación de costos cuando creas la conexión. En el caso de las conexiones existentes, puedes editar la conexión desde la página Conexiones en la sección Base de datos del panel Administrador de Looker.

Crea una exploración ad hoc

Desde el Ejecutor de SQL, puedes obtener estadísticas rápidas de los datos creando una exploración ad hoc para una consulta en SQL o una tabla de base de datos. Puedes usar la exploración de Looker para seleccionar campos, agregar filtros, visualizar los resultados y crear consultas en SQL.

Hay dos maneras de abrir una exploración ad hoc desde el Ejecutor de SQL:

  • Explorar desde los resultados de consultas del ejecutor de SQL
  • Explorar desde la lista de tablas del ejecutor de SQL

Explora desde los resultados de la consulta de SQL Runner

El ejecutor de SQL te permite abrir una exploración desde una consulta en SQL. Esto crea una exploración temporal a partir de la consulta escrita en el Ejecutor de SQL. Esto te permite probar lo que devuelve la consulta, así como visualizar los resultados. Esto se puede usar para cualquier consulta, pero es especialmente útil si deseas probar las consultas que planeas usar para las tablas derivadas.

Si el administrador de Looker habilitó la función de Labs Visualización de SQL Runner, puedes crear visualizaciones directamente en el Ejecutor de SQL.

  1. Usa el Ejecutor de SQL para crear la consulta en SQL que quieres usar.
  2. Selecciona Explorar en el menú de ajustes de la parte superior derecha. Esto te lleva a una nueva exploración, donde puedes explorar la consulta en SQL como si fuera una tabla guardada en tu modelo.
  3. Puedes copiar la URL a esta Explorar para compartirla.
  4. Para agregar esta consulta como una tabla derivada en tu proyecto directamente desde aquí, selecciona Add View to Project.

Crea campos personalizados mientras exploras en el Ejecutor de SQL

Si tienes acceso a la función de campos personalizados, puedes usarlos para visualizar campos sin modelar en el Ejecutor de SQL. Como se describió en la sección anterior, selecciona Explorar en el menú de ajustes. Luego, en el selector de campos, sigue estos pasos:

Explora una tabla enumerada en el Ejecutor de SQL

Usa la opción Explorar tabla en la pestaña Base de datos para crear una exploración ad hoc para cualquier tabla de la conexión. Esto te permite usar Looker en una tabla antes de modelarla y explorarla como una vista de LookML.

Una vez que abres una exploración de la tabla, puedes decidir si deseas agregar la tabla a tu proyecto. También puedes usar la pestaña SQL de Explorar para ver las consultas en SQL que Looker envía a la base de datos y, luego, usar el botón Abrir en el Ejecutor de SQL para llevar la consulta nuevamente al Ejecutor de SQL.

  1. Selecciona la pestaña Base de datos.
  2. En el Ejecutor de SQL, selecciona el ícono de ajustes de una tabla y, luego, Explorar tabla.
  3. Looker genera un modelo temporal con una vista para la tabla y, luego, muestra Explorar.
  4. Looker proporciona un campo de dimensiones para cada columna de la tabla. (es la misma manera en que Looker genera un modelo al comienzo de un proyecto).
  5. Looker incluye automáticamente plazos para cualquier campo de fecha.
  6. Looker también incluye una medición de recuento.

Cuando usas la opción Explorar tabla, no hay ningún archivo de LookML asociado con Explorar; solo es una vista ad hoc de la tabla.

Depura con el Ejecutor de SQL

El ejecutor de SQL también es una herramienta útil para verificar errores de SQL en consultas.

Destacado de error del Runner de SQL

El ejecutor de SQL destaca la ubicación de los errores en el comando de SQL e incluye la posición del error en el mensaje de error:

La información de posición proporcionada variará según el dialecto de la base de datos. Por ejemplo, MySQL proporciona el número de línea que contiene el error, mientras que Redshift proporciona la posición del carácter del error. Otros dialectos de bases de datos pueden tener uno de estos u otros comportamientos.

El Ejecutor de SQL también destaca la ubicación del primer error de sintaxis en el comando de SQL subrayado en rojo y marcando la fila con una x. Mantén el puntero sobre la x para ver más información sobre el error. Luego de solucionar el problema, selecciona Ejecutar para ver si hay más errores en la consulta.

Cómo usar el Ejecutor de SQL para verificar errores en Exploraciones

Si te encuentras con errores de sintaxis de SQL en una exploración, puedes usar SQL Runner para determinar la ubicación del error y su tipo, como errores de ortografía o comandos faltantes.

  1. En Explorar, selecciona la pestaña SQL de la barra de datos.
  2. Selecciona Abrir en el Ejecutor de SQL para abrir la consulta en el Ejecutor de SQL.

Esto copia el SQL generado por la exploración en el Ejecutor de SQL. Como se muestra en la sección Destacado de errores del Runner de SQL, el Ejecutor de SQL destaca la ubicación de los errores en el comando de SQL e incluye la posición del error en el mensaje de error. A continuación, puedes realizar cambios y volver a ejecutar la consulta en el Ejecutor de SQL hasta que hayas corregido los errores.

Usa el Ejecutor de SQL para verificar errores en tablas derivadas

Si quieres obtener información sobre el uso del Ejecutor de SQL para verificar errores de SQL en tablas derivadas, consulta la publicación de Comunidad de Looker sobre cómo usar el Ejecutor de SQL para probar tablas derivadas.