SQL Runner 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 crear una tabla derivada con SQL Runner y cómo usar SQL Runner 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 SQL Runner para crear consultas y Exploraciones
- Administra funciones de base de datos con SQL Runner
Cómo agregar una consulta de SQL Runner a un proyecto de LookML
SQL Runner es una excelente herramienta para probar SQL y usarlo como tabla derivada en tu proyecto de LookML. Incluso puedes obtener una consulta SQL de una herramienta diferente, probarla en SQL Runner y, luego, agregarla a tu proyecto de LookML.
Una vez que crees una consulta en SQL Runner, puedes crear una tabla derivada a partir de ella con la opción Agregar al proyecto o Obtener LookML de tabla derivada. Ambas opciones te permiten tomar una consulta en SQL Runner y agregarla a tu proyecto de LookML. Consulta las siguientes secciones para obtener información.
Agregar al proyecto
La opción Agregar al proyecto es la forma más fácil de agregar una consulta de SQL Runner 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 código de LookML de la consulta por tu cuenta, puedes usar la opción Get Derived Table LookML.
Sigue estos pasos para usar la opción Agregar al proyecto:
- Usa SQL Runner para crear una consulta en SQL que quieras usar para una tabla derivada.
- Haz clic en Agregar al proyecto en el menú de ajustes de 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 lo está, creará un nuevo archivo de vista con el LookML de la consulta de SQL Runner y, luego, abrirá el navegador de archivos del IDE en el nuevo archivo de vista.
- Mueve el archivo para que se adapte a la organización de archivos de tu proyecto.
- Valida LookML y despliega los cambios en producción.
Obtén LookML de tabla derivada
Otra forma de crear una tabla derivada a partir de tu consulta de SQL Runner es usar la opción Get Derived Table LookML del menú de ajustes de SQL Runner. Al igual que con la opción Agregar al proyecto, Looker proporcionará el código LookML necesario para convertir tu consulta de SQL en una tabla derivada. Desde allí, puedes copiar el código LookML para pegarlo en tu proyecto, lo que es útil si quieres reemplazar una tabla derivada existente.
Para crear una tabla derivada a partir de una consulta de SQL Runner, sigue estos pasos:
- Usa SQL Runner 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 Get Derived Table LookML, haz clic en el vínculo add it to your project.
Usa la lista desplegable Project 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 Cómo administrar archivos y carpetas de LookML para conocer las convenciones de nombres de archivos.
Haz clic en el botón Add. Looker cambiará al Modo de desarrollo si aún no lo está, creará un nuevo archivo de vista con el LookML de la consulta de SQL Runner y, luego, abrirá el navegador de archivos del IDE en el nuevo archivo de vista.
Mueve el archivo para que se adapte a la organización de archivos de tu proyecto.
Depuración con SQL Runner
SQL Runner también es una herramienta útil para verificar errores de SQL en la definición de una tabla derivada.
Destacado de errores del Ejecutor de SQL
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.
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.
SQL Runner también destaca la ubicación del primer error de sintaxis en el comando SQL. Para ello, lo subraya en rojo y marca la fila con una "x". Coloca el cursor sobre la "x" para ver más información sobre el error. Después de corregir el problema, haz clic en Ejecutar para ver si hay más errores en la consulta.
Cómo usar SQL Runner para probar tablas derivadas
Si ves un error que proviene de una tabla derivada, puedes determinar la causa del error copiando la sentencia SQL en SQL Runner y probando diferentes partes de la sentencia SQL para acotar la ubicación del error. Para obtener más información, consulta la publicación de la comunidad de Looker Cómo usar SQL Runner para probar tablas derivadas.