Usa SQL Runner para crear consultas y Exploraciones

SQL Runner 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 de tu esquema, usar una exploración ad hoc desde una consulta de SQL, ejecutar consultas descriptivas escritas previamente en tus datos, ver tu historial de SQL Runner, descargar resultados, compartir consultas, agregarlas 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 SQL Runner, crear Exploraciones ad hoc y cómo usar SQL Runner para depurar consultas. Consulta estas otras páginas de documentación para obtener información sobre lo siguiente:

Ejecuta consultas en SQL Runner

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.

Cómo escribir una consulta en SQL desde cero

Puedes usar SQL Runner para escribir y ejecutar tus propias consultas de SQL en tu base de datos. Looker pasa tu consulta a la 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 de SQL en el cuadro de texto debajo de la barra Consulta.
  2. De manera opcional, selecciona un nombre de tabla o un campo de la lista de campos para incluirlo 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. SQL Runner cargará hasta 5,000 filas del conjunto de resultados de la consulta. En el caso de los dialectos de SQL que admiten transmisión, puedes descargar los resultados para ver el conjunto de resultados completo.

Algunos programas de SQL te permitirán ejecutar varias consultas en una serie. Sin embargo, solo puedes ejecutar una consulta a la vez en SQL Runner. SQL Runner también tiene un límite de 65,535 caracteres en las consultas, incluidos los espacios en blanco.

Después de ejecutar una consulta, puedes agregarla a un proyecto, obtener el código LookML de una tabla derivada o compartirla.

También puedes usar SQL Runner para probar consultas nuevas o existentes. El destacado de errores de SQL Runner ayuda a probar y depurar consultas.

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

También puedes usar una exploración para crear una consulta y, luego, obtener el comando SQL de esa consulta para usarlo en SQL Runner:

  1. En una exploración, selecciona la pestaña SQL en la barra Datos.
  2. La consulta de SQL aparecerá debajo de la barra Datos.
  3. Selecciona Open in SQL Runner o Explain in SQL Runner para abrir la consulta en SQL Runner.

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.

Cómo crear visualizaciones con SQL Runner

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

Con la Visibilidad 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 consulta aparece en la parte inferior.

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

Ten en cuenta lo siguiente sobre el funcionamiento de 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 la visualización. Por lo tanto, la opción Show Full Field Name en el menú Settings está inactiva.
  • Para usar campos personalizados, cálculos de tablas, pivotes, totales de columnas y subtotales, explora desde tu consulta de SQL Runner.
  • Las visualizaciones de SQL Runner no admiten visualizaciones de mapas estáticos (regiones), pero sí las de mapas que usan datos de latitud y longitud (visualizaciones de mapas y mapas estáticos (puntos)).
  • Las visualizaciones de SQL Runner no son compatibles con las visualizaciones de cronograma.

Dimensiones de cambio

Puedes editar los resultados de la consulta para realizar un giro por una o más dimensiones en las visualizaciones de SQL Runner. Para pivotar 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 Convertir la columna en dinámica.

Los resultados pivotados se muestran en la visualización de SQL Runner.

Los resultados en el área Resultados no aparecen pivotados.

Para despivotar los resultados, selecciona el menú de ajustes de la columna pivotada y, luego, Despivotar columna.

Cómo cambiar el tipo de campo

Cuando se muestran los resultados y la visualización de tu consulta, SQL Runner interpreta automáticamente cualquier campo numérico como una medida y cualquier campo no numérico como una dimensión. Para anular el tipo de campo predeterminado y convertir una dimensión en una métrica, o viceversa, 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 Convertir a dimensión o Convertir a métrica 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 SQL Runner para escribir y ejecutar consultas de SQL en un modelo de LookML, en lugar de hacerlo directamente en tu base de datos. Cuando crees tu consulta en 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 crea una consulta para solucionar problemas de una tabla derivada, por ejemplo.

Looker resuelve cualquier sustitución de LookML y, luego, pasa la consulta a tu base de datos, por lo que la consulta debe estar en SQL válido 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.

Para ejecutar una consulta en tu modelo de LookML en SQL Runner, sigue estos pasos:

  1. Selecciona la pestaña Modelo.
  2. Selecciona el modelo que deseas consultar.
  3. En el cuadro de texto debajo de la barra Data, ingresa tu consulta de SQL con campos de LookML.
  4. De manera opcional, selecciona una vista en la lista de vistas para incluirla en tu consulta en la ubicación del cursor.
  5. Para ver la lista de campos de una vista, selecciónala en la sección Views. De forma opcional, puedes seleccionar un campo en 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 se hayan traducido a SQL las sustituciones de LookML.
  7. Selecciona Ejecutar para ejecutar la consulta en tu modelo.
  8. Consulta los resultados en el área Resultados. SQL Runner carga 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.

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

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

Cómo ver el código LookML de un campo desde SQL Runner

En la lista de campos de la pestaña Modelo, también puedes ver el código 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 de SQL Runner

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

Para ver tu historial, selecciona la pestaña Historial en la parte superior del panel de navegación. SQL Runner 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ó porque se produjo un error.

Selecciona una consulta en el historial para propagarla en SQL Runner y, luego, selecciona Run para volver a ejecutarla.

Cómo ordenar tu consulta

El orden de una tabla se indica con una flecha hacia arriba o hacia abajo junto al nombre del campo ordenado, según si los resultados están en orden ascendente o descendente. Para ordenar por varias columnas, mantén presionada la tecla Mayúsculas y, luego, selecciona los encabezados de las columnas en el orden que quieras que aparezcan. El orden de clasificación de un campo también se indica con 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 clasificación (ascendente o descendente) y con 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 Ordenar datos de la página de documentación Explorar datos en Looker.

Cómo compartir consultas

Puedes compartir una consulta en SQL Runner con otro usuario que tenga acceso a SQL Runner. Para compartir una búsqueda, copia la URL en la barra de direcciones de tu navegador.

Descarga de resultados

Una vez que hayas ejecutado tu consulta de SQL, podrás descargar los resultados en varios formatos.

  1. Escribe una consulta en el cuadro Consulta SQL. (No es necesario que ejecutes la consulta en SQL Runner en este momento).
  2. Selecciona Descargar en el menú de ajustes que se encuentra en la parte 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 ventana del navegador nueva o Descargar para descargar los resultados en un archivo de tu computadora.

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

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

Cómo copiar valores de columna

Puedes copiar los valores de las columnas de 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 la columna en un archivo de texto, una hoja de cálculo de Excel o en otra ubicación.

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

También puedes mover, fijar y cambiar el tamaño de las columnas de la tabla de resultados de forma manual.

Estimaciones de costos para las consultas de SQL Runner

Para 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 de SQL, SQL Runner calculará la cantidad de datos que requerirá la consulta y mostrará la información cerca del botón Run.

En el caso de las conexiones a BigQuery, MySQL y Amazon RDS para MySQL, las estimaciones de costos siempre están habilitadas. Para las conexiones a 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 editarlas en la página Conexiones de la sección Base de datos del panel Administrador de Looker.

Cómo crear una exploración ad hoc

En SQL Runner, puedes obtener estadísticas rápidas sobre los datos creando una exploración ad hoc para una consulta de SQL o una tabla de base de datos. Puedes usar la función Explorar 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:

  • Explorar desde los resultados de la consulta de SQL Runner
  • Explorar desde la lista de tablas de SQL Runner

Exploración a partir de los resultados de la consulta de SQL Runner

SQL Runner te permite abrir una exploración a partir de una consulta en SQL. Esto crea una exploración temporal a partir de la consulta escrita en SQL Runner. Esto te permite probar lo que muestra la consulta y visualizar los resultados. Se puede usar para cualquier consulta, pero es especialmente útil para probar las consultas que planeas usar para las tablas derivadas.

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

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

Cómo crear campos personalizados mientras exploras en SQL Runner

Si tienes acceso a la función de campos personalizados, puedes usar campos personalizados para visualizar campos sin modelar en SQL Runner. 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 que aparece 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 abras una tabla de Explorar, podrás decidir si agregarla a tu proyecto. También puedes usar la pestaña SQL de Explorar para ver las consultas de SQL que Looker envía a la base de datos y, luego, usar el botón Open in SQL Runner para volver a llevar la consulta a SQL Runner.

  1. Selecciona la pestaña Base de datos.
  2. En SQL Runner, selecciona la rueda dentada de una tabla y, luego, Explorar tabla.
  3. Looker genera un modelo temporal con una vista para la tabla y, luego, muestra la función Explorar.
  4. Looker proporciona un campo de dimensión para cada columna de la tabla. (Esta es la misma forma en que Looker genera un modelo al comienzo 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 usas la opción Explorar tabla, no hay un archivo LookML asociado con la exploración; es solo una vista ad hoc de la tabla.

Depuración con SQL Runner

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

Destacado de errores del Ejecutor de SQL

SQL Runner destaca la ubicación de los errores en el comando SQL y, además, 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. Es posible que otros dialectos de base de datos tengan uno de estos comportamientos o algún otro.

SQL Runner también destaca la ubicación del primer error de sintaxis en el comando SQL. Para ello, lo subraya en rojo y marca la fila con una x. Mantén el puntero sobre la x para ver más información sobre el error. Después de corregir el problema, selecciona Run para ver si hay más errores en la consulta.

Usa SQL Runner para verificar errores en Exploraciones

Si encuentras errores de sintaxis de SQL en una exploración, puedes usar SQL Runner para determinar la ubicación y el tipo de error, como errores ortográficos o comandos faltantes.

  1. En Explorar, selecciona la pestaña SQL de la barra de datos.
  2. Selecciona Open in SQL Runner para abrir la consulta en SQL Runner.

Esto copia el SQL generado de Explorar en SQL Runner. Como se muestra en la sección Destacado de errores de SQL Runner, SQL Runner destaca la ubicación de los errores en el comando SQL y, además, incluye la posición del error en el mensaje. Luego, puedes realizar cambios y volver a ejecutar la consulta en SQL Runner hasta que corrijas los errores.

Cómo usar SQL Runner para verificar errores en tablas derivadas

Para obtener información sobre el uso de SQL Runner para verificar errores de SQL en tablas derivadas, consulta la publicación de la comunidad de Looker Cómo usar SQL Runner para probar tablas derivadas.