Usar el Ejecutor de SQL para crear consultas y exploraciones

El Ejecutor de SQL proporciona una forma de acceder directamente a su base de datos y aprovechar ese acceso de varias maneras. Con el Ejecutor de SQL, puedes navegar fácilmente por las tablas en tu esquema, usar una exploración ad hoc desde una consulta en SQL, ejecutar consultas descriptivas predefinidas en tus datos, ver el historial del Ejecutor de SQL, descargar resultados, compartir consultas, agregar contenido 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 usar el Ejecutor de SQL para depurar consultas. Consulta estas otras páginas de documentación para obtener información sobre lo siguiente:

Ejecuta 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.

Escribe una consulta en SQL desde cero

Puedes usar el Ejecutor de SQL para escribir y ejecutar tus propias consultas SQL en tu base de datos. Looker pasa tu consulta a tu base de datos tal como la escribiste, así que asegúrate de que la sintaxis de tu consulta en SQL sea válida para el dialecto de tu 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 Consulta.
  2. De manera opcional, selecciona un nombre de tabla o un campo 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. Consulta los resultados en el área Resultados. El Ejecutor de SQL cargará hasta 5,000 filas del conjunto de resultados de la consulta. En el caso de 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 para las consultas, incluidos los espacios en blanco.

Luego 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 jugar con consultas nuevas o probar consultas existentes. El error destacado del Ejecutor de SQL ayuda a probar y depurar consultas.

Usa 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. Desde una exploración, selecciona la pestaña SQL de la barra Datos.
  2. La consulta en SQL aparecerá en la barra Data.
  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 de Consulta, puedes seleccionar Ejecutar para consultar la base de datos. Como alternativa, puedes editar la consulta y, luego, ejecutar la consulta nueva.

Crea visualizaciones con el Ejecutor de SQL

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

Cuando se habilita SQL Runner Vis, se reorganizan los paneles del Ejecutor de SQL. El panel de visualización aparece en la parte superior, el panel de resultados está en el medio y el panel de consultas aparece en la parte inferior.

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

Hay algunos aspectos para tener en cuenta sobre el funcionamiento de las visualizaciones del Ejecutor de SQL:

  • 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 Mostrar nombre completo del campo del menú Configuración 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 del Ejecutor de SQL. Sin embargo, se admiten los mapas que usan datos de latitud y longitud (visualizaciones de mapa y de mapa estático (puntos)).
  • Las visualizaciones de cronograma no son compatibles con las visualizaciones del Ejecutor de SQL.

Dimensiones dinámicas

Puedes editar los resultados de la consulta para dinamizar en una o más dimensiones en las visualizaciones del Ejecutor de SQL. Para dinamizar un campo, sigue estos pasos:

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

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

Los resultados del área Resultados no parecen dinámicos.

Para anular la dinamización de los resultados, selecciona el menú de ajustes de la columna dinámica y selecciona Anular 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 con un modelo, puedes usar los operadores de sustitución de LookML, como ${view_name.field_name} o ${view_name.SQL_TABLE_NAME}. Esto puede ahorrar tiempo cuando se crea una consulta para solucionar problemas de una tabla derivada, por ejemplo.

Looker resuelve todas las sustituciones de LookML y, luego, pasa la consulta a tu base de datos, por lo que debe estar en un 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 (Data), 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 Views. 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 de SQL preparada, puedes ver la consulta en SQL resultante que se compila después de que las sustituciones de LookML se traducen a SQL.
  7. Selecciona Ejecutar para ejecutar la consulta en tu modelo.
  8. Consulta 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 el Ejecutor de SQL para jugar con búsquedas nuevas, probar consultas existentes o abrir una exploración nueva desde los resultados. El error destacado del Ejecutor de SQL ayuda a probar y depurar consultas.

Cuando tengas una consulta que quieras, puedes compartirla y hasta agregarla a un proyecto de LookML.

Visualiza el 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 abre el IDE de LookML y carga 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 una consulta que no se ejecutó debido a un error.

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

Ordena 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, en función de si los resultados están en orden ascendente o descendente. Puedes ordenar por varias columnas si mantienes presionada la tecla Mayús y, luego, seleccionas 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 en comparación con otros campos, con una flecha junto al nombre del campo que muestra la dirección de ordenamiento (ascendente o descendente) y mediante una ventana emergente que aparece cuando colocas el cursor 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 en la barra de direcciones del navegador.

Descargando los resultados

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

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

  4. Selecciona Abrir en el navegador para ver los resultados en una nueva ventana del navegador o selecciona Descargar para descargarlos 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 Descargar del Ejecutor de SQL descargará el conjunto de resultados completo. 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).

Copia valores de columnas

Puedes copiar los valores de la columna de la sección Resultados en el Ejecutor de SQL. 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 o cualquier 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 columnas:

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

Estimaciones de costos para las consultas del Ejecutor de SQL

En el caso de las conexiones de 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 ingreses 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.

En el caso de las conexiones con BigQuery, MySQL y Amazon RDS para MySQL, las estimaciones de costos siempre están habilitadas. Para las conexiones de bases de datos Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL para PostgreSQL y Microsoft Azure PostgreSQL, debes habilitar la opción Cost Estimate de la conexión. Puedes habilitar la Estimación de costos cuando creas la conexión. Para 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.

Cómo crear una exploración ad hoc

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

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

  • Explora desde los resultados de la consulta del Ejecutor de SQL
  • Explorar desde la lista de tablas del Ejecutor de SQL

Explora desde los resultados de consultas del Ejecutor de SQL

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. Eso te permite probar lo que devuelve la consulta y visualizar los resultados. Se puede usar para cualquier consulta, pero es especialmente útil para probar las consultas que planeas usar en las tablas derivadas.

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

  1. Usa el Ejecutor de SQL para crear la consulta en SQL que deseas usar.
  2. Selecciona Explorar en el menú de ajustes ubicado en la esquina superior derecha. Esto te llevará a una nueva exploración, en la que podrás explorar la consulta en SQL como si fuera una tabla guardada en tu modelo.
  3. Puedes copiar la URL de esta exploración para compartirla.
  4. Para agregar esta consulta como una tabla derivada en tu proyecto directamente desde aquí, selecciona Agregar vista al proyecto.

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 modelado en el Ejecutor de SQL. Como se describe 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 para la tabla, puedes decidir si deseas agregarla a tu proyecto. También puedes usar la pestaña SQL de la pestaña Explorar para ver las consultas en SQL que envía Looker a la base de datos y, luego, usar el botón Abrir en el ejecutor de SQL para volver a incluir la consulta en el 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 la exploración.
  4. Looker proporciona un campo de dimensión para cada columna de la tabla. (de la misma forma en que Looker genera un modelo al inicio de un proyecto).
  5. Looker incluye automáticamente períodos para cualquier campo de fecha.
  6. Looker también incluye una medida de recuento.

Cuando se usa la opción Explorar tabla, no hay un archivo de LookML asociado con la Exploración, sino que es solo una vista ad hoc de la tabla.

Depurar mediante el Ejecutor de SQL

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

Destacado de errores del Ejecutor 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 de caracteres del error. Otros dialectos de bases de datos pueden tener uno de estos comportamientos u otros.

El Ejecutor de SQL también destaca la ubicación del primer error de sintaxis en el comando de SQL subrayándolo en rojo y marcando la fila con una x. Coloca el cursor sobre la x para ver más información del error. Después de solucionarlo, selecciona Ejecutar para ver si hay más errores en la consulta.

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

Si encuentras errores de sintaxis SQL en una exploración, puedes usar el Ejecutor de SQL para determinar la ubicación del error y su tipo, como errores ortográficos 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.

Con esta acción, se copia el SQL generado por la exploración en el ejecutor de SQL. Como se muestra antes, el Ejecutor de SQL destaca la ubicación de los errores en el comando de SQL y también incluye la posición del error en el mensaje de error. Luego, 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 las tablas derivadas

Si quieres obtener información sobre el uso del Ejecutor de SQL para verificar los 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.