Navega proyectos con el panel del navegador de objetos

El panel del navegador de objetos en el IDE de Looker te permite ver todos los objetos de tu proyecto en un solo lugar, junto con las relaciones jerárquicas entre ellos. Esta puede ser una alternativa útil para navegar por tu proyecto por archivo o carpeta.

Visualiza los objetos de un proyecto

En el panel del navegador de objetos, se muestran los modelos, las exploraciones, las vistas y los campos que se definieron en tu proyecto, junto con la jerarquía de objetos y el tipo de cada uno. Si tu proyecto también incluye archivos importados, puedes leer más detalles sobre cómo ver esos objetos más adelante en esta página.

Para usar el panel del navegador de objetos, haz clic en el ícono del navegador de objetos en la barra de navegación del IDE.

El panel del navegador de objetos agrupa los objetos por tipo, y los objetos se ordenan alfabéticamente dentro de cada tipo. Con el panel del navegador de objetos, puedes expandir o contraer objetos para ocultar o mostrar las jerarquías de los objetos.

Puedes contraer y expandir modelos, exploraciones y vistas para ocultar o mostrar los objetos que contienen. Selecciona la flecha ubicada a la izquierda del nombre de un objeto en el panel del navegador de objetos para contraerlo o expandirlo. Cualquier modelo en un proyecto se expande de forma predeterminada en el panel del navegador de objetos, lo que revela una lista de las exploraciones definidas en el modelo.

Visualiza el tipo de objeto

En el panel del navegador de objetos, se enumeran los siguientes tipos de objetos:

Puedes ver el tipo de objeto de tu proyecto si colocas el cursor sobre el nombre de ese objeto en el panel del navegador de objetos.

El panel del navegador de objetos muestra un ícono y una etiqueta de texto que identifican el tipo de objeto:

  • — Modelo
  • — Explorar
  • — Ver
  • : Dimensión
  • : Grupo de dimensiones
  • : Medición
  • : Filtro
  • : Parámetro

Cuando colocas el cursor sobre el nombre de un campo en el panel del navegador de objetos, se muestra el valor del subparámetro type del campo. En el siguiente ejemplo, el ícono ubicado a la izquierda del objeto id indica que es una dimensión, y si se coloca el cursor sobre la dimensión id, se revela que se trata de una dimensión type: number:

El navegador de objetos muestra el ícono de dimensión junto al nombre del campo de ID de muestra y el tipo de número se indica al colocar el cursor sobre ellos.

Puedes usar uno de los siguientes métodos para navegar directamente a LookML de un objeto desde el panel del navegador de objetos:

Haz clic en el nombre del objeto.

Para navegar a LookML de un objeto, sigue estos pasos:

  1. En el panel del navegador de objetos, haz clic en el nombre del objeto.
  2. El IDE abre el archivo en el que se define el objeto y coloca el cursor en la primera línea de la declaración del objeto.

Busca el objeto

Para buscar un objeto o archivo, sigue estos pasos:

  1. En el panel del navegador de objetos, haz clic en el ícono Jump to object or file .

    También puedes usar la combinación de teclas Comando + J (Mac) o Ctrl + J (Windows).

  2. Ingresa el término de búsqueda. Looker muestra una lista de objetos y archivos que coinciden con tu término de búsqueda.

Situaciones especiales

Visualiza los objetos importados en el panel del navegador de objetos

Cuando importas archivos de otro proyecto e incluyes esos archivos importados en tu proyecto activo, puedes usar el panel del navegador de objetos para ver también los objetos importados.

Por ejemplo, supongamos que usaste el parámetro local_dependency en el archivo de manifiesto de tu proyecto para importar un proyecto local llamado e_redlook, que contiene una vista llamada product_facts:


# Your project
project_name: "e_thelook"

# The project to import
local_dependency: {
 project: "e_redlook"
}

Para que la vista product_facts esté disponible para tu modelo, puedes incluir esa vista y crear una exploración de product_facts:


include: "//e_redlook/views/product_facts.view"
explore: product_facts {}

Luego, puedes ver la exploración de product_facts en el panel del navegador de objetos y expandirla para mostrar las vistas y los campos que contiene.

Cuando seleccionas un objeto de un proyecto importado, Looker abre el archivo en el que está definido el objeto. El archivo será de solo lectura porque es un archivo de proyecto importado.

Visualiza objetos extendidos en el panel del navegador de objetos

Si tu proyecto incluye una vista o una exploración que extends otra vista o exploración, puedes usar el panel del navegador de objetos para ver el LookML del objeto que se extiende y navegar hasta él. Cuando expandes una vista que extiende otra, el panel del navegador de objetos muestra los campos de la vista base junto con los campos que agregaste en la vista extendida.

Por ejemplo, el siguiente archivo de vista define una vista llamada user_with_age_extension que extiende otra vista llamada users_extended y agrega campos nuevos:

include: "/views/users_extended.view"

view: user_with_age_extension {
  extends: [users_extended]

  dimension: age {
    type: number
    sql: ${TABLE}.age ;;
  }

  dimension: zip {
    type: zipcode
    sql: ${TABLE}.zip ;;
  }
}

El panel del navegador de objetos ahora muestra los campos que están definidos en la vista base users_extended y los nuevos campos definidos en la vista user_with_age_extension.

Puedes navegar a LookML del objeto que se extendió seleccionando su nombre en el panel del navegador de objetos.

Visualiza objetos definidos en el panel del navegador de objetos

Puedes usar el panel del navegador de objetos para ver el contenido de una vista refinada o Explorar, o navegar a LookML para definir mejor las mejoras de tu proyecto.

En el panel del navegador de objetos, se enumeran las mejoras y las exploraciones o vistas en las que se basan como objetos únicos, en lugar de mostrar las mejoras y sus objetos base por separado. Si utilizas mejoras para agregar campos a una vista o para unir vistas a una exploración, los campos o las vistas que agregues se mostrarán junto con el contenido de la vista original.

Cuando haces clic en el nombre de una vista mejorada o una exploración mejor definida en el panel del navegador de objetos, el IDE se abre en la línea de LookML donde se define el refinamiento. Si se perfeccionó varias veces una vista o una exploración, el IDE navega al último perfeccionamiento de ese objeto por orden de inclusión.

Como ejemplo, supongamos que quieres agregar una nueva dimensión, country, a la vista llamada user_with_age_extension sin modificar el LookML original de la vista. Para definir mejor la vista user_with_age_extension, usa el parámetro view y agrega un signo más (+) delante del nombre de la vista:


view: +user_with_age_extension {

  dimension: country {
    type: string
    map_layer_name: countries
    sql: ${TABLE}.country ;;
  }
}

Cuando expandes la vista user_with_age_extension en el panel del navegador de objetos, el campo country ahora se muestra junto con los campos originales de la vista.

Cuando agregues mejoras a tu proyecto, ten en cuenta el orden en el que se aplican. Las mejoras se aplican línea por línea hacia abajo dentro de un solo archivo y según el orden en el que se incluyen sus archivos si un objeto se perfecciona varias veces en varios archivos. Consulta la página de documentación sobre las mejoras de LookML para obtener información sobre el orden en el que se aplican las mejoras.