Escribe LookML con la asistencia de Gemini

En esta página de documentación, se describe cómo usar la asistencia de Gemini para crear dimensiones, grupos de dimensiones y mediciones en un proyecto de LookML. Generar sugerencias de código LookML en respuesta a instrucciones escritas es una función de Gemini en Looker que está disponible en instancias de Looker (original) y Looker (Google Cloud Core).

Gemini en Looker proporciona asistencia potenciada por IA generativa para ayudarte a trabajar con tus datos.

Descubre cómo y cuándo Gemini para Google Cloud usa tus datos.

Esta página está destinada a desarrolladores de Looker.

Antes de comenzar

Para usar Gemini en el IDE de Looker, ten en cuenta los siguientes requisitos:

  • Gemini en Looker debe estar habilitado para tu instancia de Looker:
    • En el caso de Looker (original), la instancia debe ejecutar Looker 25.2 o una versión posterior, y debe tener habilitadas las opciones de configuración Gemini en Looker y Asistente de LookML en la configuración de administrador. Para obtener instrucciones detalladas sobre la habilitación, consulta la página de documentación Configuración de administrador: Gemini en Looker.
    • En el caso de Looker (Google Cloud Core), la instancia debe estar habilitada para Gemini en Looker en la Google Cloud consola. El Asistente de LookML también debe estar habilitado para tu instancia. Para obtener instrucciones detalladas sobre la habilitación, consulta la página de documentación Administra Gemini en tu instancia de Looker (Google Cloud Core).
  • Se te debe asignar un rol de Looker que contenga el develop permiso para al menos un modelo en un proyecto de LookML.
  • Se te debe asignar un rol que contenga el permiso gemini_in_looker para al menos un modelo en el proyecto de LookML.

Usa Gemini en el IDE de Looker

Para usar Gemini para crear LookML en tu proyecto de Looker, sigue estos pasos:

  1. En tu instancia de Looker, habilita el modo de desarrollo.
  2. Abre tu proyecto en el IDE de Looker.
  3. Usa el navegador de archivos del IDE para abrir un archivo de vista de LookML en el que deseas insertar LookML.

  4. Selecciona el ícono Ayúdame a escribir código en el selector del panel lateral.

    IDE de Looker con el ícono de Help me code destacado.

  5. Con el panel Ayúdame a escribir código abierto, haz clic para colocar el cursor en una línea del archivo de vista de LookML. Según el tipo de archivo de LookML y la ubicación del cursor en el archivo, Gemini proporciona opciones adecuadas para guiarte, como Crear una dimensión o Crear una medición.

  6. Selecciona una de las siguientes opciones en el panel Ayúdame a escribir código:

    • Crear un grupo de dimensiones
    • Crear una dimensión
    • Crear una medición
    • Otra sugerencia de código: Puedes usar la opción otra sugerencia de código si deseas probar diferentes elementos de LookML. Recuerda que Gemini es una tecnología en etapa inicial, por lo que debes validar y probar todos los resultados antes de implementarlos.

  7. En el campo de texto del panel Ayúdame a escribir código , usa lenguaje conversacional para describir la dimensión, el grupo de dimensiones o la medición que deseas crear. Consulta las secciones Sugerencias para usar Gemini en el IDE de Looker y Ejemplos de instrucciones de esta página para obtener orientación.

  8. Presiona Intro o haz clic en el ícono Enviar para enviar tu solicitud a Gemini. Gemini responderá con el código sugerido.

  9. Con el código sugerido, puedes hacer lo siguiente:

    • Mantén el puntero sobre el botón Insertar para obtener una vista previa del LookML sugerido en tu archivo. Puedes mover el cursor a una línea diferente del archivo para obtener una vista previa en una ubicación diferente antes de insertar el LookML en el archivo.
    • Haz clic en el botón Editar para cambiar manualmente el LookML sugerido.
    • Haz clic en el botón Insertar para insertar el LookML en tu archivo en la ubicación del cursor.
    • Para enviar comentarios sobre el código sugerido, selecciona el ícono Me gusta (Esta respuesta fue útil) o No me gusta (Esta respuesta no era lo que esperaba).
    • Haz clic en el vínculo Nueva sugerencia de código para comenzar de nuevo y escribir una nueva instrucción para Gemini.

    Gemini muestra una vista previa de la ubicación del código cuando se coloca el cursor sobre el botón Insertar.

  10. Haz clic en Guardar cambios en tu archivo de LookML.

  11. Para verificar el LookML, haz lo siguiente:

Sugerencias para usar Gemini en el IDE de Looker

A continuación, se incluyen algunas sugerencias para usar Gemini en el IDE de Looker:

  • Para obtener mejores resultados, escribe tus instrucciones en inglés estadounidense. Consulta la documentación de limitaciones Google Cloud deGemini paraobtener más información.
  • El panel Ayúdame a escribir código no conserva el contexto de una instrucción anterior en la conversación ni conserva las instrucciones en los accesos y las actualizaciones.
  • Cuando uses LookML sugerido por Gemini, siempre valida tu LookML con el validador de LookML y prueba tus campos nuevos en una exploración.
  • Según tu solicitud, Gemini puede sugerir LookML que haga referencia a campos en otros archivos de vista. Cuando agregues LookML sugerido a tu archivo, guárdalo y ejecuta el validador de LookML. El validador de LookML mostrará errores si necesitas agregar include instrucciones a tu archivo de modelo.

Ejemplos de instrucciones

Para darte algunas ideas, aquí tienes algunos ejemplos de instrucciones y sus resultados:

Crear una dimensión con longitud y latitud

Aquí tienes una instrucción con la opción Crear una dimensión que le pide a Gemini que cree una dimensión nueva basada en los campos longitude y latitude que se definen en el archivo de vista:

show coordinates with longitude and latitude

Gemini muestra este código sugerido:

   dimension: coordinates {
      type: location
      sql_latitude: ${TABLE}.latitude ;;
      sql_longitude: ${TABLE}.longitude ;;
   }

Puedes verificar este LookML en una exploración seleccionando el nuevo campo coordinates, junto con los campos longitude y latitude en los que se basa. Como Gemini creó la dimensión con type:location, los resultados de la exploración incluyen un hipervínculo para ver las coordenadas en un mapa:

El Explorador de Looker muestra los campos de latitud y longitud, con el nuevo campo de coordenadas que incluye valores que coinciden con los valores de latitud y longitud.

Crear una medición para las ventas totales de hoy

Aquí tienes una instrucción con la opción Crear una medición que le pide a Gemini que cree una medición nueva para la suma de todos los pedidos de hoy:

show the total sale price of today's orders

Gemini muestra este código sugerido:

   measure: todays_orders {
      type: sum
      sql: ${basic_order_items.sale_price} ;;
      filters: [basic_order_items.created_at_date: "today"]
  }

Proporcionar comentarios

Puedes proporcionar comentarios sobre el LookML generado en el panel Ayúdame a escribir código. Si el LookML generado parece correcto, haz clic en el ícono thumb_up Me gusta. Si el LookML generado parece incorrecto o no es lo que esperabas, haz clic en el ícono thumb_down No me gusta.