Navega por proyectos con el panel del navegador de objetos

El panel del navegador de objetos del IDE de Looker te permite ver todos los objetos de tu proyecto en un solo lugar, junto con las relaciones jerárquicas entre esos objetos. Esta puede ser una alternativa útil a la navegación por el 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 obtener más información para 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.

En el panel del navegador de objetos, se agrupan 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 mostrar u ocultar 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 contraer o expandir el objeto. Cualquier modelo de 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 un objeto

El panel del navegador de objetos enumera los siguientes tipos de objetos:

Para ver el tipo de un objeto de tu proyecto, coloca el cursor sobre el nombre de ese objeto en el panel del navegador de objetos.

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

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

Si 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 a la izquierda del objeto id indica que es una dimensión, y si colocas el cursor sobre la dimensión id, se revela que es una dimensión type: number:

El navegador de objetos muestra el ícono de dimensión junto al nombre del campo ID de muestra, y el tipo de número se indica cuando se coloca el cursor sobre él.

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 un 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 y, luego, incluyes esos archivos importados en tu proyecto activo, también puedes usar el panel del navegador de objetos para ver 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"
}

Si deseas que la vista product_facts esté disponible para tu modelo, puedes incluirla 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 los objetos extendidos en el panel del navegador de objetos

Si tu proyecto incluye una vista o una exploración que extends otra vista o una exploración, puedes usar el panel del navegador de objetos para ver y navegar a LookML del objeto extendido. 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, en el siguiente archivo de vista, se 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 ;;
  }
}

En el panel del navegador de objetos, ahora se muestran los campos 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 extiende seleccionando su nombre en el panel del navegador de objetos.

Visualiza objetos mejor definidos en el panel del navegador de objetos

Puedes usar el panel del navegador de objetos para ver el contenido de una vista mejorada o una exploración, o navegar a LookML para definir los ajustes en tu proyecto.

El panel del navegador de objetos enumera los perfeccionamientos y las exploraciones o vistas en las que se basan como objetos únicos, en lugar de mostrar perfeccionamientos 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 mejor definida o una exploración definida en el panel del navegador de objetos, el IDE se abre en la línea de LookML en la que se define el perfeccionamiento. Si se definieron mejor una vista o una exploración varias veces, el IDE navega al último perfeccionamiento de ese objeto por orden de inclusión.

A modo de ejemplo, supongamos que deseas agregar una dimensión nueva, 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, ahora se muestra el campo country junto con los campos originales de la vista.

Cuando agregues mejoras a tu proyecto, ten en cuenta el orden en el que se aplican. Los perfeccionamientos se aplican línea por línea y descienden 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 perfeccionamientos de LookML para obtener información sobre el orden en el que se aplican.