El Ejecutor de SQL proporciona acceso directo a la base de datos, que puedes usar para crear y depurar tablas derivadas para tus proyectos de LookML. Usa el Ejecutor de SQL para definir nuevas tablas derivadas y solucionar problemas con las existentes, lo que te ayudará a garantizar la exactitud de los datos y mejorar tu flujo de trabajo de desarrollo. En esta guía, se muestra cómo usar el Ejecutor de SQL para estas tareas.
En esta página, se describe cómo crear una tabla derivada con el Ejecutor de SQL y cómo usar el Ejecutor de SQL para depurar tablas derivadas. 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 administrar funciones de base de datos con el Ejecutor de SQL
Cómo agregar una consulta del Ejecutor de SQL a un proyecto de LookML
El Ejecutor de SQL es un excelente lugar para probar el SQL que se usará como una tabla derivada en tu proyecto de LookML. Incluso puedes obtener una consulta en SQL de otra herramienta, probarla en el Ejecutor de SQL y, luego, agregarla a tu proyecto de LookML.
Una vez que hayas creado una consulta en SQL en el Ejecutor de SQL, puedes crear una tabla derivada a partir de la consulta con la opción Agregar al proyecto o la opción Obtener LookML de tabla derivada. Ambas opciones te permiten tomar una consulta en el Ejecutor de SQL y agregarla a tu proyecto de LookML. Consulta las siguientes secciones para obtener información.
Agregar al proyecto
Usar la opción Agregar al proyecto es la forma más sencilla de agregar una consulta del Ejecutor de SQL a tu proyecto:
La opción Agregar al proyecto te permite seleccionar un proyecto de LookML y, luego, Looker crea automáticamente un archivo de vista con la consulta en el proyecto seleccionado. Si prefieres crear el archivo de vista de forma manual y agregar el LookML de la consulta, puedes usar la opción Obtener LookML de tabla derivada.
Sigue estos pasos para usar la opción Agregar al proyecto:
- Usa el Ejecutor de SQL para crear una consulta en SQL que quieras usar para una tabla derivada.
- Haz clic en Agregar al proyecto en el menú de ajustes en la esquina superior derecha.
- Selecciona el proyecto al que deseas agregar esta tabla derivada.
- Ingresa un nombre de vista para la tabla derivada.
- Haz clic en Agregar para agregar la consulta como una tabla derivada en tu proyecto. Looker cambiará al modo de desarrollo si aún no está en él, creará un archivo de vista nuevo con el LookML de la consulta del Ejecutor de SQL y, luego, abrirá el navegador de archivos del IDE en el archivo de vista nuevo.
- Mueve el archivo para que se adapte a la organización de archivos de tu proyecto.
- Valida el LookML e implementa los cambios en la producción.
Obtén LookML de tabla derivada
Otra forma de crear una tabla derivada a partir de tu consulta del Ejecutor de SQL es usar la opción Obtener LookML de tabla derivada en el menú de ajustes del Ejecutor de SQL. Al igual que con la opción Agregar al proyecto, Looker proporcionará el LookML necesario para convertir tu consulta en SQL en una tabla derivada. Desde allí, puedes copiar el LookML para pegarlo en tu proyecto, lo que es útil si deseas reemplazar una tabla derivada existente.
Para crear una tabla derivada a partir de una consulta del Ejecutor de SQL, haz lo siguiente:
- Usa el Ejecutor de SQL para crear una consulta en SQL que quieras usar para una tabla derivada.
- Haz clic en el menú de ajustes y selecciona Obtener LookML de tabla derivada.
En la ventana emergente Obtener LookML de tabla derivada, haz clic en el vínculo agregarla a tu proyecto.
Usa la lista desplegable Proyecto para elegir el proyecto al que deseas agregar la tabla derivada.
Ingresa un nombre para la vista nueva en el campo Nombre de la vista. Consulta la página Administra archivos y carpetas de LookML para conocer las convenciones de nomenclatura de archivos.
Haz clic en el botón Agregar. Looker cambiará al modo de desarrollo si aún no está en él, creará un archivo de vista nuevo con el LookML de la consulta del Ejecutor de SQL y, luego, abrirá el navegador de archivos del IDE en el archivo de vista nuevo.
Mueve el archivo para que se adapte a la organización de archivos de tu proyecto.
Depuración con el Ejecutor de SQL
El Ejecutor de SQL también es una herramienta útil para verificar errores de SQL en la definición de una tabla derivada.
Resaltado de errores del Ejecutor de SQL
El Ejecutor de SQL resalta la ubicación de los errores en el comando SQL y también 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 bases de datos pueden tener uno de estos o cualquier otro comportamiento.
El Ejecutor de SQL también resalta la ubicación del primer error de sintaxis en el comando SQL subrayándolo en rojo y marcando la fila con una "x". Coloca el cursor sobre la "x" para ver más información sobre el error. Después de solucionar ese problema, haz clic en Ejecutar para ver si hay más errores en la consulta.
Cómo usar el Ejecutor de SQL para probar tablas derivadas
Si ves un error que proviene de una tabla derivada, puedes determinar la causa del error copiando la instrucción de SQL en el Ejecutor de SQL y probando diferentes partes del SQL para reducir la ubicación del error. Para obtener más información, consulta la publicación de Comunidad de Looker sobre cómo usar el Ejecutor de SQL para probar tablas derivadas.