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.
Cómo ver 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 para ver esos objetos más adelante en esta página.
Para usar el panel del navegador de objetos, haz clic en el ícono Navegador de objetos en la barra de navegación del IDE.
El panel del navegador de objetos agrupa los objetos por tipo y se ordenan alfabéticamente dentro de cada tipo. Con el panel del navegador de objetos, puedes expandir o contraer objetos para mostrar o ocultar las jerarquías 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 de un 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.
Cómo ver el tipo de un objeto
En el panel del navegador de objetos, se enumeran los siguientes tipos de objetos:
Para ver el tipo de un objeto en tu proyecto, coloca el cursor sobre su nombre 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:
- : Es el modelo.
- : Explorar
- : Vista
- : Es la dimensión.
- : Grupo de dimensiones
- : Medida
- : Filtro
- : Es un 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:
Cómo navegar a la definición de LookML de un objeto
Puedes usar uno de los siguientes métodos para navegar directamente a la definición de LookML de un objeto desde el panel del navegador de objetos:
Hacer clic en el nombre del objeto
Para navegar a LookML de un objeto, sigue estos pasos:
- En el panel del navegador de objetos, haz clic en el nombre del objeto.
- 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.
Búsqueda del objeto
Para buscar un objeto o un archivo, sigue estos pasos:
En el panel del navegador de objetos, haz clic en el ícono Ir al objeto o archivo .
Como alternativa, usa la combinación de teclas Comando + J (Mac) o Ctrl + J (Windows).
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
Cómo ver los objetos importados en el panel del navegador de objetos
Cuando importas archivos de otro proyecto y los incluyes 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"
}
Para 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 product_facts Explorar en el panel del navegador de objetos y expandirlo para mostrar las vistas y los campos que contiene.
Cuando seleccionas un objeto de un proyecto importado, Looker abre el archivo en el que se define 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 extiende otra vista o exploración, 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, el panel del navegador de objetos muestra los campos de la vista base junto con los campos que agregaste en la vista que se extiende.
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 users_extended base y los campos nuevos que se definen en la vista user_with_age_extension.
Para navegar al código LookML del objeto que se extiende, selecciona su nombre en el panel del navegador de objetos.
Visualización de objetos refinados 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 bien para navegar a LookML y ver 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 individuales, en lugar de mostrar las mejoras y sus objetos base por separado. Si usas los refinamientos para agregar campos a una vista o 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 o una exploración refinadas en el panel del navegador de objetos, el IDE se abre en la línea de tu LookML en la que se define la definición. Si una vista o una exploración se definieron mejor varias veces, el IDE navega a la última definición 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 código 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 (+) antes 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. Los perfeccionamientos se aplican línea por línea hacia abajo dentro de un solo archivo y según el orden en el que se incluyen los archivos si un objeto se define mejor varias veces en varios archivos. Consulta la página de documentación de Refinamientos de LookML para obtener información sobre el orden en que se aplican los refinamientos.