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 esos objetos. 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 a continuación.
Para usar el panel de navegación de objetos, selecciona el ícono de navegador de objetos, que se encuentra debajo del ícono de carpeta en la barra de navegación del IDE.
El panel del navegador de objetos agrupa los objetos por tipo, y los objetos están ordenados alfabéticamente dentro de cada tipo. Con el panel del navegador de objetos, puedes ocultar o mostrar las jerarquías de los objetos mediante la expansión o contracción de objetos.
Puedes contraer y expandir modelos, exploraciones y vistas para ocultar o mostrar los objetos que contienen. Selecciona la flecha a la izquierda del nombre del objeto en el panel del navegador de objetos para contraerlo o expandirlo. 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
En el panel del navegador de objetos, se enumeran los siguientes tipos de objetos:
Para ver el tipo de objeto de tu proyecto, coloca el cursor sobre el nombre de ese objeto en el panel de navegación de objetos.
El ícono a la izquierda del nombre de cada objeto también identifica el tipo de objeto:
— Modelo
— Explorar
— Vista
: Dimensión
: Grupo de dimensiones
: Medición
: Filtro
: Parámetro
Cuando se coloca el cursor sobre el nombre de un campo en el panel del navegador de objetos, se revela 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 cuando se coloca el cursor sobre la dimensión id, se revela que es una dimensión type: number:
Navega al LookML de un objeto
En el IDE de Looker, puedes realizar una búsqueda rápida para navegar directamente a objetos de LookML y archivos de proyectos con la función Ir a un objeto o un archivo. Haz clic en el ícono Jump to object or file en el navegador de objetos, o bien usa la combinación de teclas Command-J (Mac) o Ctrl + J (Windows):
Consulta la página de documentación Accede a los archivos del proyecto de LookML para obtener más información.
También puedes navegar a un objeto si seleccionas el nombre del objeto en el panel del navegador de objetos. Cuando seleccionas un objeto, el IDE muestra el archivo en el que este se define y posiciona el cursor en la primera línea de la declaración del objeto.
Por ejemplo, si seleccionas Explorar, se llama events, se abre el archivo de modelo en el que se define Explorar en el IDE y se coloca el cursor en la parte superior de la declaración explore de events. En el panel del navegador de objetos, se muestra la definición de Explorar de events, incluida la vista de users unida.
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 el 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"
}
Para que la vista product_facts esté disponible en 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 función Explorar 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 extiende otra vista o explora, puedes usar el panel del navegador de objetos para ver y navegar al LookML del objeto que se extiende. Cuando expandes una vista que extiende otra, en el panel del navegador de objetos se muestran 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 se definen en la vista base users_extended y los campos nuevos que se definen en la vista user_with_age_extension.
Puede navegar al LookML del objeto extendido si selecciona su nombre en el panel del navegador de objetos.
Visualiza objetos mejor definidos en el panel de navegación de objetos
Puede usar el panel del navegador de objetos para ver el contenido de una vista mejorada o Explorar, o bien navegar a LookML a fin de definir mejor su proyecto.
El panel del navegador de objetos muestra una lista de mejoras y las exploraciones o vistas sobre las que se crean como objetos individuales, en lugar de mostrar las mejoras y sus objetos base por separado. Si utiliza mejoras para agregar campos a una vista o para unir vistas a Explorar, los campos o las vistas que agregue se mostrarán junto con el contenido de la vista original.
Cuando seleccionas el nombre de una vista mejorada o de Explorar en el panel del navegador de objetos, el IDE se abre en la línea de tu LookML en la que se define el perfeccionamiento. Si se refinó una vista o Explorar más de una vez, el IDE navega al último perfeccionamiento de ese objeto por orden de inclusión.
A modo de ejemplo, supongamos que deseas 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 de 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 agregue definiciones a su proyecto, tenga en cuenta el orden en que se aplican. Los perfeccionamientos se aplican línea por línea hacia abajo en un solo archivo y por el orden en el que se incluyen si un objeto se define más de una vez en varios archivos. Consulta la página de documentación de refinamientos de LookML para obtener información sobre el orden en el que se aplican estas mejoras.