Usa el diagrama de LookML

El diagrama de LookML es una extensión, una aplicación web compilada con componentes de Looker, desarrollada con el marco de trabajo de extensiones de Looker y que se implementó a través de Looker Marketplace.

El diagrama de LookML es un diagrama de relación de entidades de un modelo de LookML que representa visualmente las relaciones entre sus objetos de LookML. Usa esta extensión para:

  • Evaluar la estructura del modelo LookML, identificar las áreas en las que se puede consolidar LookML y determinar la mejor manera de agregar el modelo
  • Identificar la lógica incorrecta, lo que reduce las probabilidades de realizar cálculos incorrectos y disminuir el rendimiento de las consultas
  • Aprende a modelar datos basados en código (LookML)

En esta página de documentación, se describe cómo usar la versión 2.0.0 y posteriores del diagrama de LookML. Los administradores de Looker deben consultar la página de documentación Configura la extensión del diagrama de LookML a fin de obtener instrucciones para habilitar esta extensión para los usuarios de Looker.

En esta página, se explica cómo:

Una vez instalado el diagrama de LookML, puede navegar a él haciendo clic en Blocks en el panel de navegación de la izquierda y, luego, seleccionando el mosaico LookML Diagram.

Cómo observar las relaciones de los objetos LookML con el diagrama de LookML

Tu administrador de Looker debe otorgarte permisos para el modelo lookml_diagram y cualquier modelo que desees ver en la extensión.

La extensión del diagrama de LookML consta de los siguientes elementos:

  1. Un panel de Configuración del diagrama para seleccionar un modelo, una rama de Git y una exploración
  2. Un panel View Options (Opciones de vista) para definir mejor los campos que desea ver.
  3. Una sección de Ayuda de diagramas para proporcionar una explicación adicional de los elementos del diagrama
  4. Un recuadro de diagrama para interactuar con los objetos de LookML en el objeto Explorar seleccionado
  5. Una lista de campos de Explorar seleccionada, agrupados por vista
  6. Una barra de herramientas con opciones de zoom y posición, y un ícono para mostrar u ocultar el minimapa del lienzo, lo que ayuda a orientarte dentro de un diagrama más grande
  7. Un Generador de perfiles de objeto para ver información sobre el objeto LookML y navegar a su LookML o Explorar asociados, si corresponde

Haz doble clic en el ícono Diagram Settings (Configuración del diagrama) o el ícono View Options (Opciones de vista) para contraer el panel izquierdo.

Establece la configuración del diagrama

Haz clic en el ícono de diagrama en la barra de navegación del diagrama para mostrar la Configuración del diagrama.

En el menú desplegable Elegir un modelo, se enumeran todos los modelos que tienes permisos para ver. Una vez que hayas seleccionado un modelo, aparecerán dos opciones adicionales:

  • El menú desplegable Current Branch se propaga con una lista de las ramas de Git de ese modelo. Si el modelo tiene solo una rama (por lo general, la rama de producción), se muestra esa rama. Si estás en el modo de producción o si no tienes permisos para cambiar ramas de Git, el menú desplegable Current Branch estará inhabilitado.

    Si tu administrador te otorgó permisos para cambiar ramas de Git en el diagrama de LookML, activa el modo de desarrollo, asegúrate de que un modelo y un explorador estén seleccionados y, luego, selecciona una rama para ver el diagrama según cómo se configure el modelo en esa rama.

  • La lista Seleccionar una exploración se propaga con una lista de las exploraciones de ese modelo. Haga clic en el nombre de Explorar para ver los campos agrupados por vista que se muestran en el lienzo de la página.

Explorar opciones de visualización

Cuando seleccionas Explorar, puedes usar el panel Opciones de vista para restringir los campos y las vistas que se muestran en el lienzo.

Limita los campos que se muestran

Puede elegir que se muestren todos los campos en cada vista de Explorar. Para ello, seleccione Todos los campos en Campos para mostrar o, para mostrar solo las vistas que tienen campos unidos a otros campos, seleccione Campos con uniones.

Si está habilitado, el botón de activación Ocultar campos ocultos oculta cualquier campo que contenga hidden: yes en su LookML subyacente. La opción Ocultar campos ocultos está habilitada de forma predeterminada.

Limita las vistas que se muestran

La sección Vistas del panel Opciones de vista muestra una lista de las vistas presentes en Explorar. De forma predeterminada, todas las vistas se muestran en el recuadro del diagrama. Cuando oculta una vista, el objeto de vista y cualquier unión que conecta ese objeto de vista con cualquier otro objeto de la exploración se ocultan en el lienzo del diagrama.

Haga clic en Ocultar todo para ocultar todas las vistas en Explorar del lienzo del diagrama. Haga clic en Mostrar todo para mostrar todas las vistas de esa pestaña Explorar.

También puedes ocultar vistas individuales del lienzo anulando la selección del ícono de ojo que se encuentra a la derecha del nombre de la vista. Cuando la vista está oculta, el nombre aparece atenuado y el ícono del ojo tiene una barra diagonal. Para mostrar una vista oculta individual, haz clic en el ícono de la barra diagonal.

Interpreta el lienzo del diagrama

En el lienzo del diagrama de LookML, se muestran todas las entidades y relaciones de un objeto Explorar específico. En el lenguaje de Looker, puede pensar en el diagrama de LookML como una representación de cómo los objetos LookML se unen en Explorar para un modelo determinado.

La barra de título del objeto en la parte superior del lienzo muestra el nombre de Explorar, cuyas vistas se muestran en él. Haz clic en el ícono de información de Explorar (un círculo "i") en la barra de título del objeto para abrir el Generador de perfiles de objeto y obtener más información sobre la función Explorar seleccionada. Haz clic en la flecha de la derecha para volver a cargar la extensión.

Entidades

Cada vista de Explorar se representa como su propio conjunto de entidades. El nombre de la vista aparece en la parte superior del conjunto:

  1. La vista base de Explorar se indica con un fondo azul oscuro.
  2. Las vistas unidas en Explorar tienen un fondo celeste.

  3. Cuando se selecciona una unión, una vista o un campo, se destacan en azul brillante.

    Debajo de cada vista, hay una lista de los campos que pertenecen a esa vista:

  4. Las dimensiones se muestran en la parte superior.

  5. Las medidas aparecen en la parte inferior, destacadas en naranja claro.

  6. Si el campo es una clave primaria, aparece un ícono de clave a la derecha del nombre del campo.

A la izquierda de cada campo hay un ícono que indica su tipo:

  • A: dimensiones de type: string
  • #: dimensiones o medidas de type: number
  • Barras en niveles: dimensiones de type: tier
  • Marca de verificación: dimensiones de type: yesno
  • Calendario: dimensiones de type: date, type: date_time, type: time
  • Punto en el mapa: dimensiones de type: location, type: distance, type: zipcode

Haz clic en el nombre del campo para abrir el Generador de perfiles de objeto y obtener más información sobre el campo seleccionado.

Relaciones

En el diagrama, se usa una línea para mostrar cómo se relaciona cada objeto con otro del modelo seleccionado. La forma de la línea, donde se adjunta a la vista o al campo, transmite la cardinalidad de la relación entre los dos objetos; una línea bifurcada indica una cardinalidad de "muchos", y una sola línea indica una cardinalidad. Leerías la relación como desde la vista base hasta la vista unida. Por ejemplo:

  1. Una unión uno a uno de order_items a inventory_items, que se une en el campo id
  2. Una unión de varios a uno de order_items a repeat_purchase_facts

También puedes colocar el cursor sobre la línea para ver qué relación de tipo de unión conecta los dos objetos.

Haz clic en la línea para abrir el Generador de perfiles de objeto a fin de obtener más información sobre la unión.

Opciones de visualización de Canvas

Un minimapa en la esquina superior derecha del lienzo puede ayudar a orientar tu ubicación dentro de diagramas más grandes, con la parte atenuada del mapa que indica qué parte del diagrama se muestra actualmente en el lienzo. Haz clic en el espacio vacío en el lienzo y arrástralo para moverlo a otras partes del diagrama.

Una barra de herramientas vertical en la parte inferior izquierda del recuadro contiene íconos para controlar la visualización del diagrama:

  • Haga clic en el signo (+) para acercar la imagen y (-) para alejarla del diagrama.
  • Haz clic en el ícono cuadrado para volver a la posición inicial predeterminada del diagrama.
  • Haz clic en el ícono de mapa para habilitar o inhabilitar el minimapa.

Visualiza información de objetos con el generador de perfiles de objetos

El Generador de perfiles de objeto muestra información sobre el objeto seleccionado. Haz clic en cualquier vista, vista, campo o combinación en el lienzo del diagrama para abrir el Generador de perfiles de objeto en el lado derecho del lienzo. Haz clic en el recuadro para contraer el Generador de perfiles de objetos.

Explora

Haz clic en el ícono de información de Explorar (el ícono de información rodeado) en el lado derecho de la barra de título del objeto.

Para el explorador seleccionado en el panel Configuración del diagrama, el Generador de perfiles de objeto muestra lo siguiente:

  • Etiqueta: El valor de Explorar label.
  • Etiqueta de grupo: El valor del parámetro group_label, que combina la función Explorar en grupos personalizados en el menú Explorar de Looker. Si no se define una etiqueta de grupo para Explorar, el valor predeterminado es el nombre del modelo.
  • Nombre del proyecto: Es el nombre del proyecto de LookML, como se define en la configuración del proyecto.
  • Nombre de la conexión: El valor del parámetro connection, que especifica la conexión de base de datos desde la que un modelo recuperará datos.

Si tienes permisos para ver LookML, puedes hacer clic en Go to LookML en la parte inferior izquierda del Generador de perfiles de objeto a fin de abrir el archivo en el que se define Explorar. El archivo se abrirá en una nueva pestaña del navegador con la línea explore destacada.

Vistas

Haz clic en una vista desde el lienzo del diagrama.

El Generador de perfiles de objeto muestra el Nombre de la tabla de SQL si está definido en el LookML de la vista. Si no se define sql_table_name para la vista, el Nombre de la tabla de SQL se muestra como unknown.

Si tienes permisos para ver LookML, puedes hacer clic en Go to LookML en la parte inferior izquierda del Generador de perfiles de objeto a fin de abrir el archivo en el que se define la exploración a la que se une la vista. El archivo se abrirá en una nueva pestaña del navegador con la línea explore destacada.

Campos

Haz clic en un campo del lienzo del diagrama.

El Generador de perfiles de objeto muestra el nombre, el tipo y el valor de tipo del campo, y si el campo es una clave primaria en la parte superior del panel. Dos pestañas en el generador de perfiles (Detalles y Código) muestran información adicional sobre el campo.

En la pestaña Detalles, puedes ver lo siguiente:

  • Nombre de la vista: el nombre de la vista a la que pertenece el campo.
  • Etiqueta: Indica cómo el campo aparecerá en la sección Datos de una exploración, que es el nombre o la etiqueta de la vista seguida del nombre o la etiqueta del campo.
  • Distribución: Para las dimensiones numéricas de una vista con una medida que tiene type: count, haz clic en Calcular a fin de mostrar una vista previa de un gráfico de columnas que representa la distribución de los valores del recuento. La sección Distribución también muestra los valores mínimo, máximo y medio de la serie de dimensiones numéricas.
  • Valores: Para las dimensiones numéricas de una vista con una medida que tiene type: count, haz clic en Calcular a fin de mostrar una vista previa de los valores de recuento. Haz clic en Explorar más para abrir la exploración a la que pertenece este campo.

En la pestaña Código, puede ver el parámetro de campo y los subparámetros.

Si tienes permisos para ver LookML, puedes hacer clic en Go to LookML en la parte inferior izquierda del Generador de perfiles de objeto a fin de abrir el archivo en el que se define la unión. El archivo se abrirá en una nueva pestaña del navegador en la línea para la exploración de unión.

Si tienes permisos para explorar datos, haz clic en Explorar con campo en la parte inferior derecha del Generador de perfiles de objeto a fin de abrir un campo Explorar con ese campo preseleccionado en el selector de campo Explorar.

Combinaciones

Haz clic en una unión desde el recuadro del diagrama.

El Generador de perfiles de objeto muestra la declaración JOIN que describe la relación de unión y el tipo y cardinalidad de la unión.

Si tienes permisos para ver LookML, puedes hacer clic en Go to LookML en la parte inferior izquierda del Generador de perfiles de objeto a fin de abrir el archivo en el que se define la unión. El archivo se abrirá en una nueva pestaña del navegador en la línea para la exploración de unión.