El ejecutor de SQL proporciona una forma de acceder directamente a la base de datos y aprovechar ese acceso de varias maneras. Con SQL Runner, puede navegar fácilmente por las tablas de su esquema, usar una exploración ad hoc de una consulta en SQL, ejecutar consultas descriptivas predefinidas en sus datos, ver su historial de SQL Runner, 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 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
- Usa SQL Runner para crear consultas y exploraciones
- Administra funciones de bases de datos con el ejecutor de SQL
Agrega una consulta de ejecutor de SQL a un proyecto de LookML
El ejecutor de SQL es un lugar excelente para probar SQL para usarlo como tabla derivada en tu proyecto de LookML. Incluso puede obtener una consulta en SQL desde otra herramienta, probarla en el ejecutor de SQL y agregarla a su proyecto de LookML.
Una vez que creó una consulta en SQL en SQL Runner, puede crear una tabla derivada a partir de la consulta con las opciones Add to Project o Get Derived Table LookML. Ambas opciones te permiten realizar una consulta en el ejecutor de SQL y agregarlas a tu proyecto de LookML. Consulta las siguientes secciones para obtener más información.
Agregar al proyecto
La opción Add to Project es la forma más sencilla de agregar una consulta de SQL Runner a tu proyecto:
La opción Add to Project le permite seleccionar un proyecto de LookML y, luego, Looker crea automáticamente un archivo de vista con la consulta en el proyecto seleccionado. Si, por el contrario, prefiere crear el archivo de vista de forma manual y agregar el LookML de la consulta usted mismo, puede 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 desees usar en una tabla derivada.
- Haga clic en Add to Project en el menú de ajustes en la parte superior derecha.
- Selecciona el proyecto al que deseas agregar esta tabla derivada.
- Ingrese un nombre de vista para la tabla derivada.
- Haga clic en Agregar para agregar la consulta como una tabla derivada a su proyecto. Looker cambiará al modo de desarrollo si aún no lo hizo, creará un nuevo archivo de vista con LookML desde la consulta del ejecutor de SQL y, luego, abrirá el navegador de archivos IDE.
- Mueva el archivo para que se ajuste a la organización de su proyecto.
- Valida el LookML y, luego, implementa los cambios en la fase de producción.
Obtener LookML de tablas derivadas
Otra forma de crear una tabla derivada a partir de su consulta de SQL Runner es usar la opción Get Derivar Table LookML del menú de ajustes del ejecutor de SQL. Al igual que con la opción Agregar al proyecto, Looker proporcionará el LookML necesario para convertir su consulta en SQL en una tabla derivada. Desde allí, puede copiar el LookML para pegarlo usted mismo en su proyecto, lo cual es útil si desea reemplazar una tabla derivada existente.
Para crear una tabla derivada a partir de una consulta de SQL Runner, haz lo siguiente:
- Usa SQL Runner para crear una consulta en SQL que desees usar en una tabla derivada.
- Haga clic en el menú de ajustes y seleccione Obtener aspecto de tabla derivada.
En la ventana emergente Get Derived Table LookML, haga clic en el vínculo Add it to your project.
Usa la lista desplegable Proyecto para elegir el proyecto al que deseas agregar la tabla derivada.
Ingrese 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 obtener información sobre las convenciones de nombres de archivos.
Haz clic en el botón Agregar. Looker cambiará al modo de desarrollo si aún no lo hizo, creará un nuevo archivo de vista con LookML desde la consulta del ejecutor de SQL y, luego, abrirá el navegador de archivos IDE.
Mueva el archivo para que se ajuste a la organización de su proyecto.
Valida el LookML y, luego, implementa los cambios en la fase de producción.
Depura 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.
Destacado de error 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.
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 de carácter del error. Otros dialectos de la base de datos pueden tener uno u otros comportamientos.
El ejecutor de SQL también destaca la ubicación del primer error de sintaxis en el comando de 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 corregir 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 copiando la instrucción de SQL en SQL Runner y probando diferentes partes de SQL para acotar la ubicación del error. Si deseas obtener más información, consulta la publicación Usa SQL Runner para probar tablas derivadas de la comunidad de Looker.