Metadatos para objetos de LookML

Los usuarios que tienen el permiso develop pueden ver información contextualmente relevante sobre los objetos en el panel de metadatos del IDE de Looker.

Para ver el panel de metadatos en el IDE de Looker, sigue estos pasos:

  1. Navega hasta los archivos de tu proyecto.
  2. Para abrir el panel de ayuda rápida, selecciona el ícono de Ayuda rápida .
  3. En el editor de código de LookML, coloca el cursor sobre el objeto sobre el que quieres obtener más contexto en el panel de metadatos.
  4. En el panel de ayuda rápida, selecciona la pestaña Metadatos para abrir el panel de metadatos.

El panel de metadatos identifica el objeto con un nombre y un ícono que representa el tipo de objeto (consulta la página de documentación Navega proyectos con el panel del navegador de objetos para conocer todos los íconos de tipos de objetos posibles).

Si un objeto de LookML se usa en varios modelos, el panel de metadatos proporciona un menú desplegable que te permite seleccionar el modelo del que deseas ver los metadatos.

La información que se muestra en el panel de metadatos depende del tipo de objeto de LookML que seleccionaste y de cómo se usa el objeto seleccionado en tu proyecto. Puedes usar los metadatos para comprender mejor muchos aspectos de tu proyecto, como se describe en las siguientes secciones.

Metadatos para modelos

Si seleccionas un archivo de modelo, el panel de metadatos muestra las siguientes secciones:

  • Paneles: Muestra una lista de los paneles de LookML que se incluyen en el modelo, con vínculos a sus definiciones en tu proyecto de LookML.
  • Exploraciones: Enumera las exploraciones que se incluyen en el modelo, con vínculos a sus definiciones en tu proyecto de LookML.
  • Vistas: Muestra una lista de las vistas que se incluyen en el modelo, con vínculos a sus definiciones en tu proyecto de LookML.

El encabezado de cada sección también muestra el número de cada tipo de objeto.

Metadatos de las vistas

Si seleccionas un parámetro de vista, el panel de metadatos muestra la siguiente información sobre cómo se usa la vista en tu proyecto:

  1. View name and details: Es el nombre de la vista y un ícono que representa el tipo de objeto de la vista (consulta la página de documentación Navega proyectos con el panel del navegador de objetos para conocer todos los íconos de tipos de objetos posibles). El panel de metadatos también proporciona el nombre del archivo y el número de línea donde se define la vista en el LookML del archivo (y un vínculo a la vista en tu proyecto).
  2. Usado en el menú [número] modelos: Muestra una lista de modelos que incluyen esta vista, en la que [número] representa la cantidad de modelos que incluyen la vista. Por ejemplo, si se usa una vista dentro de dos modelos, el panel de metadatos mostrará el texto Se usa en 2 modelos.
  3. Clave primaria: Es la clave primaria de la vista.
  4. Vista base de: Exploraciones que usan esta vista como su vista base.
  5. Se unió: Explora las exploraciones en las que se unió esta vista.

Si la vista tiene extensiones o mejoras, estas también se mostrarán en el panel de metadatos.

Metadatos de las exploraciones

Si seleccionas un parámetro explore, el panel de metadatos mostrará la siguiente información sobre cómo se usa Explorar en tu proyecto:

  1. Nombre y detalles de la exploración: Es el nombre de la exploración y un ícono que representa su tipo de objeto (consulta la página de documentación Cómo navegar por proyectos con el panel del navegador de objetos para conocer todos los íconos de tipos de objetos posibles). El panel de metadatos también proporciona el nombre del archivo y el número de línea en los que se define la exploración en el LookML del archivo (y un vínculo a la función Explorar de tu proyecto).
  2. Vista base: Es la vista base de Explorar (la que se usa como punto de partida para crear la exploración).
  3. Vistas unidas: Otras vistas que están unidas en la vista base.

Si la pestaña Explorar tiene extensiones o mejoras, estas también se mostrarán en el panel de metadatos.

Metadatos de los campos

Si seleccionas un campo, el panel de metadatos mostrará la siguiente información sobre cómo se usa el campo en tu proyecto:

  1. Nombre y detalles del campo: El nombre del campo y un ícono que representa su tipo de objeto (consulta la página de documentación Navega proyectos con el panel del navegador de objetos para conocer todos los íconos de tipos de objetos posibles). El panel de metadatos también muestra el tipo de campo y proporciona el nombre del archivo y el número de línea donde se define el campo en el LookML del archivo (y un vínculo al campo en tu proyecto).
  2. Usado en el menú [cantidad] modelos: Muestra una lista de modelos que incluyen la vista para este campo.
  3. Exists in view: Vistas que usan este campo.

Metadatos de las extensiones

Cuando seleccionas un parámetro view o explore en el editor de código de LookML, la sección Extended by del panel de metadatos muestra las extensiones de ese objeto.

Por ejemplo, considera el siguiente código de LookML de muestra para un archivo de modelo en el que la exploración de aircraft_extended extiende la exploración de aircraft:

explore: aircraft {
  view_name: aircraft
  join: aircraft_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_type_id} = ${aircraft_types.aircraft_type_id} ;;
    relationship: many_to_one
  }

  join: aircraft_engine_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_engine_type_id} = ${aircraft_engine_types.aircraft_engine_type_id} ;;
    relationship: many_to_one
  }
}

explore: aircraft_extended {
  extends: [aircraft]
  label: "Aircraft Extended"
}

Si seleccionas la definición de LookML para la exploración de aircraft, el panel de metadatos mostrará aircraft_extended en la sección Extended by. Haz clic en el vínculo de la sección Extended by para navegar directamente a LookML en el que se definió aircraft_extended.

Si haces clic en la definición de la exploración de aircraft_extended, el panel de metadatos proporciona la siguiente información sobre la exploración extendida de aircraft:

  • Vistas unidas: Muestra las vistas que se unieron a la exploración de aircraft.
  • Extends: Muestra una lista del objeto que extiende la exploración seleccionada. En este caso, esta es la exploración de aircraft.

En estos ejemplos, los parámetros explore extendidos y extendidos están uno junto al otro en el mismo archivo, pero no siempre es así. No es evidente si se mira un parámetro si está extendido, sobre todo porque los objetos extendidos y que se extienden pueden estar en diferentes archivos de LookML. El panel de metadatos te proporciona contexto sobre los objetos relacionados, sin importar dónde se definan.

Metadatos para mejoras

El panel de metadatos permite ver fácilmente si una vista o una exploración tienen perfeccionamientos que se agregaron al objeto. En la sección Perfecciones del panel de metadatos, se muestra la cantidad de mejoras que se agregaron al objeto. Puedes usar los vínculos para navegar a LookML en cada caso.

Al igual que con las extensiones, no puedes saber si un objeto se perfecciona con solo mirar LookML, sobre todo porque el refinamiento de LookML puede estar en un archivo diferente. El panel de metadatos te permite ver si un objeto se refinó y, de ser así, te permite navegar directamente a LookML para el refinamiento.

Metadatos de los proyectos importados

El panel de metadatos incluye información sobre los objetos de los proyectos importados, incluidos los vínculos para navegar al archivo importado en el que se define el objeto. Por ejemplo, si seleccionas LookML para una exploración basada en un archivo de vista importado, se mostrará la información del archivo de vista importado en el panel de metadatos.

En el panel de metadatos, puedes hacer clic en el vínculo para navegar al archivo importado donde se definió el objeto.

Además, puedes hacer clic en los objetos que se encuentran en la carpeta de proyectos importados en el navegador de archivos IDE para ver sus metadatos.