El diccionario de datos de Looker es diferente del bloque de diccionario de datos.
Para disfrutar de la funcionalidad completa de la extensión del diccionario de datos de Looker, los administradores deben actualizar la aplicación del diccionario de datos de Looker 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) desarrollada con el framework de extensión de Looker y, luego, implementada a través de Looker Marketplace.
La extensión Diccionario de datos de Looker proporciona una interfaz centralizada y dedicada para buscar en todos tus campos y descripciones de Looker. Usa esta extensión para realizar las siguientes tareas: * Proporciona un directorio de búsqueda para todas las métricas y descripciones para que los usuarios identifiquen la dimensión o la medida adecuadas para el análisis. * Facilita que las partes interesadas externas identifiquen y ubiquen métricas únicas. * Audita los modelos de LookML para evaluar si se siguen convenciones de nombres coherentes, si hay campos redundantes o si los campos están anotados con descripciones. * Agrega y comparte 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 seguir estos pasos:
- Habilita las funciones adecuadas.
- Instala la extensión Diccionario de datos de Looker.
- 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:
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: 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 Cómo usar Looker Marketplace para obtener instrucciones sobre cómo instalar una herramienta desde Looker Marketplace. Para asegurarte de tener siempre la versión más actualizada del diccionario de datos, ve al mercado de Looker, selecciona Administrar y, luego, 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 New Model Set y Edit Model Set, a las que se puede acceder desde la página Roles en el 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 necesiten explorar en el Diccionario de datos. Consulta la página de documentación Configura permisos para extensiones de Looker para obtener información sobre cómo otorgarles permisos a los usuarios para acceder a las extensiones y usarlas.
Otorga permisos para interactuar con los comentarios de campo
Los comentarios de campo les permiten a los usuarios agregar contexto a las definiciones de campos sin tener que actualizar ningún 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 los suyos.
Si lo desean, los administradores de Looker pueden administrar la forma en que los usuarios interactúan con la función de comentarios de campo creando grupos de usuarios específicos en la página Grupos del panel Administrador y asignando usuarios a esos grupos. Consulta la página de documentación Grupos para obtener más información sobre cómo asignar usuarios a grupos.
Los grupos de usuarios se deben crear con los nombres predefinidos que se muestran en la columna Nombre del grupo de la siguiente tabla. La tabla también muestra los privilegios predefinidos que tendrán los usuarios asignados a cada grupo.
Si un usuario no pertenece a ninguno de estos grupos, se usará de forma predeterminada writer. Si un usuario está asignado a varios grupos (sin incluir marketplace_data_dictionary_comments_disabled), su privilegio más elevado tiene prioridad.
Los cambios en un grupo de comentarios, como agregar o quitar un usuario, que se realicen a través de la página Grupos en el panel Administrador, se implementarán después de una actualización forzada de la página Diccionario de datos o después de que el usuario seleccione otra opción y, luego, regrese a la página Diccionario de datos.
Cómo navegar al Diccionario de datos de Looker
Puedes navegar al Diccionario de datos desde la lista de aplicaciones y extensiones instaladas en la barra lateral izquierda.
Cómo ver los metadatos del modelo con el diccionario de datos de Looker
En el Diccionario de datos de Looker, los usuarios con permisos explore en un modelo pueden seleccionar este modelo y ver sus metadatos, incluidos 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 seleccionada en la parte principal de la página.
Para contraer la barra lateral, los usuarios deben seleccionar el ícono <.
El diccionario de datos de Looker muestra la siguiente información:
- El nombre del modelo seleccionado
- La lista de Exploraciones que contiene el modelo seleccionado
- La exploración seleccionada
- Un campo de texto para filtrar los campos de una exploración
- Filtros rápidos para limitar los campos que se muestran según las características seleccionadas
- Es el nombre de la vista.
- Metadatos sobre cada campo Para seleccionar qué metadatos se muestran, selecciona el botón Ver opciones. Consulta el conjunto completo de metadatos del campo en el perfilador de campos.
- Filas que contienen metadatos para cada campo en una vista determinada
- Navegación a la función Explorar en la IU de Looker
Cómo seleccionar un modelo y una exploración
En la lista desplegable Seleccionar un modelo, se muestran todos los modelos para los que un usuario tiene permisos explore. Cuando elijas un modelo del menú desplegable Seleccionar un modelo, la barra lateral izquierda se completará con una lista de las exploraciones de ese modelo.
También puedes buscar una función Explorar específica en el modelo seleccionado. Para ello, escribe en el cuadro de búsqueda Modelo de búsqueda. La lista de Explorar se filtrará 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.
Cómo filtrar campos en una exploración
Para filtrar los campos que se muestran, escribe 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, como si el campo tiene las siguientes características:
- Tiene una descripción.
- Es una dimensión o una métrica.
- Tiene etiquetas
- Tiene el tipo cadena, número, fecha, código postal, cantidad, suma, promedio, lista o sin comillas.
Cómo ver los metadatos de un campo
El Diccionario de datos de Looker muestra los metadatos de los campos de una exploración, agrupados por vista:
- Etiqueta del campo: Es el nombre del campo según el parámetro
labeldel campo. - Categoría: Es la categoría del campo como dimensión o métrica.
- Description: Es la descripción del campo según el parámetro
descriptiondel campo. - Nombre de LookML: Es el nombre del campo en la sintaxis
view_name.field_name. - Type: Es el tipo de campo como cadena, número, fecha, código postal, cantidad, suma, promedio, lista o sin comillas según el parámetro
typedel campo. - SQL: Es la expresión SQL que hace referencia a ese campo.
- Etiquetas: Las etiquetas de LookML asociadas con ese campo
Personaliza los metadatos que se muestran
Para especificar qué metadatos se muestran para cada campo, selecciona el botón View Options en la esquina superior derecha y marca o desmarca las casillas de los metadatos que deseas ver.
Cómo usar comentarios de campo
Si una instancia ya tiene Marketplace, los administradores deben asegurarse de que la extensión del diccionario de datos tenga la versión 2.0.0 o una posterior para usar comentarios a nivel del campo.
Los desarrolladores de LookML suelen incluir información o explicaciones adicionales sobre los campos de un modelo en el parámetro description a nivel del campo. Sin embargo, estas descripciones no siempre son significativas ni útiles para todos los usuarios. Con los comentarios a nivel del campo, los usuarios pueden agregar contexto a un campo específico. Otros usuarios pueden ver estos comentarios, pero no afectarán al código LookML subyacente del modelo.
Los administradores deben otorgarles 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 que tengan acceso a la extensión del diccionario de datos pueden ver todos los comentarios y agregar, editar y borrar los suyos.
Agrega un comentario de campo
Para agregar un comentario a un campo, sigue estos pasos:
- Coloca el cursor sobre la fila del campo para que aparezca un ícono de + (si no hay comentarios en el campo) o un ícono de notepad (si hay comentarios en el campo). Haz clic en el ícono para abrir la pestaña Comentarios del panel del generador de perfiles de campo.
- Haz clic en el botón Add Comment.
- Escribe tu comentario y selecciona el botón Comentario para guardar tu entrada. Haz clic en Cancelar para cerrar el generador de perfiles de campo. Para expandir el cuadro de comentarios, selecciona la esquina inferior derecha y arrástrala.
Una vez que se agrega un comentario, este aparece en la pestaña Comentarios del perfilador de campo y otros usuarios pueden verlo.
Cómo ver los comentarios de los campos
Cuando un campo incluye comentarios, aparece un ícono de notepad con la cantidad de comentarios que existen en ese campo. Haz clic en el ícono de notepad para ver los comentarios del campo que aparecen en la pestaña Comentarios del generador de perfiles de campo.
La cantidad de comentarios en 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
- Una vista previa del comentario
Cómo editar o borrar un comentario de un campo
Para editar o borrar tus propios comentarios de campo, haz lo siguiente:
- Selecciona el ícono de notepad del campo.
- En la pestaña Comentarios, busca el comentario que deseas editar o borrar y coloca el cursor sobre él.
- Haz clic en el menú de tres puntos y selecciona Editar comentario para editarlo o Borrar comentario para borrarlo. Si vas a borrar el comentario, confirma tu intención.
- Si estás editando tu comentario, selecciona Guardar una vez que hayas realizado los cambios.
Cómo compartir un comentario de 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
Haz clic en una fila de campo específica para abrir un panel de perfilador de campos que muestra todo el conjunto de metadatos del campo, opciones para obtener una vista previa de los valores de las dimensiones numéricas y botones para navegar al IDE de Looker o a la página 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 campo se abre de forma predeterminada en la pestaña Detalles.
En la sección Distribución, selecciona Calcular para mostrar una vista previa de un gráfico de columnas que representa la distribución de los valores de recuento de las dimensiones numéricas en una vista con una medida que tiene type: count. En la sección Distribución, también se mostrarán los valores mínimos, máximos y promedios de la serie de dimensiones numéricas.
En Valores, selecciona Calcular para mostrar una vista previa de los valores de recuento de las dimensiones numéricas en una vista con una medida 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 del proyecto de LookML asociado con el modelo seleccionado en el IDE de Looker.
Selecciona el botón Explorar con campo para abrir la página Explorar con ese campo seleccionado automáticamente desde el selector de campos.