Descripción general del IDE de Looker

El IDE de Looker (entorno de desarrollo integrado) proporciona acceso a los archivos de tu proyecto de LookML y a la configuración de tu proyecto de LookML.

Accede al IDE de Looker

Para ver un proyecto de LookML, debes tener el permiso develop en al menos un modelo del proyecto. Puedes acceder al IDE de Looker a través del panel Desarrollar del menú de navegación principal de Looker:

1. Selecciona Develop en el panel de navegación para abrir el panel Develop.
2. En el panel Develop, selecciona el nombre del proyecto al que deseas acceder.

Looker abrirá el IDE en el proyecto de LookML que seleccionaste.

Como alternativa, puedes abrir el IDE en objetos específicos de LookML desde una exploración o desde el navegador de objetos. Consulta Cómo acceder a archivos de proyectos para obtener detalles y otras opciones.

Elementos del IDE de Looker

El IDE de Looker tiene los siguientes elementos:

1. Banner del modo de desarrollo: Este banner indica que estás en el modo de desarrollo, en el que puedes realizar cambios en los archivos de LookML y obtener una vista previa de cómo afectarán el contenido de tu instancia. Puedes hacer clic en el vínculo Exit Development Mode del banner para ingresar al Modo de producción.
2. Barra de navegación del IDE: Usa la barra de navegación para acceder a diferentes funciones del IDE de Looker. Algunas de las funciones solo están disponibles cuando estás en Modo de desarrollo. Una vez que selecciones una función de la barra de navegación del IDE, puedes seleccionar el elemento de la barra de navegación por segunda vez para contraer el panel de funciones. La barra de navegación del IDE proporciona acceso a las siguientes funciones del IDE:
   • Navegador de archivos: Abre el navegador de archivos, que te da acceso a los archivos y carpetas de tu proyecto de LookML.
   • Navegador de objetos: Abre el navegador de objetos, que muestra los objetos de LookML en tu proyecto y las relaciones jerárquicas entre ellos.
   • Buscar y reemplazar: Muestra los botones Buscar y La página Reemplazar en el proyecto, que puedes usar para buscar texto en todos los archivos de tu proyecto y, luego, reemplazar todas las instancias o las instancias seleccionadas de una operación masiva.
   • Acciones de Git (visibles solo en el modo de desarrollo): Muestra las ramas de Git de tu proyecto y los comandos de Git disponibles para la rama de Git del proyecto. Consulta la página de documentación Implementa y usa el control de versión para obtener información sobre cómo usar Git con tu proyecto de LookML.
   • Settings (solo visible en el Modo de desarrollo): Muestra las páginas de configuración de tu proyecto en las que puedes configurar las opciones de control de versión del proyecto, las credenciales de autenticación para los proyectos importados, las ramas de Git que usa tu proyecto y la configuración del IDE.
   • Implementar: (Solo visible en el modo de desarrollo) En el caso de los proyectos configurados con el modo de implementación avanzado, abre el Administrador de implementaciones, en el que los desarrolladores que tienen el permiso deploy pueden implementar una confirmación o etiqueta en su entorno de producción de Looker.
3. Panel de funciones: Proporciona navegación para los archivos y objetos de LookML para el navegador de archivos y el navegador de objetos, parámetros de búsqueda para la función de buscar y reemplazar, comandos de Git disponibles para el panel Git Actions y pestañas para acceder a diferentes parámetros de configuración del panel de configuración del proyecto.
4. Panel del editor de IDE: Es el editor de archivos de LookML. El editor se muestra cuando se selecciona el navegador de archivos o el navegador de objetos en la barra de navegación del IDE. Consulta Funciones de edición del IDE de Looker para obtener más información sobre el editor.
5. Selector del panel lateral: haz clic en una opción para abrir las funciones del panel lateral del IDE:
   • Project Health: Abre el panel Project Health.
   • Ayuda rápida: Abre el panel Ayuda rápida, que incluye una pestaña para acceder al panel Metadatos. Vuelve a hacer clic en la opción del selector del panel lateral para ocultar el panel lateral del IDE.
6. Panel lateral del IDE: Muestra la función del panel lateral seleccionada:
   • Estado del proyecto: Te permite verificar si hay PDT no compiladas o validar tu LookML. Si tus desarrolladores de LookML definieron pruebas de datos para verificar la lógica del LookML del proyecto, también puedes ejecutar pruebas de datos desde el panel Estado del proyecto.
   • Ayuda rápida: Muestra las opciones de LookML que se aplican a la ubicación del cursor en un archivo de LookML y proporciona un vínculo a la documentación de referencia de Looker para cada parámetro de LookML.
   • Metadatos: Proporciona información contextual relevante sobre el objeto de LookML en la ubicación del cursor.
7. Botón de Git: Según el estado de tu proyecto, el botón muestra la siguiente acción que debes realizar para que tu proyecto pase a producción, como Validate LookML, Push Branch to Remote o Commit. Haz clic en el botón para realizar la acción. Consulta la referencia de comandos de Git para ver los posibles comandos que puede mostrar y ejecutar el botón.

Configura el IDE de Looker

Para el IDE de Looker, puedes personalizar el modo de editor de texto y el modo de ajuste de línea, y puedes contraer los paneles laterales del IDE para maximizar el ancho del editor en la ventana.

Modos de editor de texto

El IDE de Looker admite tres modos de editor de texto:

• Editor de IDE de Looker (predeterminado)
• Vim
• Emacs

Para cambiar el modo de editor de texto, sigue estos pasos:

1. Selecciona el ícono de Configuración del panel de navegación izquierdo en el IDE de Looker.
2. Selecciona la pestaña Editor en Configuración de IDE.
3. Utiliza el menú desplegable Modo de editor de texto para seleccionar tu opción.

Una vez que selecciones una opción del menú desplegable, el IDE de Looker se actualizará de inmediato para usar el modo de editor de texto seleccionado.

Modo de ajuste de línea

De forma predeterminada, el IDE de Looker está habilitado para el ajuste de líneas.

Para habilitar o inhabilitar el saltos de línea, haz lo siguiente:

1. Selecciona el ícono de Configuración del panel de navegación izquierdo en el IDE de Looker.
2. Selecciona la pestaña Editor en la Configuración del IDE.
3. Usa el botón de activación Modo de ajuste de línea para habilitar o inhabilitar el ajuste de línea en el IDE.

Una vez que cambies el botón de activación, la actualización se aplicará al IDE de Looker.

Contrae los paneles laterales del IDE

Si quieres maximizar el ancho del panel del editor del IDE, puedes contraer los paneles laterales del IDE:

• Para ocultar o mostrar el panel de funciones del IDE, utiliza la combinación de teclas Command + B (Mac) o Ctrl + B (Windows), o bien haz clic en un ícono de la barra de navegación del IDE que ya esté seleccionado.
• Para ocultar o mostrar el panel lateral del IDE, haz clic en un ícono del selector del panel lateral que ya esté seleccionado.

Funciones de edición del IDE de Looker

En las siguientes secciones, se describen algunas de las funciones de edición del IDE de Looker que pueden ayudarte a desarrollar en LookML:

• Sugerencia automática
• Verificación de errores ad hoc
• Formato automático
• Plegado
• Cómo escribir comentarios
• Cómo ver las incorporaciones, los cambios y las eliminaciones
• Persistencia del estado del IDE
• Ir al objeto o archivo

Sugerencia automática

A medida que escribes, el IDE sugiere posibles parámetros y valores que son sensibles al contexto de lo que estás escribiendo. Por ejemplo, las sugerencias para el parámetro type de una dimensión solo incluirán opciones válidas para ese parámetro. Además, los campos en los parámetros sql deben marcarse con ${...}, por lo que el IDE agrega esa sintaxis cuando sugiere campos.

Las sugerencias automáticas aparecen automáticamente siempre que puedan mostrarse. Para cerrarla, presiona la tecla Esc en el teclado. Para verlo en cualquier momento, presiona Ctrl + Espacio (Windows) o Control + Espacio (Mac).

Verificación de errores ad hoc

El IDE detecta errores de sintaxis a medida que escribes. Una X roja en el margen indica un error de sintaxis, el cual está subrayado en rojo. Cuando coloques el cursor sobre la X roja, aparecerá una breve descripción del problema. Por ejemplo, si escribes avrage en lugar de average como el valor del parámetro type para una medida, el IDE muestra el error Invalid value for "type":avrage.

Aún se necesita el validador de LookML para realizar una validación completa del modelo. Algunos errores, como una referencia de campo no válida causada por una unión faltante, requieren una visión integral del modelo y, por lo tanto, solo se muestran cuando se ejecuta el validador de LookML.

Formato automático

Cuando estás en el modo de desarrollo, puedes usar la combinación de teclas para dar formato al archivo para aplicar sangría automáticamente a tu archivo LookML. La sangría indica la jerarquía de los parámetros y subparámetros, lo que hace que LookML sea más fácil de leer y comprender.

Plegable

Aparece una pequeña flecha en el margen junto al inicio de cada parámetro de LookML de nivel superior en el archivo. Si seleccionas esta flecha, se pliega o despliega esa sección de LookML para que puedas enfocarte solo en secciones particulares.

El menú Ver acciones de archivos para el archivo de LookML también proporciona las opciones Fold LookML y Unfold LookML para expandir o contraer todas las secciones de LookML hasta el parámetro de nivel superior dentro del archivo actual.

También puedes usar combinaciones de teclas para plegar y desplegar LookML.

Modo de comentarios

Puedes agregar comentarios a tu LookML para que sea más legible. Para agregar un solo comentario, usa el carácter #:

dimension: name {
  sql: ${TABLE}.name ;; # This is the customer's full name
}

Para comentar un bloque completo de código con combinaciones de teclas, sigue estos pasos:

1. Selecciona las líneas que deseas comentar.
2. Presiona Command + / (Mac) o Ctrl + / (Windows).

El IDE agregará el carácter # a cada una de las líneas seleccionadas.

Comenta bloques de SQL

Si vas a comentar líneas que están enteramente dentro de un bloque de código SQL, agrega manualmente la notación de comentarios de SQL.

Cuando uses el bloque de comentarios de SQL, las secciones con comentarios se seguirán interpretando como código de LookML. Por lo tanto, verás tus comentarios en SQL generado con LookML, pero no afectarán los resultados de la consulta.

Cómo ver las adiciones, los cambios y las eliminaciones

En el IDE de LookML, siempre se muestran varios indicadores cuando estás en Modo de desarrollo y tienes cambios no confirmados.

• El nombre del archivo se muestra con un punto azul en el lado izquierdo de la ventana para indicar que el archivo es nuevo, que se modificó o que se le cambió el nombre.
• Cuando abres un archivo nuevo o modificado, los números de línea dentro del archivo se destacan en verde para mostrar las líneas nuevas o modificadas, y una línea roja horizontal indica las líneas que se quitaron.

Persistencia del estado de IDE

Durante las actualizaciones y los accesos, el IDE de Looker conserva el estado del IDE del usuario, incluidos los siguientes:

• El elemento seleccionado en la barra de navegación del IDE (como el navegador de archivos, las acciones de Git, el navegador de objetos o la configuración del proyecto)
• Abrir el archivo de LookML en el navegador de archivos
• Estado expandido o contraído de los elementos en el navegador de archivos y el navegador de objetos
• El elemento seleccionado en la barra lateral derecha del IDE (como el panel de Ayuda rápida, el panel de metadatos y el panel de estado del proyecto)
• El modo de ajuste de línea del editor

Para restablecer el IDE a sus valores predeterminados, selecciona el ícono Settings en el panel de navegación izquierdo del IDE de Looker, selecciona la pestaña Editor en la sección IDE Settings y, luego, haz clic en el botón Reset IDE Layout. El IDE volverá a mantener tu estado a medida que sigas abriendo archivos y haciendo selecciones.

Ir al objeto o archivo

En el IDE de Looker, puedes hacer una búsqueda rápida para navegar directamente a los objetos de LookML y los archivos de proyectos con la función Ir a un objeto o archivo. Haz clic en el ícono Ir a objeto o archivo en el navegador de archivos o el navegador de objetos, o usa la combinación de teclas Comando J (Mac) o Ctrl J (Windows).

Consulta la página de documentación Accede a los archivos de proyectos de LookML para obtener más información.

Panel de Ayuda rápida

Selecciona el ícono de Ayuda rápida para abrir el panel de Ayuda rápida, que proporciona explicaciones y opciones para la ubicación actual en el código. Selecciona un nombre de parámetro en la barra lateral para abrir la página de documentación de Looker correspondiente.

Menús de opciones para archivos y carpetas

En el navegador de archivos, cada archivo o carpeta del panel lateral izquierdo tiene un menú que muestra las acciones disponibles para ese elemento. Mantén el cursor sobre un archivo o una carpeta y, luego, selecciona el menú de tres puntos Opciones de carpeta (para carpetas) o el menú Opciones de archivo (para archivos) para abrir el menú. Para un elemento con un nombre largo o anidado en varias carpetas, puedes acceder al menú si te desplazas hacia los costados en el panel del navegador de archivos.

Desde los menús de opciones, puedes crear carpetas y archivos, subir archivos, y borrar y mover archivos y carpetas con el navegador de archivos. Para obtener más información, consulta la página de documentación Administra archivos y carpetas de LookML.

A medida que organizas los archivos de LookML con carpetas, debes confirmar los cambios y, luego, implementarlos en producción para que otros desarrolladores de Looker puedan verlos. Esto es igual que cualquier cambio que realices en tu proyecto de LookML.

Cómo buscar y reemplazar texto en tu proyecto

El IDE de Looker tiene una función de buscar y reemplazar, que puedes usar para buscar texto en todos los archivos de tu proyecto y, luego, reemplazar todas las instancias o las instancias seleccionadas de forma masiva.

Para usar la función de búsqueda del IDE de Looker, sigue estos pasos:

1. Navega al panel de búsqueda en el IDE.
2. Ingresa un término en el campo Buscar.
3. De manera opcional, puedes seleccionar Distinción entre mayúsculas y minúsculas para buscar solo las instancias que coincidan con las mayúsculas que ingresaste en el campo Buscar, o bien puedes seleccionar RegEX para realizar una búsqueda de expresiones regulares.
4. Selecciona Buscar.
5. De manera opcional, puedes seleccionar el nombre de un archivo para abrirlo en el IDE.

Si te encuentras en Modo de desarrollo, también verás el campo Reemplazar con. Para reemplazar texto en tu proyecto, sigue estos pasos:

1. Ingresa el texto de reemplazo en el campo Reemplazar por. De manera opcional, puedes dejar el campo Reemplazar por en blanco si deseas borrar el texto del campo Buscar en lugar de reemplazarlo.

2. Selecciona Seleccionar y Reemplazar para obtener una vista previa de cómo se reemplazará el texto en tu proyecto.

3. Los resultados muestran todas las instancias de tu proyecto destacadas para su reemplazo. Puedes usar las siguientes opciones para personalizar qué instancias se reemplazan:

   • Usa la casilla de verificación junto al resumen de resultados para seleccionar o anular la selección de todas las instancias en todo el proyecto.
   • Usa la casilla de verificación junto a una sola instancia para seleccionarla o anular la selección.

4. Selecciona el botón Replace Selected para aplicar el reemplazo a las instancias que seleccionaste. El IDE mostrará los cambios que se hicieron.

Crea y prueba campos nuevos

Como ejemplo de edición de LookML, agregaremos varios campos y, luego, los probaremos.

Cómo crear una dimensión

Primero, agregaremos una nueva dimensión a nuestra vista users, que determinará si un usuario es de California o Nueva York. La dimensión será type: yesno, lo que significa que mostrará Sí si el usuario es de California o Nueva York, y No si no lo es.

LookML de nuestra nueva dimensión se ve de la siguiente manera:

dimension: from_ca_or_ny {
  type: yesno
  sql: ${TABLE}.state = "California" OR ${TABLE}.state = "New York" ;;
}

Agrega esta dimensión al archivo de vista user y, luego, haz clic en el botón Guardar cambios en el archivo.

Consulta los operadores de sustitución para obtener más información sobre ${TABLE}.state.

Cómo crear una medición

A continuación, agregaremos una nueva medición a nuestra vista de user que promedia la edad de nuestros usuarios. Esta medición será type: average y se agregará en la columna age.

El código LookML de esta nueva medida se ve de la siguiente manera:

measure: average_age {
  type: average
  sql: ${TABLE}.age ;;
}

Agrega esta medición al archivo de vista user y, luego, haz clic en el botón Save Changes (Guardar cambios) en el archivo.

Prueba los campos en Explorar

Puedes probar tu nueva dimensión y realizar mediciones realizando consultas. Una vez que guardes los cambios, estos campos aparecerán en el selector de campos de la función Explorar. Usa el menú desplegable Ver acciones del archivo junto al nombre del archivo de la vista para acceder a Explorar de la vista actual. El menú desplegable Ver acciones del archivo enumera todas las exploraciones que se basan en la vista, incluidas las exploraciones a las que está unida la vista. Por ejemplo, para acceder a Explorar de una vista llamada users, puedes seleccionar la opción Explore Users del menú desplegable See file actions.

En el explorador Usuarios, puedes seleccionar los nuevos campos para agregarlos a una consulta. Por ejemplo, puedes crear una consulta con ambos campos nuevos que muestre la edad promedio de los usuarios que son de California o Nueva York y la edad promedio de los usuarios que no lo son: