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.

Cómo acceder 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 abre 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 hayas seleccionado 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:
    • 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 de 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.
    • Configuración: (Solo visible en modo de desarrollo) Muestra las páginas de configuración del 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 Modo de desarrollo) Para los proyectos configurados con el modo de implementación avanzado, se abre Deployment Manager, donde los desarrolladores que tienen el permiso deploy pueden implementar una confirmación o etiqueta en su entorno de producción de Looker.
  3. Panel Feature: 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.
    • Ayúdame a programar: (Para instancias de Looker (Google Cloud Core) con Gemini habilitado), abre el panel Ayúdame a programar. Vuelve a hacer clic en la opción del selector del panel lateral para ocultar el panel lateral del IDE.
  6. Panel lateral de IDE: Muestra la función del panel lateral seleccionada.
  7. Botón de Git: Según el estado de tu proyecto, el botón muestra la siguiente acción que debes realizar para llevarlo a producción, como Validar LookML, Enviar rama a remoto o Confirmar. 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.

Cómo configurar el IDE de Looker

Puedes personalizar el IDE de Looker de las siguientes maneras:

Modos del 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 Configuración en el panel de navegación izquierdo del IDE de Looker.
  2. Selecciona la pestaña Editor en Configuración del 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íneas

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

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

  1. Selecciona el ícono Configuración en el panel de navegación izquierdo del IDE de Looker.
  2. Selecciona la pestaña Editor en Configuración de 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.

Cambia el tamaño de los paneles laterales del IDE

Puedes cambiar el ancho de los paneles en el IDE, tanto el panel de atributos (que contiene los paneles File Browser, Object Browser y Git Actions) y el panel lateral (que contiene los paneles Project Health, Quick Help y Metadata).

Para cambiar el tamaño de los paneles del IDE, coloca el cursor sobre el borde del panel y arrástralo para cambiar su tamaño:

Si estás en modo de desarrollo, el IDE permanecerá con el tamaño de los paneles laterales en todos los accesos y actualizaciones.

Cómo contraer los paneles laterales del IDE

Si deseas 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

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 de los parámetros sql deben marcarse con ${...}, de modo que el IDE agregue esa sintaxis cuando sugiera campos.

Las sugerencias automáticas aparecen automáticamente siempre que puedan mostrarse. Para cerrarla, presiona la tecla Esc en el teclado. Para verla en cualquier momento, presiona Ctrl + barra espaciadora (Windows) o Control + barra espaciadora (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, que está subrayado en rojo. Cuando colocas el cursor sobre la X roja, aparece una breve descripción del problema. Por ejemplo, si escribes por error avrage en lugar de average como el valor del parámetro type para una medición, el IDE mostrará el error Invalid value for "type":avrage.

El validador de LookML sigue siendo necesario para realizar una validación completa del modelo. Algunos errores, como una referencia de campo no válida que se produce por una unión faltante, requieren una mirada integral del modelo y, por lo tanto, solo aparecen 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 archivo 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 contraer y expandir 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 quieres comentar.
  2. Presiona Comando + / (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 es nuevo, que se cambió 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

Cuando estás en el Modo de desarrollo, el IDE de Looker conserva el estado del IDE en todas las actualizaciones y los accesos. El estado de tu IDE incluye lo siguiente:

  • 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)
  • Abre el archivo LookML que se muestra en el navegador de archivos.
  • Estado expandido o reducido de los elementos en el navegador de archivos y el navegador de objetos
  • El ancho de los paneles laterales del IDE
  • 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íneas 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 conservar tu estado a medida que sigas abriendo archivos y realizando 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 Saltar a un objeto o archivo desde el navegador de archivos o el navegador de objetos, o bien usa la combinación de teclas Comando J (Mac) o Ctrl + J (Windows).

Consulta la página de documentación Cómo acceder 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.

Panel Ayúdame a programar

Si tienes una instancia de Looker (Google Cloud Core) con Gemini habilitado, puedes usar Gemini en Looker para escribir en LookML:

IDE de Looker con el ícono Ayúdame a programar destacado.

Consulta la documentación Cómo escribir LookML con Gemini en la asistencia de Looker para obtener más información.

Menús de opciones de archivos y carpetas

En el navegador de archivos, cada archivo o carpeta en el panel lateral izquierdo tiene un menú que muestra las acciones disponibles para ese elemento. Coloca el cursor sobre un archivo o una carpeta y, luego, selecciona el menú de tres puntos Opciones de carpeta (para carpetas) o Opciones de archivo (para archivos) para abrirlo. 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.

En 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 tus 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 como 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 Distinguir mayúsculas de minúsculas para buscar solo instancias que coincidan con el caso que ingresaste en el campo Buscar, o bien puedes seleccionar RegEX para realizar una búsqueda de expresión regular.
  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 con. De manera opcional, puedes dejar el campo Reemplazar por en blanco si quieres 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 el 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 realizaron.

Cómo crear y probar 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 dimensión nueva a nuestra vista users que determine 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 es así.

El código 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 medida a nuestra vista user que calcule el promedio de la edad de nuestros usuarios. Esta medida será type: average y se agregará en la columna age.

LookML para esta nueva medición 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. A modo de ejemplo, para acceder a Explorar en una vista llamada users, puedes seleccionar la opción Explorar usuarios en el menú desplegable Ver acciones de archivo.

En la exploración Usuarios, puedes seleccionar los campos nuevos para agregarlos a una búsqueda. 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:

Tabla de datos de una exploración de usuarios de muestra con los campos Usuarios de CA o NY (Sí/No) y Edad promedio de los usuarios seleccionados.