El diagrama de LookML es una extensión (una aplicación web creada con componentes de Looker) desarrollada con el framework de extensión de Looker y, luego, implementada a través del Mercado de Looker.
El diagrama de LookML es un diagrama de entidad-relación de un modelo de LookML que representa visualmente las relaciones entre sus objetos de LookML. Usa esta extensión para lo siguiente:
- Evalúa la estructura del modelo de LookML, identifica las áreas en las que se puede consolidar LookML y determina la mejor manera de agregarlo al modelo.
- Identifica la lógica incorrecta, lo que reduce las posibilidades de cálculos incorrectos y un rendimiento deficiente de las consultas
- Aprende a realizar el modelado de datos basado en código (LookML)
En esta página de documentación, se describe cómo usar el diagrama de LookML versión 2.0.0 y versiones posteriores. Los administradores de Looker deben consultar la página de documentación Configurar la extensión de diagrama de LookML para obtener instrucciones sobre cómo habilitar esta extensión para los usuarios de Looker.
En esta página, se explica cómo hacer lo siguiente:
- Cómo navegar al diagrama de LookML
- Observa las relaciones de los objetos de LookML con el diagrama de LookML
- Configura la configuración del diagrama
- Cómo configurar las opciones de vista de una exploración
- Cómo interpretar el lienzo del diagrama
- Observa la información de los objetos con el Generador de perfiles de objetos
Cómo navegar al diagrama de LookML
Después de instalar el diagrama de LookML, puedes navegar a él haciendo clic en Bloques en el panel de navegación de la izquierda y, luego, seleccionando la tarjeta Diagrama de LookML.
Observa las relaciones de los objetos de LookML con el diagrama de LookML
Tu administrador de Looker debe otorgarte permisos para el modelo lookml_diagram y cualquier modelo que quieras ver en la extensión.
La extensión de diagrama de LookML consta de los siguientes elementos:
- Un panel Diagram Settings para seleccionar un modelo, una rama de Git y una Explorar
- Un panel View Options para definir mejor los campos que deseas ver
- Una sección Ayuda del diagrama para proporcionar una explicación adicional de los elementos del diagrama
- Un lienzo de diagrama para interactuar con los objetos de LookML en la exploración seleccionada
- Una lista de campos de Explorar seleccionada, agrupada por vista
- Una barra de herramientas con opciones de zoom y posición, y un ícono para mostrar o ocultar el minimapa del lienzo, que te ayuda a orientarte dentro de un diagrama más grande
- Un generador de perfiles de objetos para ver información sobre el objeto de LookML y navegar a su LookML o Exploración asociada, si corresponde
Haz doble clic en el ícono Diagram Settings o en el ícono View Options para contraer el panel izquierdo.
Cómo configurar el 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 muestran todos los modelos para los que tienes permisos de visualización. Una vez que selecciones un modelo, aparecerán dos opciones adicionales:
El menú desplegable Current Branch se completa 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 modo de producción o no tienes permisos para cambiar las ramas de Git, el menú desplegable Rama actual estará inhabilitado.
Si tu administrador te otorgó permisos para cambiar las ramas de Git en el diagrama de LookML, activa el modo de desarrollo, asegúrate de que se seleccionen 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 función Explorar se completará con una lista de las funciones Explorar 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.
Explora las opciones de visualización
Con una exploración seleccionada, puedes usar el panel Opciones de vista para restringir qué campos y vistas se muestran en el lienzo.
Limitación de los campos que se muestran
Para mostrar todos los campos en cada vista de Explorar, selecciona Todos los campos en Campos para mostrar. O bien, para mostrar solo las vistas que tienen campos unidos a otros, selecciona 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.
Limita las vistas que se muestran
En la sección Vistas del panel Opciones de vista, se 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 a cualquier otro objeto de Explorar se ocultan del lienzo del diagrama.
Haz clic en Ocultar todo para ocultar todas las vistas de Explorar del lienzo del diagrama. Haz clic en Mostrar todo para mostrar todas las vistas en esa exploración.
También puedes ocultar vistas individuales del lienzo de forma selectiva si anulas 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 de la vista aparece inhabilitado y el ícono de ojo tiene una barra diagonal. Para mostrar una vista oculta individual, haz clic en el ícono de ojo tachado.
Interpretación del lienzo del diagrama
En el lienzo del diagrama de LookML, se representan todas las entidades y relaciones de una exploración determinada. En el lenguaje de Looker, puedes pensar en el diagrama de LookML como una representación de cómo 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" en un círculo) en la barra del título del objeto para abrir el Profiler 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 Explorar se representa como su propio conjunto de entidades, y el nombre de la vista aparece en la parte superior del conjunto:
- La vista base de Explorar se indica con un fondo azul oscuro.
- Las vistas unidas en Explorar tienen un fondo azul claro.
Cuando se selecciona una unión, una vista o un campo, se destacan en un azul brillante.
Debajo de cada vista, se muestra una lista de los campos que pertenecen a esa vista:
Las dimensiones se muestran en la parte superior.
Las medidas se enumeran en la parte inferior y se destacan en naranja claro.
Si el campo es una clave primaria, aparecerá 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 - #: Son las dimensiones o mediciones 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_timeytype: 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 conecta 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 "varios", y una línea única indica una cardinalidad de "uno". La relación se leería como desde la vista base hasta la vista unida. Por ejemplo:
- Una unión uno a uno de
order_itemsainventory_items, que se une en el campoid - Una unión de varios a uno de
order_itemsarepeat_purchase_facts
También puedes colocar el cursor sobre la línea para ver qué tipo de unión conecta los dos objetos.
Haz clic en la línea para abrir el Perfilador de objetos y ver más información sobre la unión.
Opciones de visualización del lienzo
Un minimapa en la parte superior derecha del lienzo puede ayudarte a orientar tu posición dentro de diagramas más grandes, ya que la parte del mapa inhabilitada indica qué parte del diagrama se muestra actualmente en el lienzo. Haz clic y arrastra el espacio vacío del 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 (+) para acercar el diagrama y en (-) para alejarlo.
- 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.
Cómo ver la información de los 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 elemento de exploración, vista, campo o unión del 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" en un círculo) que se encuentra en el lado derecho de la barra del título del objeto.
Para la opción Explorar seleccionada en el panel Configuración del diagrama, el generador de perfiles de objetos muestra lo siguiente:
- Etiqueta: Es el valor de Explorar
label. - Etiqueta de grupo: Es el valor del parámetro
group_label, que combina las exploraciones en grupos personalizados en el menú Explorar de Looker. Si no se define una etiqueta de grupo para Explorar, el nombre del modelo se establece de forma predeterminada. - Nombre del proyecto: Es el nombre del proyecto de LookML, tal como se define en la configuración del proyecto.
- Nombre de la conexión: Es el valor del parámetro
connection, que especifica la conexión a 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 perfilador de objetos para abrir el archivo en el que se define la exploración. El archivo se abrirá en una nueva pestaña del navegador con la línea de explore destacada.
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 código LookML de la vista. Si no se define ningún 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 Perfilador de objetos para 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 de explore destacada.
Campos
Haz clic en un campo del lienzo del diagrama.
El generador de perfiles de objetos muestra el nombre, el tipo y el valor del campo, y si es una clave primaria en la parte superior del panel. Dos pestañas del 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: 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, que es el nombre o la etiqueta de la vista, seguido del nombre o la etiqueta del campo.
- Distribución: En el caso de las dimensiones numéricas de una vista con una medida que tiene
type: count, haz clic en Calcular para mostrar una vista previa de un gráfico de columnas que representa la distribución de los valores de 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: En el caso de las dimensiones numéricas de una vista con una métrica que tiene
type: count, haz clic en Calcular para mostrar una vista previa de los valores de recuento. Haz clic en Explorar más para abrir la función Explorar a la que pertenece este campo.
En la pestaña Código, 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 Perfilador de objetos para 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 campo en la parte inferior derecha del Perfilador de objetos para abrir una exploración con ese campo preseleccionado en el selector de campos de exploración.
Uniones
Haz clic en una unión del lienzo del diagrama.
El Generador de perfiles de objetos muestra la sentencia de unión que describe la relación de unión y el tipo y la cantidad de la unión.
Si tienes permisos para ver LookML, puedes hacer clic en Ir a LookML en la parte inferior izquierda del Perfilador de objetos para 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.