Navigare nei progetti con il riquadro del browser degli oggetti

Il riquadro del visualizzatore oggetti nell'IDE di Looker consente di visualizzare tutti gli oggetti del progetto in un unico posto, insieme alle relazioni gerarchiche tra questi oggetti. Questa può essere un'alternativa utile alla navigazione nel progetto per file o cartella.

Visualizzare gli oggetti in un progetto

Il riquadro del visualizzatore oggetti mostra i modelli, le esplorazioni, le visualizzazioni e i campi definiti nel progetto, insieme alla gerarchia degli oggetti e al tipo di ogni oggetto. Se il progetto include anche file importati, puoi leggere ulteriori dettagli sulla visualizzazione di questi oggetti più avanti in questa pagina.

Per utilizzare il riquadro del visualizzatore oggetti, fai clic sull'icona Visualizzatore oggetti nella barra di navigazione dell'IDE.

Il riquadro del visualizzatore oggetti raggruppa gli oggetti per tipo e gli oggetti sono ordinati alfabeticamente all'interno di ogni tipo. Utilizzando il riquadro del visualizzatore oggetti, puoi mostrare o nascondere le gerarchie degli oggetti espandendo o comprimendo gli oggetti.

Puoi comprimere ed espandere modelli, esplorazioni e visualizzazioni per mostrare o nascondere gli oggetti che contengono. Seleziona la freccia a sinistra del nome di un oggetto nel riquadro del visualizzatore oggetti per comprimere o espandere l'oggetto. Per impostazione predefinita, nel riquadro del visualizzatore oggetti viene espanso qualsiasi modello di un progetto, mostrando un elenco delle esplorazioni definite nel modello.

Visualizzare il tipo di un oggetto

Il riquadro del visualizzatore oggetti elenca i seguenti tipi di oggetti:

Puoi visualizzare il tipo di un oggetto nel progetto passando il mouse sopra il nome dell'oggetto nel riquadro del visualizzatore oggetti.

Il riquadro del visualizzatore oggetti mostra sia un'icona sia un'etichetta di testo che identificano il tipo di oggetto:

  • — Modello
  • — Esplorazione
  • — Visualizzazione
  • — Dimensione
  • — Gruppo di dimensioni
  • — Misura
  • — Filtro
  • — Parametro

Se passi il mouse sopra il nome di un campo nel riquadro del visualizzatore oggetti, viene visualizzato il valore del sottoparametro type del campo. Nell'esempio seguente, l'icona a sinistra dell'oggetto id indica che si tratta di una dimensione e, se passi il mouse sopra la dimensione id, viene visualizzato che si tratta di una dimensione type: number:

Il visualizzatore oggetti mostra l'icona della dimensione accanto al nome del campo ID campione e il tipo di numero viene indicato al passaggio del mouse.

Puoi utilizzare uno dei seguenti metodi per andare direttamente al LookML di un oggetto dal riquadro del visualizzatore oggetti:

Fare clic sul nome dell'oggetto

Per andare al LookML di un oggetto:

  1. Nel riquadro del visualizzatore oggetti, fai clic sul nome dell'oggetto.
  2. L'IDE apre il file in cui è definito l'oggetto e posiziona il cursore sulla prima riga della dichiarazione dell'oggetto.

Cercare l'oggetto

Per cercare un oggetto o un file:

  1. Nel riquadro del visualizzatore oggetti, fai clic sull'icona Vai a oggetto o file .

    In alternativa, utilizza la scorciatoia da tastiera Comando-J (Mac) o Ctrl+J (Windows).

  2. Inserisci il termine di ricerca. Looker mostra un elenco di oggetti e file che corrispondono al termine di ricerca.

Situazioni speciali

Visualizzare gli oggetti importati nel riquadro del visualizzatore oggetti

Quando importi file da un altro progetto e includi tali file importati nel progetto attivo, puoi utilizzare il riquadro del visualizzatore oggetti anche per visualizzare gli oggetti importati.

Supponiamo, ad esempio, di aver utilizzato il parametro local_dependency nel file manifest del progetto per importare un progetto locale chiamato e_redlook, che contiene una visualizzazione chiamata product_facts:


# Your project
project_name: "e_thelook"

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

Per rendere disponibile la visualizzazione product_facts al modello, puoi includerla e creare un'esplorazione product_facts:


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

Puoi quindi visualizzare l'esplorazione product_facts nel riquadro del visualizzatore oggetti ed espanderla per mostrare le visualizzazioni e i campi che contiene.

Quando selezioni un oggetto da un progetto importato, Looker apre il file in cui è definito l'oggetto. Il file sarà di sola lettura perché è un file di progetto importato.

Visualizzare gli oggetti estesi nel visualizzatore oggetti

Se il progetto include una visualizzazione o un'esplorazione che estende un'altra visualizzazione o esplorazione, puoi utilizzare il riquadro del visualizzatore oggetti per visualizzare e andare al LookML dell'oggetto di estensione. Quando espandi una visualizzazione che ne estende un'altra, il riquadro del visualizzatore oggetti mostra i campi della visualizzazione di base insieme a tutti i campi che hai aggiunto nella visualizzazione di estensione.

Ad esempio, il seguente file di visualizzazione definisce una visualizzazione chiamata user_with_age_extension che estende un'altra visualizzazione chiamata users_extended e aggiunge nuovi campi:

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 ;;
  }
}

Il riquadro del visualizzatore oggetti mostra ora sia i campi definiti nella visualizzazione di base users_extended sia i nuovi campi definiti nella visualizzazione user_with_age_extension.

Puoi andare al LookML dell'oggetto di estensione selezionandone il nome nel riquadro del visualizzatore oggetti.

Visualizzazione di oggetti perfezionati nel riquadro del visualizzatore oggetti

Puoi utilizzare il riquadro del visualizzatore oggetti per visualizzare i contenuti di una visualizzazione o di un'esplorazione perfezionata oppure per andare al LookML dei perfezionamenti nel progetto.

Il riquadro del visualizzatore oggetti elenca i perfezionamenti e le esplorazioni o le visualizzazioni su cui si basano come singoli oggetti, anziché visualizzare separatamente i perfezionamenti e gli oggetti di base. Se utilizzi i perfezionamenti per aggiungere campi a una visualizzazione o per unire le visualizzazioni a un'esplorazione, i campi o le visualizzazioni che aggiungi verranno visualizzati insieme ai contenuti della visualizzazione originale.

Quando fai clic sul nome di una visualizzazione perfezionata o di un'esplorazione perfezionata nel riquadro del visualizzatore oggetti, l'IDE si apre alla riga del LookML in cui è definito il perfezionamento. Se una visualizzazione o un'esplorazione è stata perfezionata più volte, l'IDE passa all'ultimo perfezionamento dell'oggetto in base all'ordine di inclusione.

Ad esempio, supponiamo di voler aggiungere una nuova dimensione, country, alla visualizzazione chiamata user_with_age_extension senza modificare il LookML originale della visualizzazione. Per perfezionare la visualizzazione user_with_age_extension, utilizza il parametro view e aggiungi un segno più (+) davanti al nome della visualizzazione:


view: +user_with_age_extension {

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

Quando espandi la visualizzazione user_with_age_extension nel riquadro del visualizzatore oggetti, il campo country viene ora visualizzato insieme ai campi originali della visualizzazione.

Quando aggiungi perfezionamenti al progetto, tieni presente l'ordine in cui vengono applicati. I perfezionamenti vengono applicati riga per riga verso il basso all'interno di un singolo file e in base all'ordine in cui i file vengono inclusi se un oggetto viene perfezionato più volte in più file. Per informazioni sull'ordine in cui vengono applicati i perfezionamenti, consulta la pagina della documentazione Perfezionamenti LookML.