Cómo usar SQL Runner 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 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:

• Conceptos básicos de SQL Runner
• Cómo usar SQL Runner para crear tablas derivadas
• Administra las funciones de la base de datos con SQL Runner

Ejecuta consultas en SQL Runner

Para ejecutar una consulta en tu base de datos, puedes escribir la consulta de 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 el Ejecutor de SQL para escribir y ejecutar tus propias consultas en 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 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 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. 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 permiten ejecutar varias consultas en una serie. Sin embargo, solo puedes ejecutar una consulta a la vez en el Ejecutor de SQL. 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 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 SQL de esa consulta para usarlo en SQL Runner:

1. En una exploración, selecciona la pestaña SQL de 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 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 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á.

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 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 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 de cambio

Puedes editar los resultados de la consulta para dinamizar una o más dimensiones en las visualizaciones de SQL Runner. Para pivotar 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 pivotados.

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 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 construyas 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 tu consulta a la 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 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 consultas 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.

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

Cómo compartir consultas

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.

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 en SQL. (No es necesario que ejecutes la consulta en SQL Runner en este momento).
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. 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 columnas

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 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:

• Cómo inmovilizar y desbloquear
• Ajustar automáticamente el tamaño de todas las columnas
• Cómo restablecer todos los anchos de 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 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 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.

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

Hay 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 del ejecutor de SQL

Explora desde 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 devuelve la consulta, así como 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 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 describe en la sección anterior, selecciona Explorar en el menú de ajustes. Luego, en el selector de campos, sigue estos pasos:

• Selecciona la sección Campos personalizados para abrirla y, luego, elige Agregar para comenzar a crear una dimensión personalizada, una medida personalizada o un cálculo de tablas. (Si no tienes la sección Campos personalizados, no tienes acceso para crear campos personalizados).
• Selecciona el menú de tres puntos Más de una métrica y elige Filtrar métrica para crear una métrica personalizada filtrada a partir de una métrica existente.
• Selecciona el menú de tres puntos Más de una dimensión y elige un tipo de medición (como suma o recuento) para crear una medición personalizada a partir de una dimensión.

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 la función 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 un archivo LookML asociado con la exploración; es solo una vista ad hoc de la tabla.

Depura con el Ejecutor de SQL

SQL Runner también es una herramienta útil para verificar errores de SQL en las 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. Es posible que otros dialectos de base de datos tengan uno de estos comportamientos o algún otro.

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

Cómo usar el Ejecutor de SQL 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. A continuación, puedes realizar cambios y volver a ejecutar la consulta en el Ejecutor de SQL hasta que hayas corregido 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.