Metadatos de objetos de LookML

Los usuarios que tengan 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, haz lo siguiente:

  1. Navega a 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 para el 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 Navegación por proyectos con el panel del navegador de objetos para ver 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 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: Enumera los paneles de LookML que se incluyen en el modelo, con vínculos a sus definiciones dentro de tu proyecto de LookML.
  • Exploraciones: Enumera las exploraciones que se incluyen en el modelo, con vínculos a sus definiciones dentro de tu proyecto de LookML.
  • Vistas: Muestra una lista de las vistas que se incluyen en el modelo, con vínculos a sus definiciones dentro de 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. Nombre de la vista y detalles: 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 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 el que se define la vista en el LookML del archivo (y un vínculo a la vista de tu proyecto).
  2. Se usa en el menú [número] modelos: Muestra una lista de modelos que incluyen esta vista, en la que [número] representa el recuento de modelos que la incluyen. Por ejemplo, si una vista se usa 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. Público unido: Explora las exploraciones a las que se unió esta vista.

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

Metadatos de las exploraciones

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

  1. Explore name and details: El nombre de Explore 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 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 exploración en el LookML del archivo (y un vínculo a la función Explorar en tu proyecto).
  2. Vista base: Es la vista base de Explorar (la vista que se usa como punto de partida para crear la función).
  3. Vistas unidas: Son otras vistas unidas en la vista base.

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

Metadatos de los campos

Si seleccionas un campo, el panel de metadatos te 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 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 muestra el tipo de campo y proporciona el nombre del archivo y el número de línea en el que el campo se define en LookML del archivo (y un vínculo al campo en tu proyecto).
  2. Usado en el menú [número] modelos: Muestra una lista de modelos que incluyen la vista para este campo.
  3. Existe en la vista: Son las 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 muestra de LookML para un archivo de modelo en el que la exploración aircraft_extended extiende la exploración 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 muestra 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 define aircraft_extended.

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

  • Vistas unidas: Muestra una lista de todas las vistas que están vinculadas a la exploración de aircraft.
  • Extiende: Muestra el objeto que extiende la exploración seleccionada. En este caso, es la exploración de aircraft.

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

Metadatos para definir mejor

El panel de metadatos facilita la visualización cuando una vista o una exploración tienen ajustes agregados al objeto. En la sección Refinements del panel de metadatos, se muestra la cantidad de perfeccionamientos que se agregaron al objeto, y puedes usar los vínculos para navegar a LookML de cada perfeccionamiento.

Al igual que con las extensiones, no puedes saber si un objeto se define mejor con solo mirar LookML, en especial porque el perfeccionamiento de LookML puede estar en un archivo diferente. El panel de metadatos te permite ver si un objeto se definió mejor y, si es así, navegar directamente a LookML para realizar el perfeccionamiento.

Metadatos de proyectos importados

El panel de metadatos incluye información sobre los objetos de proyectos importados, como vínculos para navegar al archivo importado en el que se define el objeto. Por ejemplo, si seleccionas LookML para una exploración que se basa 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 están en la carpeta de proyectos importados en el navegador de archivos IDE para ver los metadatos de los archivos importados.