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 del que deseas 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 se usa un objeto LookML en varios modelos, el panel de metadatos proporciona un menú desplegable que te permite seleccionar el modelo para el 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 de los 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 mostrará la siguiente información sobre cómo se usa la vista en tu proyecto:

  1. Nombre y detalles de la vista: El nombre de la vista y un ícono que representa el tipo de objeto de la vista (consulta la página de documentación Cómo navegar por proyectos con el panel del navegador de objetos para ver 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 el que se define la vista en el archivo LookML (y un vínculo a la vista en tu proyecto).
  2. Menú Usado en [número] de modelos: Muestra una lista de modelos que incluyen esta vista, donde [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: Son las 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 aclaraciones, estas también se mostrarán en el panel de metadatos.

Metadatos de Explorar

Si seleccionas un parámetro explore, el panel de metadatos muestra 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 la exploración (la vista que se usa como punto de partida para compilarla).
  3. Vistas unidas: Otras vistas que están unidas en la vista base.

Si la exploración tiene extensiones o aclaraciones, estas también se mostrarán en el panel de metadatos.

Metadatos de campos

Si seleccionas un campo, el panel de metadatos muestra 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 obtener 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 en el que se define el campo en el código 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 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 todas 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 Extendido por para navegar directamente al código LookML en el que se define 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.
  • Extiende: Muestra el objeto que extiende la exploración seleccionada. En este caso, es aircraft Explorar.

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

Metadatos para la definición

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 perfeccionamientos 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 se definió mejor un objeto y, de ser así, te permite navegar directamente a LookML para definirlo mejor.

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 en el que se define 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.