Cómo usar el diagrama de LookML

El diagrama de LookML es una extensión, una aplicación web compilada con componentes de Looker, desarrollada con el framework de extensión de Looker e implementada mediante el Marketplace de Looker.

El diagrama de LookML es un diagrama de entidades y relaciones de un modelo de LookML que representa de forma visual 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 que los cálculos sean incorrectos y el rendimiento de las consultas sea deficiente
  • Aprende a realizar modelos de 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 posterior 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 analiza cómo hacer lo siguiente:

Después de que se haya instalado el diagrama de LookML, puede navegar al diagrama de LookML haciendo clic en Blocks (Bloques) en el panel de navegación izquierdo y seleccionando el mosaico LookML Diagram.

Cómo observar las relaciones de objetos de 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 Diagram Settings para seleccionar un modelo, una rama Git y una Explorar
  2. Un panel de Opciones de vista para definir mejor los campos que desea ver.
  3. Una sección de la Ayuda del diagrama para proporcionar una explicación adicional de los elementos del diagrama.
  4. Un lienzo de diagrama para interactuar con los objetos de LookML en Explorar
  5. Una lista seleccionada de campos de Explorar, agrupadas 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 que te orientes 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 su LookML o Explore asociado, si corresponde

Haz doble clic en el ícono Configuración de diagrama o el ícono Opciones de vista para contraer el panel izquierdo.

Cómo establecer la configuración del diagrama

Haga clic en el ícono del 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 puedes ver en permisos. Después de seleccionar un modelo, aparecerán dos opciones adicionales:

  • El menú desplegable Current Branch (Rama actual) se propaga con una lista de las ramas del 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 no tienes permisos para cambiar las ramas de Git, el menú desplegable Current Branch estará inhabilitado.

    Si el administrador te otorgó permisos para cambiar ramas de Git en el diagrama de LookML, activa el modo de desarrollo, asegúrate de que se seleccionen un modelo y Explorar, y luego selecciona una rama para ver el diagrama según la configuración del modelo en esa rama.

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

Explora opciones de visualización

Con la función Explorar seleccionada, 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 mostrar todos los campos de cada vista de la herramienta Explorar. Para ello, seleccione Todos los campos en Campos para mostrar o, para mostrar solo las vistas que tengan 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. 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 Explorar. De forma predeterminada, todas las vistas se muestran en el lienzo del diagrama. Cuando oculta una vista, el objeto de vista y todas las uniones que conectan ese objeto de vista a cualquier otro objeto en Explorar se ocultan del 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 que se muestren todas las vistas de Explorar.

También puedes ocultar vistas individuales del lienzo anulando la selección del ícono del ojo que se encuentra a la derecha del nombre de la vista. Cuando se oculta la vista, el nombre aparece inhabilitado y el ícono del ojo tiene una barra. 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 una exploración específica. En la ventana de Looker, puede ver el diagrama de LookML como una representación de cómo los objetos de 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, que es una “i” dentro de la barra de título del objeto, para abrir el Generador de perfiles de objeto y obtener más información sobre la herramienta Explorar 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 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 destaca en azul.

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

  4. Las dimensiones se muestran en la parte superior.

  5. Las medidas 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 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 del 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 ilustrar cómo cada objeto se relaciona con otro en el 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 "muchos", y una sola línea indica una cardinalidad "una". Debe leer 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 unirá 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é tipo de relación de tipo de unión conecta los dos objetos.

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

Opciones de visualización de Canvas

Un minimapa en la parte superior derecha del lienzo puede ayudar a orientar su ubicación dentro de los diagramas más grandes. La parte inhabilitada del mapa indica qué parte del diagrama se muestra actualmente en el lienzo. Haz clic en el espacio vacío del 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:

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

Cómo ver la información de los objetos con el generador de perfiles de objetos

El Generador de perfiles de objeto muestra información sobre el objeto seleccionado. Haga clic en cualquier lienzo para explorar, ver o completar un campo, o unirse a él a fin de abrir el Generador de perfiles de objeto en el lado derecho. Haz clic en el lienzo para contraer el Generador de perfiles de objeto.

Exploraciones

Haz clic en el ícono de información de Explorar, que es una “i” enmarcada a la derecha de la barra de título del objeto.

En el caso de la pestaña Explorar seleccionada en el panel Diagram Settings, el Generador de perfiles de objeto muestra la siguiente información:

  • Etiqueta: Es el valor de Explorar label.
  • Group Group: Es el valor del parámetro group_label, que combina las exploraciones en grupos personalizados en el menú Browse de Looker. Si no se define una etiqueta de grupo para Explorar, el valor predeterminado 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 base de datos a partir de la cual el modelo recuperará datos.

Si tienes permiso 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 función Explorar. El archivo se abrirá en una nueva pestaña del navegador con la línea para explore destacada.

Vistas

Haz clic en una vista del lienzo del diagrama.

El Generador de perfiles de objeto muestra el Nombre de 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 permiso 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 unió la vista. El archivo se abrirá en una nueva pestaña del navegador con la línea para 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. Hay dos pestañas en el generador de perfiles, Detalles y Código, que muestran información adicional sobre el campo.

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

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

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

Si tienes permiso 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 de Explorar de la unión.

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

Combinaciones

Haga clic en una unión en el lienzo del diagrama.

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

Si tienes permiso 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 de Explorar de la unión.