SQL Runner proporciona una forma de acceder directamente a tu base de datos y usar ese acceso de varias maneras. Con SQL Runner, puedes navegar 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 modificar el esquema y los datos de tu base de datos con SQL Runner, ver el plan de ejecución de tu base de datos para una consulta con la sentencia EXAMINE y cómo usar SQL Runner para obtener información sobre tu base de datos. 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 consultas y Exploraciones
- Cómo usar SQL Runner para crear tablas derivadas
Modifica el esquema y los datos de la base de datos
Además de ejecutar consultas en tu base de datos, la pestaña Database de SQL Runner te permite ejecutar sentencias de lenguaje de definición de datos (DDL) y lenguaje de manipulación de datos (DML) en tu base de datos. Puedes usar SQL Runner para realizar cambios en el esquema (como crear, descartar y alterar) y en los datos (como insertar, actualizar y borrar). Los dialectos de SQL tienen una compatibilidad variable con las instrucciones DDL y DML, por lo que debes consultar la documentación de tu base de datos para saber qué instrucciones son compatibles.
Para ejecutar una sentencia DDL o DML en tu base de datos en SQL Runner, sigue estos pasos:
- Navega a SQL Runner.
- En SQL Runner, haz clic en la pestaña Database.
- Ingresa la sentencia DDL o DML en el cuadro Consulta del Ejecutor de SQL. (Consulta la documentación del dialecto de tu base de datos para conocer la compatibilidad y la sintaxis de las sentencias DDL y DML).
- Haz clic en Run para ejecutar la sentencia en tu base de datos.
Si la sentencia se ejecuta correctamente en tu base de datos, la casilla Resultados de SQL mostrará una confirmación.
Cómo examinar un plan de ejecución con EXPLAIN
Además de ejecutar consultas de SQL en tu base de datos, puedes usar SQL Runner para ejecutar una función EXPLAIN para una consulta. La función EXPLAIN, que es compatible con la mayoría de los dialectos de SQL, muestra el plan de ejecución de la base de datos para una consulta.
- En una exploración, ejecuta una consulta y haz clic en la pestaña SQL del área Datos para ver el comando SQL de la consulta.
En la pestaña SQL de Explorar, haz clic en el botón Explain in SQL Runner.
Looker abrirá SQL Runner y cargará la consulta dentro de una función
EXPLAIN.En SQL Runner, haz clic en Run para ejecutar la función
EXPLAIN.Consulta el resultado de la función
EXPLAIN.
La información y el formato exactos de la respuesta EXPLAIN dependerán de tu dialecto específico, por lo que debes consultar la documentación de tu dialecto para obtener información específica.
En el ejemplo anterior de MySQL, la función EXPLAIN muestra una lista de los pasos que realiza la base de datos para completar la consulta. Esto puede ser útil para las consultas que parecen lentas de ejecutar, ya que es posible que tu base de datos esté analizando una tabla completa en una consulta, cuando quizás la tabla podría usar un índice para mejorar el rendimiento.
Para ver un ejemplo paso a paso del uso de EXPLAIN en SQL Runner para optimizar SQL, consulta la publicación de la comunidad How to Optimize SQL with EXPLAIN
.
Cómo obtener información sobre tu base de datos
La pestaña Base de datos de SQL Runner tiene muchas herramientas para brindarte estadísticas sobre tu base de datos.
Cómo obtener información de la conexión a la base de datos
Cuando eliges una conexión en SQL Runner, Looker muestra el dialecto de la base de datos de esa conexión a la derecha del banner SQL QUERY. Si navegaste a SQL Runner eligiendo Open in SQL Runner o Explain in SQL Runner, Looker preselecciona la conexión adecuada y muestra el dialecto de la base de datos de la conexión.
Haz clic en el menú de ajustes de la conexión para obtener más opciones para la conexión a la base de datos:
- Selecciona la opción Show Processes para mostrar información sobre las consultas y los procesos que se están ejecutando en la conexión.
- Selecciona la opción Refresh Schemas & Tables para volver a propagar el panel de navegación izquierdo de SQL Runner con los esquemas y las tablas de la base de datos.
Opciones del menú de ajustes de BigQuery
Cuando eliges una conexión de BigQuery que admite varias bases de datos, Looker muestra opciones específicas del dialecto en el menú de ajustes. El elemento del menú cambia entre Mostrar proyectos disponibles y Buscar proyectos públicos, según la opción que se seleccione.
- Selecciona Refresh Schemas & Tables para volver a propagar el panel de navegación izquierdo de SQL Runner con los esquemas y las tablas que se encuentran en la base de datos.
- Cuando se muestran los proyectos disponibles, hay una opción de menú de ajustes para buscar proyectos públicos. Selecciona esta opción para buscar conjuntos de datos públicos que no sean visibles en el esquema de información.
- Cuando se muestran los proyectos públicos, hay una opción de menú de ajustes para mostrar los proyectos disponibles. Selecciona esta opción para volver a mostrar los proyectos y las tablas de BigQuery específicos de la conexión en el panel de navegación izquierdo de SQL Runner.
Cómo buscar en tu base de datos
SQL Runner muestra un cuadro de búsqueda debajo del esquema (o conjunto de datos, para las conexiones de Google BigQuery) seleccionado.
La búsqueda de SQL Runner explora los nombres de todas las tablas y columnas de tablas que contienen la cadena en el cuadro de búsqueda. En la siguiente imagen, “airport_name” es una columna y “airport_remarks” es una tabla.
Haz clic en uno de los resultados de la búsqueda para navegar a ese elemento en SQL Runner.
Obtén información de las tablas
De forma predeterminada, SQL Runner carga previamente toda la información de la tabla cuando seleccionas una conexión y un esquema. En el caso de las conexiones que tienen muchas tablas o tablas muy grandes, un administrador puede inhabilitar este comportamiento si anula la selección de la opción SQL Runner Precache en la página Conexiones.
El panel de navegación izquierdo de SQL Runner te permite navegar por los esquemas y las tablas de tus conexiones. Selecciona una conexión y un esquema para ver todas las tablas de ese esquema. Haz clic en el nombre de una tabla para ver los campos de esa tabla.
SQL Runner tiene algunas consultas escritas previamente para ayudarte a comprender tus datos. Para usar estas consultas, haz clic en el ícono de ajustes que aparece junto al nombre de una tabla o columna de tabla y selecciona la consulta que deseas ejecutar. Looker genera la SQL automáticamente en la sección Consulta en SQL y se ejecutará la consulta.
Las consultas disponibles variarán según el dialecto de la base de datos.
Información de la tabla
Looker muestra las siguientes opciones cuando haces clic en el ícono de ajustes junto al nombre de una tabla:
- Explorar tabla: Abre una nueva pestaña del navegador en una Exploración de Looker de la tabla.
- Describir: Muestra los nombres de las columnas en la tabla subyacente, así como sus tipos de datos.
- Mostrar índices: Muestra información sobre cómo se indexa la tabla.
- Seleccionar 10: Devuelve una consulta de las primeras diez filas de la tabla. Esta es una buena forma de tener una idea de cómo se ven los datos en realidad.
- Cantidad: Muestra una consulta
count(*)simple para obtener el recuento total de filas de la tabla.
Información de la columna
Haz clic en el nombre de una tabla para ver las columnas de la tabla. Looker muestra las siguientes opciones cuando haces clic en el ícono de ajustes junto al nombre de una columna:
- Valores más comunes: Devuelve una consulta de los valores más comunes de esa columna de la tabla, junto con un recuento de la cantidad de veces que se encuentra ese valor en la columna.
- Recuento aproximado de valores distintos: Muestra un recuento aproximado de la cantidad de valores distintos que se encuentran en la columna.
Cómo obtener información sobre el tipo de datos de una columna
Para usar SQL Runner y obtener información sobre el tipo de datos de una columna, sigue estos pasos:
- En SQL Runner, selecciona la conexión de la base de datos en el menú desplegable Connection.
- Selecciona el esquema del menú desplegable Esquema. (Para las conexiones de BigQuery, selecciona Proyecto y Conjunto de datos).
- SQL Runner muestra la lista de tablas de ese esquema en tu base de datos. Haz clic en una tabla para ver las columnas de esa tabla.
- Cada nombre de columna tiene un ícono para representar el tipo de datos. Coloca el cursor sobre el nombre de una columna para ver el tipo de datos que contiene.
Cómo editar las consultas en SQL precompiladas
Puedes editar cualquier consulta de SQL en el área Consulta, incluidas las consultas de SQL predeterminadas que se eligieron en los menús de ajustes de la tabla y el campo.
Por ejemplo, puedes usar la consulta Count de SQL Runner para cargar un comando de recuento básico para una base de datos y, luego, editar la consulta en SQL. Por lo tanto, si crees que la columna id en la tabla public.users podría ser una clave primaria, puedes validar que no haya valores duplicados editando la consulta de recuento de la siguiente manera:
SELECT id ,COUNT(*)
FROM public.users
GROUP BY 1
ORDER BY 2 DESC
LIMIT 10
Debido a que la consulta se ordena por el recuento antes de que los resultados se limiten a 10 filas, los resultados incluirán los valores de recuento más altos. Si esta consulta muestra un recuento de 1 para cada valor de id, es probable que id sea la clave principal de esta tabla. Sin embargo, esta consulta solo especifica las filas de la tabla en el tiempo de ejecución de la consulta. Dado que las inserciones futuras en la base de datos pueden descalificar a id como clave primaria, te recomendamos que implementes restricciones en la base de datos para asegurarte de que tus claves primarias sean únicas.