Usa SQL Runner para crear consultas y exploraciones

SQL Runner proporciona una forma de acceder directamente a la 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 de una consulta de SQL, ejecutar consultas descriptivas predefinidas en tus datos, ver tu historial de SQL Runner, descargar resultados, compartir consultas, agregar 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 usar SQL Runner para depurar consultas. Consulta estas otras páginas de documentación para obtener información sobre lo siguiente:

• Conceptos básicos del ejecutor de SQL
• Usa SQL Runner para crear tablas derivadas
• Administra funciones de la base de datos con el ejecutor de SQL

Ejecuta consultas en el ejecutor de SQL

Para ejecutar una consulta en su base de datos, puede escribir la consulta en SQL desde cero, usar Explorar 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 de SQL desde cero

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

1. Haga clic en el área de consulta de SQL y escriba su comando de SQL.
2. De manera opcional, puede hacer doble clic en el nombre o campo de la tabla para incluirlo en su consulta en la ubicación del cursor.
3. Haz clic en Ejecutar para ejecutar la consulta en tu base de datos.
4. Consulta los resultados en el área de resultados. El ejecutor de SQL cargará hasta 5,000 filas del conjunto de resultados de la consulta. Para los dialectos SQL que admiten la transmisión, puedes descargar los resultados a fin de ver el conjunto de resultados completo.

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

Cuando tenga una consulta que desee, puede agregarla a un proyecto, obtener el 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 de SQL

También puede usar Explorar para crear una consulta y, luego, obtener el comando de SQL de esa consulta para que se use en SQL Runner:

1. En Explorar, haga clic en la pestaña SQL de la barra Datos.
2. Selecciona el texto de la consulta de SQL y cópialo en SQL Runner.
3. Haz clic en Abrir en el ejecutor de SQL o en Explicación en el ejecutor de SQL para abrir la consulta en el ejecutor de SQL.

Una vez que se agrega una consulta al área de consulta de SQL de SQL Runner, puedes hacer clic en Ejecutar para consultar la base de datos. Como alternativa, puedes editar la consulta y, luego, ejecutar la nueva.

Crea visualizaciones con SQL Runner

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

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

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

Hay algunos aspectos que debes tener en cuenta sobre el funcionamiento de las visualizaciones del ejecutor de SQL:

• La tabla y la visualización de resultados 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 Mostrar nombre de campo completo en el menú Configuración está inactiva.
• Para usar campos personalizados, cálculos de tablas, pivotes, totales de columna y subtotales, explora desde tu consulta de SQL Runner.
• Las visualizaciones del mapa estático (regiones) no son compatibles con las visualizaciones del ejecutor de SQL. Sin embargo, los mapas que usan datos de latitud y longitud (visualizaciones de mapas y mapas estáticos [puntos]) son compatibles.
• Las visualizaciones del cronograma no son compatibles con las visualizaciones del ejecutor de SQL.

Dimensiones dinámicas

Puede editar los resultados de la consulta para pivotar en una o más dimensiones en las visualizaciones del SQL Runner. Para dinamizar un campo:

1. Haz clic en el menú de ajustes de una columna en el área Resultados para exponer las opciones de columna.
2. Haga clic en Columna dinámica.

Los resultados dinámicos se muestran en la visualización del ejecutor de SQL:

Los resultados del área Results no aparecen reorientados.

Para anular la dinamización de los resultados, haga clic en el menú de ajustes de la columna dinámica y seleccione Anular dinamización de columnas:

Cambiar el tipo de campo

Al mostrar 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 medida, o viceversa, de la siguiente manera:

1. Haz clic en el menú de ajustes de una columna en el área Resultados para exponer las opciones de columna.
2. Haga clic en Convertir a dimensión o Convertir a medida 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 creas tu consulta con un modelo, puedes usar operadores de sustitución de LookML, como ${view_name.field_name} o ${view_name.SQL_TABLE_NAME}. Esto puede, por ejemplo, ahorrar tiempo cuando construyas una consulta para solucionar problemas de una tabla derivada.

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

Para ejecutar una consulta en el modelo de LookML en el ejecutor de SQL, sigue estos pasos:

1. Haz clic en la pestaña Modelo.
2. Selecciona el modelo que deseas consultar.
3. Haga clic en el área de consulta de SQL y, luego, ingrese su consulta de SQL con los campos de LookML.
4. De manera opcional, haz doble clic en 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, haz clic en la vista en la sección Views. De manera opcional, puede hacer doble clic en un campo de la lista de campos para incluirlo en su consulta en la ubicación del cursor.
6. En el área Consulta de SQL preparada, puede ver la consulta de SQL resultante que se crea después de que se hayan traducido todas las sustituciones de LookML.
7. Haz clic en 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 SQL que admiten la transmisión, puedes descargar los resultados a fin de ver el conjunto de resultados completo.

Cuando tenga una consulta que desee, puede agregarla a un proyecto, obtener el LookML para una tabla derivada o compartir la consulta.

También puedes usar SQL Runner para jugar con consultas 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.

Visualización de un LookML de campo desde el ejecutor de SQL

En la lista de campos de la pestaña Modelo, también puede ver el LookML de un campo. Coloque el cursor sobre el campo en la lista y haga clic en 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 puede ver un historial reciente de todas las consultas que ejecutó en SQL Runner.

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

Haga clic en una consulta del historial para propagar esa consulta en SQL Runner y, luego, haga clic en Ejecutar para volver a ejecutarla:

Ordena tu consulta

El orden de clasificación de las tablas se indica con una flecha hacia arriba o hacia abajo junto al nombre del campo, según si los resultados están en orden ascendente o descendente. Para ordenar por varias columnas, mantenga presionada la tecla Mayúsculas y, luego, haga clic en los encabezados de las columnas en el orden en que desea que se ordenen. El orden de clasificación de un campo también se indica mediante un número que distingue su orden de comparación con el de otros campos, mediante una flecha junto al nombre del campo que muestra la dirección de orden (ascendente o descendente) y mediante una ventana emergente que aparece cuando pasas 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.

Consultas compartidas

Puedes compartir una consulta en SQL Runner con otro usuario con acceso de SQL Runner. Para compartir una consulta, simplemente copie la URL en la barra de URL:

Descargando resultados

Una vez que haya ejecutado su consulta de SQL, puede descargar los resultados en diversos formatos.

1. Escribe una consulta en el cuadro de Consulta de SQL. (por el momento, no necesitas ejecutar la consulta en el ejecutor de SQL).
2. Seleccione Descargar en el menú de ajustes en la esquina superior derecha.
3. Seleccione el formato de archivo de la descarga (archivo de texto, CSV, JSON, etc.).

4. Haga clic en Abrir en el navegador para ver los resultados en una nueva ventana del navegador o en Descargar para descargar los resultados en un archivo de su computadora.

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

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

Copia valores de columna

Puedes copiar valores de columna desde la sección Resultados de SQL Runner. Haz clic en el menú de ajustes de una columna para copiar los valores en el portapapeles. Desde allí, puede pegar los valores de la columna en un archivo de texto, en un documento de Excel o en otra ubicación.

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

• Congelar y desbloquear
• Ajustar automáticamente el tamaño de todas las columnas
• Restablecer el ancho de todas las columnas

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

Estimaciones de costos para las consultas de SQL Runner

En cuanto a 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 BigQuery, MySQL y Amazon RDS para conexiones de MySQL, las estimaciones de costos siempre están habilitadas. En cuanto a 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 Cost Estimate para 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 Database del panel Administrador de Looker.

Crear una exploración ad hoc

Desde SQL Runner, puede obtener estadísticas rápidas sobre los datos mediante la creación de una exploración ad hoc para una consulta de SQL o una tabla de base de datos. Puede usar Looker Explore para seleccionar campos, agregar filtros, visualizar los resultados y crear consultas de SQL.

Hay dos formas de abrir una exploración ad hoc desde SQL Runner:

• Explorar de los resultados de consulta 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 de SQL. Esto crea una exploración temporal a partir de la consulta escrita en SQL Runner. Esto le permite probar lo que muestra la consulta y visualizar los resultados. Se puede usar para cualquier consulta, pero es especialmente útil a fin de probar consultas que planeas usar para tablas derivadas.

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

1. Usa SQL Runner para crear la consulta de SQL que deseas usar.
2. Haga clic en Explorar en el menú de ajustes en la esquina superior derecha. Esto lo lleva a una nueva Explorar, en la que puede explorar la consulta de SQL como si fuera una tabla guardada en su modelo.
3. Puedes copiar la URL en Explorar para compartirla.
4. Para agregar esta consulta como una tabla derivada a tu proyecto directamente desde aquí, haz clic en 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 usar campos personalizados para visualizar campos sin modelar en SQL Runner. Como se describió en la sección anterior, haga clic en Explorar en el menú de ajustes. Luego, en el selector de campos:

• Haga clic en la sección Campos personalizados para abrirla y, luego, haga clic en Agregar a fin de comenzar a crear una dimensión personalizada, una medida personalizada o un cálculo de la tabla. (Si no tienes la sección Campos personalizados, no tienes acceso para crear campos personalizados).
• Haga clic en el menú Opciones de tres puntos de una medición](/exploring-data/exploring-data#three-dot_options_menu) y elija Filtrar medida para crear una medida personalizada filtrada de una medida existente.
• Haga clic en el menú Opciones de tres puntos de una dimensión y elija un tipo de medida (como suma o recuento) para crear una medida personalizada a partir de una dimensión.

Explore 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 de cualquier tabla en la conexión. Esto te permite usar Looker en una tabla antes de modelarla y explorarla como una vista de LookML.

Una vez que abre la pestaña Explorar, puede decidir si desea agregar la tabla a su proyecto. También puede 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 Abrir en el ejecutor de SQL para que la consulta vuelva a ejecutarse.

1. Haz clic en la pestaña Base de datos.
2. En SQL Runner, haz clic en el ícono de ajustes de una tabla y selecciona Explorar tabla.
3. Looker genera un modelo temporal con una vista para la tabla y, luego, muestra la pestaña Explorar.
4. Looker proporciona un campo de dimensión para cada columna de la tabla. (de la misma manera 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 utiliza la opción Explorar tabla, no hay ningún archivo LookML asociado con Explorar, sino que solo es 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.

Destacar errores del ejecutor de SQL

El ejecutor de SQL destaca la ubicación de los errores en el comando de 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. Otros dialectos de la base de datos pueden tener uno u otros comportamientos.

SQL Runner también destaca la ubicación del primer error de sintaxis en el comando de SQL; para ello, lo subraya en rojo y marca la fila con un "x". Desplaza el cursor sobre el "x" para ver más información sobre el error. Después de solucionar ese problema, haga clic en Ejecutar para ver si hay más errores en la consulta.

Usa SQL Runner para verificar errores en Explorar

Si encuentras errores de sintaxis de SQL en Explorar, 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, haga clic en la pestaña SQL de la barra de datos.
2. Haz clic en Abrir en SQL Runner para abrir la consulta en SQL Runner.

Esto copia el SQL generado de Explorar en el ejecutor de SQL. Como se mostró antes, SQL Runner 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, puede realizar cambios y volver a ejecutar la consulta en SQL Runner hasta que haya corregido los errores.

Usa SQL Runner para verificar errores en tablas derivadas

Si desea obtener información sobre el uso de SQL Runner para verificar errores de SQL en tablas derivadas, consulte el artículo Usa SQL Runner para probar tablas derivadas en la comunidad de Looker.