Modelar tus datos en LookML

LookML y el IDE de Looker te permiten definir modelos de datos, dimensiones y relaciones reutilizables que se basan en las tablas de tu base de datos. En esta guía de inicio rápido, crearás un archivo de modelo y un archivo de vista, configurarás una exploración y probarás una dimensión nueva con el proyecto de LookML de muestra en Looker (Google Cloud Core). También aprenderás a activar el Modo de desarrollo, navegar por el IDE de Looker y usar la Ayuda rápida.

Antes de comenzar

Para seguir esta guía de inicio rápido, necesitarás lo siguiente:

Roles obligatorios

Para completar esta guía de inicio rápido, necesitas el rol de Identity and Access Management (IAM) y el rol de Looker adecuados.

Roles de Identity and Access Management

El administrador de Looker (Google Cloud Core) te otorga acceso a la aplicación de Looker (Google Cloud Core) a través del sistema de Identity and Access Management de Google Cloud.

Para obtener el permiso que necesitas para acceder a la aplicación de Looker (Google Cloud Core), pídele a tu administrador que te otorgue el rol de IAM de usuario de instancia de Looker (roles/looker.instanceUser) en el proyecto de Google Cloud que contiene la instancia de Looker (Google Cloud Core). Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso looker.instances.login, que se requiere para acceder a la aplicación de Looker (Google Cloud Core).

También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

Permisos de Looker

Necesitas una cuenta de usuario de Looker con el rol de administrador de Looker o el permiso develop.

Activa el Modo de desarrollo

Los proyectos de Looker pueden existir en uno de dos modos: Modo de producción y Modo de desarrollo. El Modo de desarrollo te permite realizar cambios en los archivos de LookML y obtener una vista previa de cómo afectarán al contenido de tu instancia sin afectar el entorno de producción (lo que ven otros usuarios). Consulta la página de documentación Modo de desarrollo y modo de producción para obtener más información.

En esta guía de inicio rápido, usarás el Modo de desarrollo para poder realizar cambios en los archivos de LookML y probarlos en una exploración.

Para activar el modo de desarrollo, sigue estos pasos:

  1. En la página principal de Looker (Google Cloud Core), haz clic en el ícono de menú principal de Looker para expandir el menú de navegación principal, si aún no está expandido.
  2. Selecciona el botón de activación Modo de desarrollo en la parte inferior del menú.

Cuando el Modo de desarrollo está habilitado, Looker muestra el banner Modo de desarrollo en la parte superior de la pantalla.

Un proyecto de LookML es una colección de archivos de LookML que le indican a Looker cómo conectarse a tu base de datos, cómo consultar tus datos y cómo presentarlos en la interfaz de usuario. En esta guía de inicio rápido, usarás el proyecto de LookML de muestra que se configura automáticamente en las instancias de Looker (Google Cloud Core).

Para navegar a los archivos de proyecto de LookML de muestra en el IDE de Looker, sigue estos pasos:

  1. Haz clic en el ícono del menú principal de Looker y selecciona Desarrollo, si aún no se muestra el menú Desarrollo.
  2. En el menú Desarrollo, selecciona sample_thelook_ecommerce.

Looker abrirá el panel Navegador de archivos del IDE de Looker y mostrará los archivos de muestra del proyecto de LookML.

Crea una nueva carpeta de proyecto

Para mantener los archivos que creas en esta guía de inicio rápido separados del resto de los archivos del proyecto de ejemplo de LookML, crearás una nueva carpeta de proyecto para los archivos de la guía de inicio rápido.

Para crear una carpeta en tu proyecto, sigue estos pasos:

  1. En el panel Navegador de archivos del IDE de Looker, haz clic en el ícono Agregar archivo o carpeta que se encuentra en la parte superior del panel y selecciona la opción Crear carpeta en el menú Agregar archivo o carpeta.
  2. Para el nombre de la carpeta nueva, ingresa quickstart.

  3. Haz clic en Crear.

Looker agrega la carpeta nueva al panel Navegador de archivos en el IDE de Looker.

Información adicional sobre las carpetas del IDE

Para obtener más información sobre el uso de carpetas en tu proyecto de LookML, consulta las siguientes páginas de documentación:

Crea un archivo de modelo de LookML nuevo

Un archivo de modelo de LookML especifica una conexión de base de datos y el conjunto de exploraciones de Looker que usan esa conexión. Una exploración es un punto de partida para que los usuarios consulten tus datos en Looker una vez que se modelan en LookML (consulta Cómo ver exploraciones en Looker y cómo interactuar con ellas).

Para crear un archivo de modelo nuevo en tu proyecto de LookML, sigue estos pasos:

  1. En el panel Navegador de archivos del IDE de Looker, selecciona el menú de tres puntos Opciones de carpeta para la carpeta quickstart que creaste en el procedimiento Crea una nueva carpeta de proyecto.
  2. En el menú Opciones de carpeta, selecciona Crear modelo.
  3. En el cuadro de diálogo Crear archivo, ingresa el nombre quickstart_practice para el archivo nuevo y, luego, haz clic en Crear. Looker crea el archivo quickstart_practice.model en la carpeta quickstart y abre el archivo nuevo en el IDE de Looker. El punto azul junto al archivo en el panel Navegador de archivos indica que el archivo es nuevo.
  4. En el panel Navegador de archivos, haz clic en la carpeta quickstart para expandirla y ver el archivo quickstart_practice.model.
  5. En el IDE de Looker, haz clic en el archivo quickstart_practice.model para abrirlo si aún no está abierto.

El archivo quickstart_practice.model contiene un ejemplo de LookML que puedes usar como punto de partida para tu proyecto. Por ahora, puedes mantener el archivo tal como está. Más adelante en la guía de inicio rápido, crearás exploraciones en tu archivo de modelo.

Información adicional sobre los archivos de modelos

Para crear tus propios archivos de modelo en el futuro, ten en cuenta los siguientes recursos:

Crea un nuevo archivo de vista de LookML

En LookML, una vista corresponde a una sola tabla de tu base de datos o a una sola tabla derivada. El archivo de vista especifica la tabla de tu base de datos que se consultará y los campos (dimensiones y mediciones) que se incluirán de esa tabla de la base de datos. Una vez que definas un campo en el archivo de vista, puedes usar el operador de sustitución $ para hacer referencia al campo en otras partes de tu LookML. Esto te permite definir el campo en una sola ubicación y, al mismo tiempo, usarlo en varios lugares de tu proyecto de LookML.

Existen varias formas de crear un archivo de vista nuevo, pero la más sencilla para comenzar es que Looker genere automáticamente un archivo de vista basado en una tabla existente de tu base de datos.

Para que Looker genere un nuevo archivo de vista, sigue estos pasos:

  1. En el panel Navegador de archivos del IDE de Looker, selecciona el menú de tres puntos Opciones de carpeta para la carpeta quickstart que creaste en el procedimiento Crea una nueva carpeta de proyecto.
  2. Selecciona Crear vista desde la tabla en el menú Opciones de carpeta.
  3. En la página Crear vista a partir de la tabla, haz clic en el campo de entrada Enter custom db y escribe bigquery-public-data:

    El diálogo Crear vistas a partir de tablas.

  4. Presiona Intro para ver los conjuntos de datos públicos de BigQuery.

  5. Desplázate por la lista hasta encontrar el conjunto de datos thelook_ecommerce.

  6. Haz clic en el conjunto de datos thelook_ecommerce para expandirlo.

  7. Selecciona la tabla order_items.

  8. Haz clic en el botón Crear vistas en la parte inferior de la página.

Looker muestra el archivo de vista order_items en el IDE de Looker. En el panel File Browser, se expande la carpeta quickstart y se muestra el archivo de vista order_items con un punto azul para indicar que es un archivo nuevo.

Información adicional sobre los archivos de vista

Para crear tus propios archivos de vista en el futuro, ten en cuenta los siguientes recursos:

Ayuda rápida del IDE de Looker

Ya creaste un archivo de modelo de LookML y un archivo de vista de LookML. En los siguientes pasos de esta guía de inicio rápido, comenzarás a editar estos archivos. Antes de comenzar a editar, debes familiarizarte con la función de Ayuda rápida del IDE de Looker. El panel de Ayuda rápida proporciona explicaciones y opciones para la ubicación actual del cursor en tus archivos de LookML:

  • En el panel del editor del IDE, puedes hacer clic en los campos y parámetros de tus archivos de LookML, y el panel de Ayuda rápida mostrará las opciones y los subparámetros admitidos para ese elemento de LookML.
  • En el panel Ayuda rápida, puedes hacer clic en el nombre de un parámetro para abrir la página de documentación de Looker correspondiente.

Si el panel Ayuda rápida aún no está abierto, puedes abrirlo haciendo clic en el ícono de Ayuda rápida en el IDE de Looker:

Crea exploraciones para tus vistas

Después de realizar el procedimiento Crea un nuevo archivo de modelo de LookML y el procedimiento Crea un nuevo archivo de vista de LookML, puedes definir una exploración para tu nuevo archivo de vista, de modo que puedas usar Looker para consultar los datos que modelaste en el archivo de vista.

Por lo general, las exploraciones se definen en un archivo de modelo. (Puedes crear un archivo de exploración independiente, pero, para los fines de esta guía de inicio rápido, crearás la exploración en el archivo de modelo).

En el archivo de LookML en el que defines una exploración, debes usar el parámetro include para poder hacer referencia al archivo de vista en la definición de la exploración. En este procedimiento, se explican estos pasos.

Para crear una exploración para el archivo de vista order_items, sigue estos pasos:

  1. En el IDE de Looker, abre el archivo quickstart_practice.model.
  2. En el archivo quickstart_practice.model, reemplaza la línea existente que contiene el parámetro include por la siguiente línea:

    include: "/quickstart/order_items.view"
    
  3. Agrega una línea nueva debajo del parámetro include y, luego, ingresa el siguiente código de LookML: alue, que puedes seleccionar en el campo none explore: order_items {}

  4. Haz clic en el botón Guardar cambios en la parte superior del IDE de Looker.

Esta exploración es el ejemplo más básico de una exploración que permite a los usuarios consultar la vista order_items. Desde este punto de partida, puedes crear tu exploración de muchas maneras.

Información adicional sobre las exploraciones

Para crear tus propias exploraciones en el futuro y desarrollarlas, ten en cuenta los siguientes recursos:

Crea un campo nuevo

Después de crear los archivos de vista en la sección Crea un nuevo archivo de vista de LookML de esta guía de inicio rápido, podrás ver los campos que Looker creó automáticamente. Cuando creas un archivo de vista basado en una tabla de base de datos, Looker crea automáticamente dimensiones, grupos de dimensiones y mediciones:

  • Una dimensión es un campo que representa un atributo, un hecho o un valor, que los usuarios pueden seleccionar en el selector de campos de una exploración y que se puede usar para filtrar una consulta. Si el campo no está dentro de una función de agregación, como SUM, COUNT y similares, es una dimensión. Looker crea automáticamente una dimensión para cada columna de la tabla de tu base de datos.
  • Un grupo de dimensiones se usa para crear un conjunto de dimensiones basadas en el tiempo o la duración de una sola vez. Por ejemplo, el grupo de dimensiones de una columna de marca de tiempo contendrá dimensiones individuales para la fecha, el mes, el trimestre, la hora, la semana y el año. Looker crea automáticamente un grupo de dimensiones para los campos basados en el tiempo que detecta en la tabla de tu base de datos.
  • Una medición es un campo de una exploración que representa información medible sobre tus datos, como sumas, recuentos, etc. Se declara en un archivo de vista y puede ser de tipo agregado o no agregado. Looker crea automáticamente una medición de type:count para tu archivo de vista, que es el equivalente de un COUNT(*) en SQL.

En esta sección, aprenderás a agregar manualmente tu propia dimensión al archivo de vista order_items.

Para crear manualmente una dimensión nueva en el archivo de vista order_items, sigue estos pasos:

  1. Abre el archivo quickstarts/order_items.view si aún no está abierto: En el panel Navegador de archivos del IDE de Looker, haz clic en la carpeta quickstart para expandirla y, luego, haz clic en el archivo order_items.view para abrirlo.
  2. En el archivo quickstarts/order_items.view, crea una línea nueva antes del primer parámetro dimension del archivo.
  3. En la línea nueva, comienza a escribir dimension. A medida que escribas, el IDE de Looker mostrará una lista de posibles parámetros que comienzan con el texto que escribiste.

    • Usa las teclas de flecha para navegar por la lista de sugerencias hasta la opción dimension.
    • Presiona Intro para insertar el parámetro seleccionado en tu LookML. Looker insertará un nuevo parámetro dimension en la línea nueva que creaste.
  4. Para proporcionar un nombre para la nueva dimensión, haz clic en el IDE antes de {} y escribe shipped_to_delivered_days.

  5. Haz clic dentro de {} y presiona Intro para crear una línea nueva dentro de {}.

  6. Completa el LookML para la nueva dimensión (puedes copiar y pegar el siguiente LookML o ingresarlo de forma manual para ver cómo el IDE de Looker proporciona orientación):

    dimension: shipped_to_delivered_days {
      group_label: "Other Dates"
      type: duration_day
      sql_start: ${shipped_raw} ;;
      sql_end: ${delivered_raw} ;;
    }
    
  7. En la parte superior del IDE de Looker, haz clic en el botón Guardar cambios.

Looker guardará el archivo de vista con tu nueva dimensión. En el caso de las líneas nuevas del archivo, el IDE de Looker sombreará los números de línea en verde.

Información adicional sobre los campos de LookML

Para crear tus propios campos en el futuro, ten en cuenta los siguientes recursos:

  • Para obtener información sobre los campos de LookML en general, consulta la página de documentación de referencia de campos de LookML.
  • Para obtener información sobre los tipos de dimensiones, filtros y parámetros que puedes crear en un archivo de vista, consulta la página de documentación Tipos de dimensiones, filtros y parámetros.
  • Para obtener información sobre los tipos de mediciones que puedes crear en un archivo de vista, consulta la página de documentación Tipos de mediciones.

Visualiza y prueba tus cambios en la IU de Looker

Si realizaste el procedimiento Crea exploraciones para tus vistas para crear una exploración para el archivo de vista order_items, puedes ver tu nueva dimensión en la IU de Explorar de Looker.

Para ver y probar los cambios en la exploración en la IU de Looker, sigue estos pasos:

  1. En el archivo quickstarts/order_items.view del IDE de Looker, haz clic en el ícono de flecha Ver acciones de archivo junto al nombre del archivo de vista en la parte superior del panel del editor de archivos y selecciona la opción Explorar elementos de pedido: quickstart_practice.

    El menú Ver acciones del archivo, con la opción Explorar elementos del pedido: quickstart_practice seleccionada.

  2. En el selector de campos de la exploración Order Items, haz clic en la etiqueta del grupo Other Dates para expandirla y, luego, haz clic en la dimensión Shipped to Delivered Days para agregarla a la exploración. (También puedes buscar la dimensión escribiendo Shipped to Delivered Days en el cuadro de búsqueda del selector de campos).

  3. En el selector de campos de la exploración Order Items, haz clic en la etiqueta del grupo Shipped Date para expandirla y, luego, haz clic en la dimensión Date para agregarla a la exploración.

  4. En el selector de campos de la exploración Order Items, haz clic en la etiqueta del grupo Delivered Date para expandirla y, luego, haz clic en la dimensión Date para agregarla a la exploración.

  5. Haz clic en el botón Ejecutar en la parte superior de la exploración.

Looker ejecutará la consulta y mostrará los resultados en la sección Datos de la exploración. Para cada línea, puedes verificar que el valor en Order Items Shipped to Delivered Days muestre la cantidad correcta de días entre el valor de Order Items Shipped Date y el de Order Items Delivered Date.

Valida tu LookML

Para los fines de esta guía de inicio rápido, no es necesario que valides tu LookML. Sin embargo, en el futuro, cuando crees tus propios proyectos para modelar tus datos, es bueno conocer las herramientas de Looker para validar tu LookML.

A medida que edites tu LookML, el IDE de Looker te alertará sobre cualquier error de sintaxis sin resolver dentro de un solo archivo (consulta la página de documentación Descripción general del IDE de Looker). También puedes realizar una validación completa del modelo, que verificará si hay errores en tu LookML. Consulta la página de documentación Valida tu LookML para obtener más información.

Confirma los cambios

En esta guía de inicio rápido, usarás una conexión de Git preconfigurada que se estableció para el proyecto de LookML de muestra. Sin embargo, en el futuro, cuando crees tus propios proyectos para modelar tus datos, deberás configurar una conexión de Git para tu proyecto.

A medida que realices cambios en los archivos de tu proyecto de LookML, el IDE de Looker mostrará diferentes operaciones para el botón de Git en la esquina superior derecha del IDE. El botón muestra diferentes operaciones para guiarte en el proceso de validación de tu LookML y la implementación de tus cambios en producción.

Los archivos de LookML y la exploración que viste en esta guía de inicio rápido solo están disponibles en tu rama personal de Git mientras estás en el Modo de desarrollo. Si quisieras que este modelo estuviera disponible para otros usuarios en tu instancia de Looker (Google Cloud Core), deberías confirmar los cambios, combinar la rama y, luego, implementar la rama de producción.

Para los fines de esta guía de inicio rápido, no implementarás los cambios en producción. En su lugar, borrarás estos archivos, como se describe en el procedimiento Limpia.

Realiza una limpieza

Para maximizar el rendimiento de Looker, no se deben implementar modelos innecesarios en producción. Para mantener una rama de Git personal limpia y evitar implementar estos archivos en producción por accidente, completa los siguientes pasos para borrar los archivos que creaste en esta guía de inicio rápido:

  1. Haz clic en el ícono del menú principal de Looker y selecciona Desarrollo, si aún no se muestra el menú Desarrollo.
  2. En el menú Desarrollo, selecciona sample_thelook_ecommerce.
  3. En el panel Navegador de archivos del IDE de Looker, selecciona el menú de tres puntos Opciones de carpeta para la carpeta quickstart que creaste en el procedimiento Crea una nueva carpeta de proyecto.
  4. Selecciona Borrar en el menú Opciones de carpeta.
  5. En la ventana Borrar carpeta, haz clic en Borrar.

Looker borra la carpeta quickstart y todo su contenido.

¿Qué sigue?