Cómo administrar funciones de base de datos con SQL Runner

El Ejecutor de SQL brinda una forma de acceder directamente a tu base de datos y usar ese acceso de varias maneras. Con el Ejecutor de SQL, puedes navegar por las tablas de tu esquema, usar una exploración ad hoc desde una consulta en SQL, ejecutar consultas descriptivas preescritas en tus datos, ver tu historial del Ejecutor de SQL, descargar resultados, compartir consultas, agregar 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 el Ejecutor de SQL, ver el plan de ejecución de tu base de datos para una consulta con la instrucción EXAMINE y cómo usar el Ejecutor de SQL 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 el Ejecutor de SQL para crear consultas y exploraciones
• Cómo usar el Ejecutor de SQL para crear tablas derivadas

Cómo modificar el esquema y los datos de la base de datos

Además de ejecutar consultas en tu base de datos, la pestaña Base de datos del Ejecutor de SQL te permite ejecutar instrucciones del lenguaje de definición de datos (DDL) y del lenguaje de manipulación de datos (DML) en tu base de datos. Puedes usar el Ejecutor de SQL para realizar cambios en el esquema (como crear, descartar y modificar) y cambios en los datos (como insertar, actualizar y borrar). Los dialectos de SQL tienen diferentes compatibilidades 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.

Nota: En el caso de las conexiones de Google BigQuery que usan credenciales de OAuth de solo lectura, los usuarios no pueden usar el Ejecutor de SQL para ejecutar operaciones de escritura en la base de datos. En el caso de otras conexiones de bases de datos, Looker no controla la autorización de qué instrucciones de SQL puede ejecutar un usuario en tu base de datos. Los usuarios de Looker con el permiso use_sql_runner tienen acceso al Ejecutor de SQL, pero el Ejecutor de SQL no limita los comandos que el usuario puede ejecutar. Si el administrador de la base de datos quiere evitar que los usuarios del Ejecutor de SQL modifiquen el esquema de la base de datos, debe hacerlo configurando los permisos de usuario para la base de datos.

Para ejecutar una instrucción DDL o DML en tu base de datos en el Ejecutor de SQL, sigue estos pasos:

1. Navega al Ejecutor de SQL.
2. En el Ejecutor de SQL, haz clic en la pestaña Base de datos.
3. Ingresa la instrucción 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 instrucciones DDL y DML).
4. Haz clic en Ejecutar para ejecutar la instrucción en tu base de datos.

Si la instrucción se ejecuta correctamente en tu base de datos, el cuadro 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 el Ejecutor de SQL 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, devuelve el plan de ejecución de la base de datos para una consulta.

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

2. En la pestaña SQL de la exploración, haz clic en el botón Explicar en el Ejecutor de SQL.

   Looker abrirá el Ejecutor de SQL y cargará la consulta dentro de una función EXPLAIN.

3. En el Ejecutor de SQL, haz clic en Ejecutar para ejecutar la función EXPLAIN.

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

En el ejemplo anterior de MySQL, la función EXPLAIN devuelve una lista de los pasos que realiza la base de datos para completar la consulta. Esto puede ser útil para las consultas que parecen ejecutarse con lentitud, 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 el Ejecutor de SQL para optimizar SQL, consulta la publicación de Comunidad Cómo optimizar SQL con EXPLAIN .

Cómo obtener información sobre tu base de datos

La pestaña Base de datos del Ejecutor de SQL tiene varias herramientas para brindarte información sobre tu base de datos.

Cómo obtener información de la conexión de la base de datos

Cuando eliges una conexión en el Ejecutor de SQL, Looker muestra el dialecto de la base de datos para esa conexión a la derecha del banner CONSULTA DE SQL. Si navegaste al Ejecutor de SQL eligiendo Abrir en el Ejecutor de SQL o Explicar en el Ejecutor de SQL, 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 engranaje de conexión para obtener más opciones para la conexión de la base de datos:

• Selecciona la opción Mostrar procesos para mostrar información sobre las consultas y los procesos que se ejecutan actualmente en la conexión.
• Selecciona la opción Actualizar esquemas y tablas para volver a propagar el panel de navegación izquierdo del Ejecutor de SQL con los esquemas y las tablas de la base de datos.

Opciones del menú de engranaje 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 engranaje. El elemento de menú cambia entre Mostrar proyectos disponibles y Buscar proyectos públicos, según la opción seleccionada.

• Selecciona Actualizar esquemas y tablas para volver a propagar el panel de navegación izquierdo del Ejecutor de SQL con los esquemas y las tablas de la base de datos.
• Cuando se muestran los proyectos disponibles, hay una opción de menú de engranaje 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 engranaje para Mostrar proyectos disponibles. Selecciona esta opción para revertir la visualización a los proyectos y las tablas de BigQuery específicos de la conexión en el panel de navegación izquierdo del Ejecutor de SQL.

Cómo buscar en tu base de datos

El Ejecutor de SQL muestra un cuadro de búsqueda debajo del esquema seleccionado (o conjunto de datos, para las conexiones de Google BigQuery).

La búsqueda del Ejecutor de SQL explora los nombres de todas las tablas y las columnas de la tabla que contienen la cadena en el cuadro de búsqueda. En la siguiente figura, “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 el Ejecutor de SQL.

Obtén información de las tablas

De forma predeterminada, el Ejecutor de SQL precarga 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 del Ejecutor de SQL 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 un nombre de tabla para ver los campos de esa tabla.

El Ejecutor de SQL tiene algunas consultas preescritas para ayudarte a comprender tus datos. Para usar estas consultas, haz clic en el engranaje que aparece junto al nombre de una tabla o columna de tabla y selecciona la consulta que deseas ejecutar. Looker genera el SQL automáticamente en la sección Consulta de 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 engranaje junto al nombre de una tabla:

• Explorar tabla: Abre una nueva pestaña del navegador a 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 manera de tener una idea de cómo se ven realmente los datos.
• Recuento: Devuelve una consulta count(*) simple para obtener el recuento total de filas de la tabla.

Información de la columna

Haz clic en un nombre de tabla para ver las columnas de la tabla. Looker muestra las siguientes opciones cuando haces clic en el engranaje junto al nombre de una columna:

• Valores más comunes: Devuelve una consulta de los valores más comunes para 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 del tipo de datos de la columna

Puedes usar el Ejecutor de SQL para obtener información del tipo de datos de la columna. Para ello, sigue estos pasos:

1. En el Ejecutor de SQL, selecciona la conexión de la base de datos en el menú desplegable Conexión.
2. Selecciona el esquema en el menú desplegable Esquema. (Para las conexiones de BigQuery, selecciona Proyecto y Conjunto de datos).
3. El Ejecutor de SQL 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.
4. Cada nombre de columna tiene un ícono para representar el tipo de datos. Coloca el cursor sobre un nombre de columna para ver el tipo de datos de esa columna.

Cómo editar las consultas de SQL precompiladas

Puedes editar cualquier consulta en SQL en el área Consulta, incluidas las consultas de SQL preestablecidas que se eligen en los menús de engranaje de la tabla y el campo.

Por ejemplo, puedes usar la consulta Recuento del Ejecutor de SQL 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 de 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 devuelve un recuento de 1 para cada valor id, es probable que id sea la clave primaria de esta tabla. Sin embargo, esta consulta especifica solo 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 id como clave primaria, te recomendamos que implementes restricciones en tu base de datos para garantizar que tus claves primarias sean únicas.