Modelar tus datos en LookML

Activar el modo Desarrollo

Los proyectos de Looker pueden estar en uno de estos dos modos: modo de producción y modo de desarrollo. El modo Desarrollo te permite hacer cambios en los archivos LookML y ver cómo afectarán al contenido de tu instancia sin que esto influya en el entorno de producción (lo que ven otros usuarios). Para obtener más información, consulta la página de documentación sobre el modo de desarrollo y el modo de producción.

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

Para activar el modo Desarrollo, sigue estos pasos:

1. En la página principal de Looker (Google Cloud core), haga clic en el icono Menú principal menu de Looker para desplegar el menú de navegación principal (si aún no lo ha hecho).
2. Selecciona el interruptor Modo Desarrollo en la parte inferior del menú.

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

Ve al proyecto de LookML de ejemplo en el IDE de Looker

Un proyecto de LookML es una colección de archivos de LookML que indican a Looker cómo conectarse a tu base de datos, cómo consultar tus datos y cómo presentar los datos 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 ir a los archivos del proyecto de LookML de ejemplo en el IDE de Looker, sigue estos pasos:

1. Haga clic en el icono del menú principal de Looker menu y seleccione Desarrollar, si el menú Desarrollar aún no se muestra.
2. En el menú Desarrollar, selecciona sample_thelook_ecommerce.

Looker abrirá el panel Explorador de archivos del IDE de Looker y mostrará los archivos de proyecto de LookML de ejemplo.

Crear una carpeta de proyecto

Para que los archivos que crees en esta guía de inicio rápido no se mezclen con el resto de los archivos del proyecto de ejemplo de LookML, crearás una 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 Explorador de archivos del IDE de Looker, haga clic en el icono Añadir archivo o carpeta add situado en la parte superior del panel y seleccione la opción Crear carpeta en el menú Añadir archivo o carpeta.

2. En el nombre de la carpeta nueva, escribe quickstart.

3. Haz clic en Crear.

Looker añade la nueva carpeta al panel Explorador de archivos del IDE de Looker.

Información adicional sobre las carpetas de IDE

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

• Para crear tus propias carpetas y archivos en el futuro, y para consultar las consideraciones sobre la creación de carpetas en tu proyecto, consulta la página de documentación Gestionar archivos y carpetas de LookML.
• Para obtener más información sobre el explorador de archivos del IDE de Looker, consulta la página de documentación Trabajar con el explorador de archivos del IDE.

Crear un 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 el punto de partida para que tus usuarios consulten tus datos en Looker una vez que se hayan modelizado en LookML (consulta Ver e interactuar con Exploraciones en Looker).

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

1. En el panel Explorador de archivos del IDE de Looker, selecciona el menú de tres puntos Opciones de carpeta de la carpeta quickstart que has creado en el procedimiento Crear una carpeta de proyecto.
2. En el menú Opciones de carpeta, selecciona Crear modelo.
3. En el cuadro de diálogo Crear archivo, introduce el nombre quickstart_practice para el nuevo archivo y haz clic en Crear. Looker crea el archivo quickstart_practice.model en la carpeta quickstart y lo abre en el IDE de Looker. El punto azul situado junto al archivo en el panel Explorador de archivos indica que el archivo es nuevo.
4. En el panel Explorador de archivos, haz clic en la carpeta quickstart para desplegarla 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 lo has hecho.

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

Información adicional sobre los archivos de modelo

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

• Para obtener información general sobre los archivos de modelo, consulta la sección Archivos de modelo de la página de documentación Archivos de proyecto de LookML.
• Para ver el procedimiento completo y otras opciones para crear archivos en tu proyecto, consulta la página de documentación Gestionar archivos y carpetas de LookML.
• Para obtener información sobre las convenciones de nomenclatura de los archivos LookML, consulta la sección Antes de empezar: convenciones de nomenclatura de archivos y carpetas importantes de la página Gestionar archivos y carpetas LookML.
• Para obtener información sobre los parámetros de LookML que puede usar en un archivo de modelo, consulte la página de documentación Parámetros de modelo.

Crear un 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 la base de datos que se va a consultar y los campos (dimensiones y medidas) que se van a incluir de esa tabla de la base de datos. Una vez que hayas definido 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. De esta forma, puedes definir el campo en una sola ubicación y usarlo en varios lugares de tu proyecto de LookML.

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

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

1. En el panel Explorador de archivos del IDE de Looker, selecciona el menú de tres puntos Opciones de carpeta de la carpeta quickstart que has creado en el procedimiento Crear una carpeta de proyecto.
2. En el menú Opciones de carpeta, selecciona Crear vista a partir de tabla.

3. En la página Crear vistas a partir de tablas, haga clic en el campo de entrada Introducir base de datos personalizada y escriba bigquery-public-data:

   

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

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

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

7. Selecciona la tabla order_items.

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

Looker muestra el archivo de vista order_items en el IDE de Looker. En el panel Explorador de archivos, la carpeta quickstart se ha desplegado 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, consulta los siguientes recursos:

• Para obtener información sobre los archivos de vista en general, consulta la sección Ver archivos de la página de documentación Archivos de proyecto de LookML.
• Para ver el procedimiento completo y otras opciones para crear archivos en tu proyecto, consulta la página de documentación Gestionar archivos y carpetas de LookML.
• Para ver las consideraciones específicas sobre la creación de archivos de vista, consulta la sección Consideraciones sobre la creación de archivos de vista de la página Gestionar archivos y carpetas de LookML.
• Para obtener información sobre las convenciones de nomenclatura de los archivos LookML, consulta la sección Antes de empezar: convenciones de nomenclatura de archivos y carpetas importantes de la página Gestionar archivos y carpetas LookML.
• Para obtener información sobre los parámetros de LookML que puedes usar en un archivo de vista, consulta la página de documentación Parámetros de vista.

Ayuda rápida del IDE de Looker

Ya has creado 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, empezarás a editar estos archivos. Antes de empezar a editar, debes familiarizarte con la función de ayuda rápida del IDE de Looker. El panel Ayuda rápida ofrece explicaciones y opciones para la ubicación actual del cursor en los archivos LookML:

• En el panel del editor del IDE, puede hacer clic en los campos y parámetros de sus archivos LookML. El panel Ayuda rápida mostrará las opciones y los subparámetros admitidos para ese elemento 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 icono Ayuda rápida del IDE de Looker:

Crear exploraciones para tus vistas

Después de haber seguido los procedimientos Crear un archivo de modelo LookML y Crear un archivo de vista LookML, puedes definir un Explore para el nuevo archivo de vista, de forma que puedas usar Looker para consultar los datos que has modelado en el archivo de vista.

Los Exploraciones se suelen definir en un archivo de modelo. Puedes crear un archivo Explorar independiente, pero, para esta guía de inicio rápido, lo crearás en el archivo de modelo.

En el archivo LookML en el que definas 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 un archivo de vista Explorar para order_items, sigue estos pasos:

1. En el IDE de Looker, abre el archivo quickstart_practice.model.

2. En el archivo quickstart_practice.model, sustituya la línea que contiene el parámetro include por la siguiente:

   include: "/quickstart/order_items.view"
   

3. Añade una línea debajo del parámetro include e introduce el siguiente LookML: alue, que puedes seleccionar en el campo none explore: order_items {}

4. Haz clic en el botón Guardar cambios situado 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 desarrollar tu exploración de muchas formas.

Información adicional sobre las exploraciones

Para crear tus propios Exploraciones en el futuro y desarrollarlos, consulta los siguientes recursos:

• Para obtener más información sobre cómo crear Exploraciones, consulta la página de documentación Crear y editar Exploraciones.
• Para obtener información sobre cómo unirse a otras vistas, consulta la página de documentación Trabajar con combinaciones en LookML.
• Para obtener información sobre los parámetros de LookML que puedes usar en una exploración, consulta la página de documentación Parámetros de Exploración.
• Para obtener información sobre cómo consultar datos en una página Explorar de la interfaz de usuario de Looker, consulta la página de documentación Ver e interactuar con Exploraciones en Looker.

Crear un campo

Después de crear los archivos de vista en la sección Crear un archivo de vista de LookML de esta guía de inicio rápido, puede ver los campos que Looker ha creado automáticamente. Cuando creas un archivo de vista basado en una tabla de una 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. Los usuarios pueden seleccionarlo en el selector de campos de Exploración y se puede usar para filtrar una consulta. Si el campo no está dentro de una función de agregación como SUM, COUNT, etc., 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 en la duración a la vez. Por ejemplo, el grupo de dimensiones de una columna de marca de tiempo contendrá dimensiones individuales de fecha, mes, trimestre, hora, semana y 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 de un Exploración que representa información medible sobre tus datos, como sumas, recuentos, etc. Las medidas se declaran en un archivo de vista y pueden ser de tipo agregado o no agregado. Looker crea automáticamente una medida de type:count para tu archivo de vista, que es el equivalente de un COUNT(*) en SQL.

En esta sección, aprenderá a añadir manualmente su propia dimensión al archivo de vista order_items.

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

1. Abre el archivo quickstarts/order_items.view si aún no lo has hecho: en el panel Explorador de archivos del IDE de Looker, haz clic en la carpeta quickstart para desplegarla y, a continuación, haz clic en el archivo order_items.view para abrirlo.
2. En el archivo quickstarts/order_items.view, cree una línea antes del primer parámetro dimension del archivo.

3. En la línea nueva, empieza a escribir dimension. Mientras escribes, el IDE de Looker mostrará una lista de posibles parámetros que empiecen por el texto que hayas escrito.

   • Usa las teclas de flecha para desplazarte por la lista de sugerencias hasta la opción dimension.
   • Pulsa Intro para insertar el parámetro seleccionado en tu LookML. Looker insertará un nuevo parámetro dimension en la nueva línea que hayas creado.

4. Para asignar un nombre a la nueva dimensión, haz clic en el IDE antes de {} y escribe shipped_to_delivered_days.

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

6. Completa el LookML de la nueva dimensión (puedes copiar y pegar el siguiente LookML o introducirlo manualmente para ver cómo te ayuda el IDE de Looker):

   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 la nueva dimensión. En las nuevas líneas 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, consulta los siguientes recursos:

• Para obtener información sobre los campos de LookML en general, consulta la página de documentación Referencia de campos de LookML.
• Para obtener información sobre los tipos de dimensiones, filtros y parámetros que puede crear en un archivo de vista, consulte la página de documentación Tipos de dimensiones, filtros y 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.

Ver y probar los cambios en la interfaz de Looker

Si has seguido el procedimiento Crear Exploraciones para tus vistas para crear una exploración para el archivo de vista order_items, puedes ver la nueva dimensión en la interfaz de usuario de Explorar de Looker.

Para ver y probar los cambios en Explorar en la interfaz de Looker, sigue estos pasos:

1. En el archivo quickstarts/order_items.view del IDE de Looker, haga clic en el icono de flecha Ver acciones del archivo situado junto al nombre del archivo de vista en la parte superior del panel del editor de archivos y seleccione la opción Explorar elementos de pedido - quickstart_practice.

   

2. En el selector de campos Artículos de pedido de Exploración, haga clic en la etiqueta del grupo Otras fechas para desplegarlo y, a continuación, haga clic en la dimensión Días desde el envío hasta la entrega para añadirla a Exploración. También puede 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 Artículos de pedido de Exploración, haga clic en la etiqueta del grupo Fecha de envío para desplegarlo y, a continuación, haga clic en la dimensión Fecha para añadirla a Exploración.

4. En el selector de campos Artículos de pedido de Exploración, haga clic en la etiqueta del grupo Fecha de entrega para desplegarlo y, a continuación, haga clic en la dimensión Fecha para añadirla a Exploración.

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

Looker ejecutará la consulta y mostrará los resultados en la sección Datos del Explorar. En cada línea, puede comprobar que el valor de Días transcurridos entre el envío y la entrega de los artículos del pedido muestra el número de días correcto 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.

Validar tu LookML

Para esta guía de inicio rápido, no es necesario que valide su LookML. Sin embargo, cuando crees tus propios proyectos para modelar tus datos, te vendrá bien conocer las herramientas de Looker para validar tu LookML.

Mientras editas tu LookML, el IDE de Looker te avisará de los errores de sintaxis sin resolver en un solo archivo (consulta la página de documentación Descripción general del IDE de Looker). También puede realizar una validación completa del modelo, que comprobará si hay errores en su LookML. Para obtener más información, consulta la página de documentación Validar tu LookML.

Confirmar los cambios

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

A medida que vayas modificando los archivos de tu proyecto de LookML, el IDE de Looker mostrará diferentes operaciones para el botón de Git, situado 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 de implementación de los cambios en producción.

Los archivos LookML y el Explore que has visto en esta guía de inicio rápido solo están disponibles en tu rama de Git personal mientras estás en el modo Desarrollo. Si quieres que este modelo esté disponible para otros usuarios de tu instancia de Looker (Google Cloud Core), debes confirmar los cambios, combinar tu rama e implementar la rama de producción.

En esta guía de inicio rápido, no desplegarás los cambios en producción. En su lugar, eliminará estos archivos, tal como se describe en el procedimiento Limpiar.