Modelar tus datos en LookML

Aprende a usar LookML y el IDE de Looker para modelar tus datos de forma estructurada y reutilizable.

La forma más fácil de modelar tus datos en Looker es hacer que Looker genere automáticamente archivos de LookML basados en las tablas de tu base de datos. Puedes practicar esto con la guía de inicio rápido Genera un modelo a partir de datos de muestra y ver el procedimiento completo en la página de documentación Cómo generar un modelo de LookML.

El objetivo de esta guía de inicio rápido es mostrarte cómo agregar archivos de LookML de forma manual a tu proyecto y cómo crear elementos de LookML nuevos de forma manual para que puedas personalizar tu proyecto de LookML según tus datos y necesidades específicos. En esta guía de inicio rápido, se explica cómo crear manualmente un archivo de modelo de LookML y un archivo de vista de LookML, crear una exploración para tu vista, crear una dimensión nueva en tu archivo de vista y probar tu nueva medida en la IU de Explorar. En esta guía de inicio rápido, también se te indicará cómo activar el modo de desarrollo, navegar por el IDE de Looker y usar la función de ayuda rápida del IDE de Looker. En esta guía de inicio rápido, también se proporcionan vínculos a la documentación relevante para obtener más información sobre estos temas.

Como punto de partida, en esta guía de inicio rápido, se usa el proyecto de LookML de muestra que se configura automáticamente en las instancias de Looker (Google Cloud Core).

Antes de comenzar

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

Cómo activar el modo de desarrollo

Los proyectos de Looker pueden existir en uno de estos dos modos: modo de producción y modo de desarrollo. El Modo de desarrollo te permite hacer cambios en los archivos de LookML y obtener una vista previa de cómo afectarán el contenido de tu instancia sin afectar el entorno de producción (lo que ven los demás 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 lo hiciste.
  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 Desarrollar si aún no se muestra el menú Desarrollar.
  2. En el menú Develop, selecciona sample_thelook_ecommerce.

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

Crea una carpeta de proyecto nueva

Para mantener los archivos que crees 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.

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

  1. En el panel File Browser del IDE de Looker, haz clic en el ícono Add file or folder en la parte superior del panel y selecciona la opción Create Folder en el menú Add file or folder.

  2. Para el nombre de la carpeta nueva, ingresa quickstart.

  3. Haz clic en Crear.

Looker agrega la carpeta nueva al panel File Browser 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 nuevo archivo de modelo de LookML

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 hayan modelado en LookML (consulta Cómo ver y cómo interactuar con exploraciones en Looker).

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

  1. En el panel File Browser del IDE de Looker, selecciona el menú de tres puntos Folder Options de la carpeta quickstart que creaste en el procedimiento Crea una carpeta de proyecto nueva.
  2. En el menú Folder Options, selecciona Create Model.
  3. En el cuadro de diálogo Create File, ingresa el nombre quickstart_practice para el archivo nuevo y, luego, haz clic en Create. Looker crea el archivo quickstart_practice.model en la carpeta quickstart y lo abre en el IDE de Looker. El punto azul junto al archivo en el panel Navegador de archivos indica que es nuevo.
  4. En el panel File Browser, 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 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 modelos 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 en 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 medidas) que se incluirán de esa tabla de 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 usarlo en varios lugares de tu proyecto de LookML.

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

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

  1. En el panel File Browser del IDE de Looker, selecciona el menú de tres puntos Folder Options de la carpeta quickstart que creaste en el procedimiento Crea una carpeta de proyecto nueva.
  2. Selecciona Crear vista desde 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:

    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 del navegador de archivos, se expande la carpeta quickstart y el archivo de vista order_items se muestra 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

Ahora creaste un archivo de modelo de LookML y un archivo de vista de LookML. En los próximos 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 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 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 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 para 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 función Explorar en el archivo del modelo).

En el archivo 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 exploración. En este procedimiento, se explican estos pasos.

Para crear una función Explorar 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 valor de LookML, que puedes seleccionar del campo none explore: order_items {}:

  4. Haz clic en el botón Save Changes 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. A partir de este punto, 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, puedes 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 medidas:

  • 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 Explorar 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 la base de datos.
  • Un grupo de dimensiones se usa para crear un conjunto de dimensiones basadas en el tiempo o la duración todas a la 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 medida es un campo en una exploración que representa información medible sobre tus datos, como sumas, recuentos, etcétera. Una medida se declara en un archivo de vista y puede ser de un tipo agregado o no agregado. Looker crea automáticamente una medida de type:count para tu archivo de vista, que es el equivalente a 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 File Browser del IDE de Looker, haz clic en la carpeta quickstart para expandirla y, luego, 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 los parámetros posibles 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 dimensión nueva, 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 código de LookML para la dimensión nueva (puedes copiar y pegar el siguiente código de LookML o ingresarlo manualmente para ver cómo el IDE de Looker te brinda 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 Save Changes.

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 Dimensiones, filtros y tipos de parámetros.
  • Para obtener información sobre los tipos de medidas que puedes crear en un archivo de vista, consulta la página de documentación Tipos de medidas.

Consulta 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 dimensión nueva en la IU de Exploración de Looker.

Para ver y probar tus cambios en Explorar 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 See file actions junto al nombre del archivo de vista en la parte superior del panel del editor de archivos y selecciona la opción Explore Order Items - 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 exploración Order Items, haz clic en la etiqueta de grupo Other Dates para expandirla y, luego, 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 exploración Order Items, haz clic en la etiqueta de grupo Shipped Date para expandirla y, luego, en la dimensión Date para agregarla a la exploración.

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

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

Looker ejecutará la consulta y mostrará los resultados en la sección Datos de Explorar. Para cada línea, puedes verificar que el valor de Días desde que se enviaron los artículos del pedido hasta que se entregaron muestre la cantidad correcta de días entre el valor de Fecha de envío de los artículos del pedido y el valor de Fecha de entrega de los artículos del pedido.

Valida tu LookML

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

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

Confirma los cambios

En esta guía de inicio rápido, usas una conexión de Git preconfigurada que se configuró para el proyecto de LookML de ejemplo. 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 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 los cambios en producción.

Los archivos de LookML y Explorar que viste en esta guía de inicio rápido solo están disponibles en tu rama personal de Git mientras estás en modo de desarrollo. Si quisieras que este modelo esté disponible para otros usuarios en tu instancia de Looker (Google Cloud Core), confirmarías los cambios, combinarías la rama y, luego, implementarías 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 de limpieza.

Limpia

Para maximizar el rendimiento de Looker, no se deben implementar modelos innecesarios en producción. Para mantener una rama personal de Git 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 Desarrollar si aún no se muestra el menú Desarrollar.
  2. En el menú Develop, selecciona sample_thelook_ecommerce.
  3. En el panel File Browser del IDE de Looker, selecciona el menú de tres puntos Folder Options de la carpeta quickstart que creaste en el procedimiento Crea una carpeta de proyecto nueva.
  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?