Usa el diccionario de datos de Looker

El diccionario de datos de Looker es diferente del bloque del diccionario de datos.

Para disfrutar de la funcionalidad completa de la extensión del diccionario de datos de Looker, los administradores deben actualizar esta aplicación a la versión 2.0.0 o posterior.

El diccionario de datos de Looker 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.

La extensión del diccionario de datos de Looker proporciona una interfaz centralizada y dedicada para realizar búsquedas en todos tus campos y descripciones de Looker. Usa esta extensión para lo siguiente:

  • Proporciona un directorio en el que se pueden buscar todas las métricas y descripciones para que los usuarios identifiquen la dimensión o medida adecuada para su análisis
  • Facilitar a las partes interesadas externas la identificación y ubicación de métricas únicas
  • Audita los modelos de LookML para evaluar si se siguen las convenciones de nomenclatura coherentes, si hay campos redundantes o si los campos están anotados con descripciones
  • Agregar y compartir comentarios sobre campos específicos (si tu aplicación de diccionario de datos de Looker está en la versión 2.0.0 o posterior)

Para que los usuarios accedan al diccionario de datos de Looker y lo usen, los administradores de Looker deben hacer lo siguiente:

  1. Habilita las funciones adecuadas.
  2. Instala la extensión de diccionario de datos de Looker.
  3. Otorga permisos para acceder al diccionario de datos de Looker.

Una vez que la extensión está disponible para los usuarios, puedes hacer lo siguiente:

  1. Navega al diccionario de datos de Looker.
  2. Visualiza los metadatos de tu modelo.

Instala el diccionario de datos de Looker

Antes de instalar el diccionario de datos de Looker desde Marketplace, los administradores de Looker deben habilitar estas funciones:

  • Marketplace: Para acceder a Looker Marketplace (habilitado de forma predeterminada)
  • Framework de extensiones: Se usa para implementar extensiones desarrolladas con el framework de extensiones de Looker (habilitado de forma predeterminada).

Para instalar aplicaciones y herramientas (como extensiones) desde Marketplace, debes tener los permisos develop, manage_models y deploy.

Consulta la documentación sobre el uso de Looker Marketplace si necesitas instrucciones para instalar una herramienta desde Looker Marketplace. Para asegurarte de tener siempre la versión más reciente del diccionario de datos, ve a Looker Marketplace, selecciona Administrar y elige el botón Actualizar junto a la extensión.

Otorga permisos para acceder al diccionario de datos de Looker

Después de instalar el diccionario de datos de Looker, se agrega automáticamente un modelo llamado data-dictionary a la lista de modelos disponibles en las páginas Conjunto de modelos nuevo y Editar conjunto de modelos, a las que se puede acceder desde la página Roles del panel Administrador.

Los administradores de Looker deben otorgar a los usuarios permisos explore o develop para acceder al modelo data-dictionary y a cualquier modelo que deban explorar en el diccionario de datos. Consulta la página de documentación Configura los permisos de las extensiones de Looker si deseas obtener información sobre cómo otorgar permisos a los usuarios para acceder a las extensiones y usarlas.

Otorga permisos para interactuar con los comentarios del campo

Los comentarios de campo proporcionan a los usuarios la capacidad de agregar contexto a las definiciones de campo sin tener que actualizar LookML. De forma predeterminada, todos los usuarios que tengan acceso a la extensión del diccionario de datos podrán ver todos los comentarios y agregar, editar y borrar sus propios comentarios.

Si lo desean, los administradores de Looker pueden administrar la forma en que los usuarios interactúan con la función de comentarios en el campo. Para ello, deben crear grupos de usuarios específicos en la página Grupos del panel Administrador y asignar usuarios a esos grupos. Consulta la página de documentación de Grupos para obtener más información sobre cómo asignar usuarios a grupos.

Los administradores de Looker deben crear estos grupos con los nombres predefinidos, como se muestra a continuación.

Los grupos de usuarios se deben crear con los nombres predefinidos que se muestran en la siguiente tabla. En la tabla, también se muestran los privilegios predefinidos que tendrán los usuarios asignados a cada grupo.

Nombre del grupo Privilegios
marketplace_data_dictionary_comments_disabled Los usuarios no pueden ver los comentarios ni interactuar de ninguna otra manera con ellos; todas las funciones de comentarios están inhabilitadas. Los privilegios de este grupo siempre tienen prioridad sobre los de otros grupos. Los usuarios incluidos en el grupo disabled no tendrán acceso a la función de comentarios, incluso si también pertenecen a otro grupo que tiene privilegios más elevados.
marketplace_data_dictionary_comments_reader El usuario puede ver los comentarios existentes, pero no puede agregar ninguno.
marketplace_data_dictionary_comments_writer Los usuarios pueden ver todos los comentarios, agregar nuevos, y editar o borrar los suyos. Este es el privilegio predeterminado.
marketplace_data_dictionary_comments_manager Los usuarios pueden ver todos los comentarios, agregar comentarios nuevos y editar o borrar todos los comentarios.

Si un usuario no pertenece a ninguno de estos grupos, se establecerá como writer de forma predeterminada. Si un usuario se asigna a varios grupos (sin incluir marketplace_data_dictionary_comments_disabled), prevalecerá su privilegio más elevado.

Los cambios que se realicen en un grupo de comentarios, como agregar o quitar un usuario, que se realicen desde la página Grupos del panel Administrador, se aplicarán después de una actualización forzada de la página Diccionario de datos o cuando el usuario seleccione otra opción y, luego, vuelva a la página de diccionario de datos.

Puedes navegar al diccionario de datos desde la lista de aplicaciones y extensiones instaladas en la barra lateral izquierda.

Visualiza metadatos del modelo con el diccionario de datos de Looker

En el diccionario de datos de Looker, los usuarios con permisos explore sobre un modelo pueden seleccionar este model y ver sus metadatos, incluidas sus Exploraciones y la lista de campos de cada exploración, agrupados por vista. El diccionario de datos de Looker muestra las exploraciones del modelo seleccionado en la barra lateral izquierda y las vistas y los campos de la exploración seleccionados en la parte principal de la página.

Los usuarios pueden seleccionar el ícono < para contraer la barra lateral.

El diccionario de datos de Looker muestra lo siguiente:

  1. El nombre del modelo seleccionado
  2. La lista de exploraciones que contiene el modelo seleccionado
  3. La exploración seleccionada
  4. Un campo de texto para filtrar los campos en una exploración
  5. Filtros rápidos para acotar los campos que se muestran en función de las características seleccionadas
  6. El nombre de la vista
  7. Metadatos sobre cada campo. Para seleccionar los metadatos que se muestran, haz clic en el botón Opciones de vista. Consulta el conjunto completo de metadatos del campo en el generador de perfiles de campo.
  8. Filas que contienen metadatos para cada campo en una vista determinada
  9. Navegación a Explorar en la IU de Looker

Cómo seleccionar un modelo y una exploración

En el menú desplegable Seleccionar un modelo, se enumeran todos los modelos para los que un usuario tiene permisos explore. Cuando elijas un modelo en el menú desplegable Seleccionar un modelo, la barra lateral izquierda se propagará con una lista de las exploraciones de ese modelo.

También puedes buscar el modelo seleccionado para una exploración específica escribiendo en el cuadro de búsqueda Buscar modelo. Se filtrará la lista de exploraciones para mostrar solo los resultados que coincidan con tus términos de búsqueda.

Selecciona el nombre de una exploración para ver sus campos, agrupados por vista, que se muestran en la parte principal de la página.

También puedes seleccionar el botón Explorar en la esquina superior derecha para ir directamente a la página Explorar en Looker.

Filtra campos en una exploración

Si quieres filtrar los campos que se muestran, escribe el texto en el cuadro Filtrar campos en esta exploración para que coincida con la Etiqueta del campo o la Descripción de la lista de campos.

También puedes seleccionar atributos de metadatos específicos para filtrar, por ejemplo, si el campo cumple con las siguientes condiciones:

Visualiza los metadatos de campos

En el diccionario de datos de Looker, se muestran los metadatos de los campos de una exploración, agrupados por vista:

Personaliza los metadatos que se muestran

Para especificar qué metadatos se muestran en cada campo, selecciona el botón Opciones de vista en la esquina superior derecha y marca o desmarca las casillas de los metadatos que deseas ver.

Cómo usar comentarios en el campo

Si una instancia ya tiene Marketplace, los administradores deben asegurarse de que la extensión de diccionario de datos esté en la versión 2.0.0 o posterior para usar comentarios a nivel del campo.

Los desarrolladores de LookML a menudo incluyen información adicional o explicaciones sobre los campos de un modelo en el parámetro description a nivel de campo. Sin embargo, estas descripciones no siempre son significativas o útiles para todos los usuarios. Con los comentarios a nivel de campo, los usuarios pueden agregar contexto a un campo específico. Otros usuarios pueden ver estos comentarios, pero no afectarán el LookML subyacente del modelo.

Los administradores deben otorgar a los usuarios la capacidad de interactuar con los comentarios agregándolos a grupos específicos en la página Grupos del panel Administrador. De forma predeterminada, todos los usuarios con acceso a la extensión del diccionario de datos pueden ver todos los comentarios y agregar, editar y borrar sus propios comentarios.

Cómo agregar un comentario de campo

Para agregar un comentario a un campo, haz lo siguiente:

  1. Coloca el cursor sobre la fila del campo para mostrar un ícono + (si no hay comentarios en el campo existentes) o un ícono de bloc de notas (si el campo tiene comentarios existentes). Haz clic en el ícono para abrir la pestaña Comments del panel del generador de perfiles de campos.
  2. Haz clic en el botón Agregar comentario.
  3. Escribe tu comentario y selecciona el botón Comentar para guardar la entrada. Haz clic en Cancel para cerrar el generador de perfiles de campo. Para expandir el cuadro del comentario, selecciona y arrastra la esquina inferior derecha.

Una vez que se agrega un comentario, este aparece en la pestaña Comentarios del generador de perfiles de campos y otros usuarios pueden verlo.

Cómo ver los comentarios del campo

Cuando un campo incluye comentarios, aparece un ícono de bloc de notas con el número de comentarios que existen en ese campo. Haz clic en el ícono de bloc de notas para ver los comentarios del campo enumerados en la pestaña Comments del generador de perfiles de campos.

La cantidad de comentarios de ese campo también se indica entre paréntesis en la pestaña Comentarios. Cada entrada de comentario muestra la siguiente información:

  • El nombre del comentarista
  • La marca de tiempo que muestra cuándo se agregó el comentario
  • Vista previa del comentario

Editar o borrar el comentario de un campo

Para editar o borrar los comentarios de tu campo, sigue estos pasos:

  1. Selecciona el ícono de bloc de notas del campo.
  2. En la pestaña Comentarios, ubica el comentario que quieres editar o borrar y coloca el cursor sobre él.
  3. Haz clic en el menú de tres puntos y selecciona Editar comentario para editar el comentario o Borrar el comentario para borrarlo. Si vas a borrar el comentario, confirma tu intención.
  4. Si lo editas, selecciona Guardar cuando hayas realizado los cambios.

Comparte un comentario de un campo

La URL de la pestaña Comentarios de cada campo es única y se puede copiar y compartir con otros usuarios que tengan acceso a ese modelo en el diccionario de datos de Looker.

Cómo usar el generador de perfiles de campo

Si haces clic en una fila de campo específica, se abrirá un panel del generador de perfiles de campos a la derecha de la página, en el que se mostrará el conjunto completo de metadatos del campo, las opciones para obtener una vista previa de los valores de dimensiones numéricas y los botones para navegar a las páginas IDE de Looker o Explorar.

Si usas la versión 2.0.0 o una posterior de la extensión del diccionario de datos de Looker, el generador de perfiles de campos se abrirá de forma predeterminada en la pestaña Details.

En la sección Distribución, selecciona Calcular para mostrar una vista previa de un gráfico de columnas que muestra la distribución de los valores del recuento para dimensiones numéricas en una vista con una medición que tiene type: count. En la sección Distribución, también se muestran los valores mínimos, máximos y promedio de las series de dimensiones numéricas.

En Valores, selecciona Calcular para mostrar una vista previa de los valores de recuento de dimensiones numéricas en una vista con una medición que tenga type: count. Selecciona el botón Explorar más para abrir la IU de Explorar con la dimensión numérica y la medida de recuento preseleccionadas en el selector de campos.

Selecciona Ir a LookML para abrir el archivo de vista desde el proyecto de LookML asociado al modelo seleccionado en el IDE de Looker.

Selecciona el botón Explorar con un campo para abrir la página Explorar. Allí, ese campo se seleccionará automáticamente en el selector de campos.