Usa el diagrama de LookML

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

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

  • Evaluar la estructura del modelo de LookML mediante la identificación de las áreas en las que se puede consolidar LookML y determinar la mejor manera de agregarlo al modelo
  • Identificar la lógica incorrecta, lo que reduce las posibilidades de que se produzcan cálculos incorrectos y que el rendimiento de las consultas sea deficiente
  • 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 hacer lo siguiente:

Después de instalar el diagrama de LookML, puedes navegar a él haciendo clic en Bloques en el panel de navegación izquierdo y, luego, seleccionando el mosaico Diagrama de LookML.

Observa las relaciones de objetos de LookML con el diagrama de LookML

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

La extensión del diagrama de LookML consta de estos elementos:

  1. Un panel de Diagram Settings para seleccionar un model, una rama de Git y un Explore
  2. El panel View Options (Opciones de vista) para definir mejor los campos que deseas ver.
  3. Una sección de Ayuda de diagrama para dar una explicación adicional de los elementos del diagrama
  4. Un lienzo del diagrama para interactuar con los objetos de LookML en la exploración seleccionada
  5. La lista de campos de Explorar seleccionados, agrupados por vista
  6. Una barra de herramientas con opciones de zoom y posición, y un ícono para ocultar o mostrar el minimapa de lienzo, que ayuda a orientarte dentro de un diagrama más grande
  7. Un Generador de perfiles de objetos para ver información sobre el objeto LookML y navegar a sus objetos LookML o Explore asociados, si corresponde

Haz doble clic en el ícono de Diagram Settings o en el de View Options para contraer el panel izquierdo.

Cómo establecer 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 para los que tienes permisos. Una vez que selecciones 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 una sola rama (por lo general, la rama production), se muestra esa rama. Si estás en modo de producción o si no tienes permisos para cambiar ramas de Git, el menú desplegable Current Branch estará inhabilitado.

    Si el administrador te otorgó permisos para cambiar las ramas de Git en el diagrama de LookML, activa el Modo de desarrollo, asegúrate de que estén seleccionados un modelo y una Exploración y, luego, selecciona una rama para ver el diagrama según la configuración del modelo en esa rama.

  • La lista Seleccionar una exploración se propaga con una lista de Exploraciones de ese modelo. Haz clic en el nombre de una exploración para ver sus campos, agrupados por vista, que se muestran en el lienzo de la página.

Explorar opciones de visualización

Cuando una exploración está seleccionada, puedes usar el panel Opciones de vista (View Options) para restringir los campos y las vistas que se muestran en el lienzo.

Limita los campos que se muestran

Puedes elegir mostrar todos los campos en cada vista de la exploración seleccionando Todos los campos en Campos para mostrar o, para mostrar solo las vistas que tienen campos unidos a otros campos, selecciona Campos con uniones.

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

Cómo limitar las vistas que se muestran

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

Haz clic en Ocultar todo para ocultar todas las vistas de Explorar en el lienzo del diagrama. Haz clic en Mostrar todo para mostrar todas las vistas de esa exploración.

También puedes ocultar selectivamente vistas individuales del lienzo anulando la selección del ícono del ojo a la derecha del nombre de la vista. Si la vista está oculta, el nombre de la vista se mostrará de color gris y tendrá una barra sobre el ícono del ojo. Para mostrar una vista individual oculta, haz clic en el ícono de ojo tachado.

Interpreta el lienzo del diagrama

En el lienzo del diagrama de LookML, se representan todas las entidades y relaciones de una exploración determinada. En la versión vernácula de Looker, puedes pensar en el diagrama de LookML como en la forma en que los objetos de LookML se unen en una exploración para un modelo determinado.

La barra de título del objeto en la parte superior del lienzo muestra el nombre de la exploración cuyas vistas se muestran en el lienzo. Haz clic en el ícono de información de Explorar (una "i" rodeada de un círculo) en la barra de título del objeto para abrir el Generador de perfiles de objetos y obtener más información sobre la exploración seleccionada. Haz clic en la flecha en el sentido de las manecillas del reloj para volver a cargar la extensión.

Entidades

Cada vista de la exploración se representa como su propio conjunto de entidades, y el nombre de la vista aparece en la parte superior del conjunto:

  1. La vista base de la exploración 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, estos se destacan en color azul brillante.

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

  4. Las dimensiones se muestran en la parte superior.

  5. Las mediciones se enumeran en la parte inferior y se destacan 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 con niveles: dimensiones de type: tier
  • Marca de verificación: dimensiones de type: yesno
  • Calendario: dimensiones de type: date, type: date_time y type: time
  • Punto del mapa: dimensiones de type: location, type: distance, type: zipcode

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

Relaciones

El diagrama usa una línea para representar cómo se relaciona cada objeto con otro en el modelo seleccionado. La forma de la línea, donde se adjunta a la vista o el campo, transmite la cardinalidad de la relación entre los dos objetos; una línea bifurcada indica una cardinalidad "varios" y una sola línea indica una cardinalidad "uno". Leerías la relación como desde la vista base a 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. 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 objetos y ver más información sobre la unión.

Opciones de visualización del lienzo

Un minimapa en la esquina superior derecha del lienzo puede ayudarte 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 y arrastra el espacio vacío en el lienzo para moverte a otras partes del diagrama.

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

  • Haz clic en el signo (+) para acercar la imagen y en el signo (-) para alejar el 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 la información de objetos con el Generador de perfiles de objetos

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

Exploraciones

Haz clic en el ícono de información de Explorar (una "i" rodeada de un círculo) que se encuentra a la derecha de la barra de título del objeto.

Para la exploración seleccionada en el panel Diagram Settings, el Generador de perfiles de objetos muestra lo siguiente:

  • Etiqueta: El valor de Explorar label
  • Etiqueta de grupo: Es el valor del parámetro group_label, que combina exploraciones en grupos personalizados en el menú Explorar de Looker. Si no se define una etiqueta de grupo para la exploración, la configuración predeterminada será 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 la base de datos desde la que un modelo recuperará datos.

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

Vistas

Haz clic en una vista del lienzo del diagrama.

El Generador de perfiles de objetos muestra el Nombre de la tabla de SQL si se define en el LookML de la vista. Si no se define un 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 Ir a LookML, en la parte inferior izquierda del Generador de perfiles de objetos, para abrir el archivo en el que se define la exploración con la que se une la vista. El archivo se abrirá en una pestaña nueva del navegador y se destacará la línea para la explore.

Campos

Haz clic en un campo del lienzo del diagrama.

En la parte superior del panel, el Generador de perfiles de objetos muestra el nombre, el tipo y el valor del campo, y si el campo es una clave primaria. Dos pestañas del generador de perfiles, Details y Code, muestran información adicional sobre el campo.

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

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

En la pestaña Code, puedes ver el parámetro de campo y los subparámetros.

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

Si tienes permisos para explorar datos, haz clic en Explore with Field, en la parte inferior derecha del Generador de perfiles de objetos, para abrir una exploración con ese campo preseleccionado en el selector de campos de Explore.

Combinaciones

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

El Generador de perfiles de objetos muestra la instrucción de unión que describe la relación de unión y el tipo y la cardinalidad de la unión.

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