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 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 del ejecutor de SQL
- Usa SQL Runner para crear consultas y exploraciones
- Administra funciones de la base de datos con el ejecutor de SQL
Crea una tabla derivada a partir de una consulta
Existen varias formas de crear una tabla derivada a partir de una consulta en SQL Runner.
Agrega a un proyecto de LookML
SQL Runner es un excelente lugar para probar SQL de las tablas derivadas antes de agregarlas a tu modelo. Incluso puede obtener una consulta desde otra herramienta, probarla en SQL Runner y agregarla a su proyecto.
- Usa SQL Runner para crear una consulta de SQL que desees usar en una tabla derivada.
- Haga clic en Add to Project 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) y abrirá la nueva vista de tabla derivada en el proyecto seleccionado. Si seleccionaste un proyecto que usa el LookML basado en YAML anterior, Looker proporcionará la tabla derivada en LookML basado en YAML. Si seleccionaste un proyecto que usa New LookML, Looker proporcionará la tabla derivada en New LookML.
Obtén el LookML para una tabla derivada
Otra forma de crear una tabla derivada a partir de su consulta de SQL Runner es usar la opción Get Derived Table LookML del menú de engranaje del ejecutor de SQL. Al igual que con la opción Agregar al proyecto, Looker proporcionará el LookML necesario para convertir su consulta de SQL en una tabla derivada. Desde allí, puede copiar el LookML para pegarlo en su proyecto, lo que es útil si desea 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 de SQL que desees usar en una tabla derivada.
- Haga clic en el menú de ajustes y seleccione Get Derived Table LookML.
- Copie el LookML que se generó. Como alternativa, haz clic en add it to your project, elige el proyecto al que deseas agregar la tabla derivada y, luego, ingresa un nombre para la vista en View Name.
Si no agregaste la tabla derivada a tu proyecto haciendo clic en add it to your project, abre el proyecto y haz clic en + en la parte superior de la lista de archivos del proyecto en el IDE de Looker. También puedes hacer clic en el menú de una carpeta para crear el archivo dentro de la carpeta.
Elige Crear vista.
Looker muestra un cuadro vacío en la parte superior de su lista de vistas. Escribe el nombre de la nueva vista y presiona Intro. Looker admite el uso de caracteres en mayúsculas y minúsculas, números, guiones bajos y caracteres Unicode en los nombres de archivo. Si el nombre de tu archivo de vista incluye caracteres que no son compatibles con Looker, se reemplazarán por guiones bajos.
Looker abrirá la vista nueva.
Borre todo el contenido de la vista nueva y pegue la tabla derivada LookML que copió anteriormente.
Depura con el ejecutor de SQL
SQL Runner también es una herramienta útil para verificar errores de SQL en la definición de una tabla derivada.
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 probar tablas derivadas
Si ve un error que proviene de una tabla derivada, puede determinar la causa del error. Para ello, copie la instrucción de SQL en el ejecutor de SQL y pruebe diferentes partes de SQL para reducir la ubicación del error. Si desea obtener más información, consulte el tema Cómo usar el ejecutor de SQL para probar tablas derivadas en la comunidad de Looker.