Navigazione nei progetti con il riquadro del browser degli oggetti

Il riquadro del browser degli oggetti nell'IDE di Looker ti consente di visualizzare tutti gli oggetti nel tuo progetto in un unico posto, insieme alle relazioni gerarchiche tra questi oggetti. Può essere un'alternativa utile per esplorare il progetto per file o cartella.

Visualizzazione degli oggetti in un progetto

Il riquadro del browser degli oggetti mostra i modelli, le esplorazioni, le viste 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 browser degli oggetti, fai clic sull'icona Browser oggetti nella barra di navigazione dell'IDE.

Il riquadro del browser degli oggetti raggruppa gli oggetti per tipo e gli oggetti sono ordinati in ordine alfabetico all'interno di ogni tipo. Puoi utilizzare il riquadro del browser degli oggetti per mostrare o nascondere le gerarchie degli oggetti espandendo o comprimendo gli oggetti.

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

Visualizzazione del tipo di oggetto

Il riquadro del browser degli oggetti elenca i seguenti tipi di oggetti:

Per visualizzare il tipo di un oggetto nel progetto, passa il mouse sopra il nome dell'oggetto nel riquadro del browser degli oggetti.

Il riquadro del browser degli oggetti mostra un'icona e un'etichetta di testo che identificano il tipo di oggetto:

  • - Modello
  • - Esplora
  • - Visualizza
  • - Dimensione
  • – Gruppo di dimensioni
  • - Misura
  • - Filtro
  • : Parametro

Se passi il mouse sopra il nome di un campo nel riquadro del browser degli 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 visualizzata una dimensione type: number:

Nel browser degli oggetti viene visualizzata l'icona della dimensione accanto al nome del campo ID di esempio e il tipo di numero viene indicato al passaggio del mouse.

Puoi utilizzare uno dei seguenti metodi per passare direttamente al LookML di un oggetto dal riquadro del browser degli oggetti:

Facendo clic sul nome dell'oggetto

Per accedere al LookML di un oggetto, segui questi passaggi:

  1. Nel riquadro del browser dell'oggetto, 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.

Ricerca dell'oggetto in corso...

Per cercare un oggetto o un file:

  1. Nel riquadro del browser degli oggetti, fai clic sull'icona Passa all'oggetto o al 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

Visualizzazione degli oggetti importati nel riquadro del browser degli oggetti

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

Ad esempio, supponi di aver utilizzato il parametro local_dependency nel file manifest del tuo progetto per importare un progetto locale denominato e_redlook, che contiene una vista denominata product_facts:


# Your project
project_name: "e_thelook"

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

Per rendere la vista product_facts disponibile per il tuo 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 browser degli oggetti ed espandere l'esplorazione per mostrare le viste 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.

Visualizzazione di oggetti estesi nel riquadro del browser oggetti

Se il tuo progetto include una vista o un'esplorazione che extends un'altra vista o esplorazione, puoi utilizzare il riquadro del browser degli oggetti per visualizzare e accedere al LookML dell'oggetto in estensione. Quando espandi una vista che ne estende un'altra, il riquadro del browser degli oggetti mostra i campi della vista di base insieme a tutti i campi che hai aggiunto nella vista estesa.

Ad esempio, il seguente file di vista definisce una vista denominata user_with_age_extension che estende un'altra vista denominata 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 browser degli oggetti ora mostra sia i campi definiti nella vista di base users_extended sia i nuovi campi definiti nella vista user_with_age_extension.

Puoi accedere al LookML dell'oggetto in estensione selezionando il nome nel riquadro del browser degli oggetti.

Visualizzazione di oggetti perfezionati nel riquadro del browser degli oggetti

Puoi utilizzare il riquadro del browser degli oggetti per visualizzare i contenuti di una vista o esplorazione migliorata oppure per passare al LookML per i perfezionamenti nel tuo progetto.

Il riquadro del browser degli oggetti elenca i perfezionamenti e le esplorazioni o le visualizzazioni su cui si basano come singoli oggetti, invece di visualizzare i perfezionamenti e i relativi oggetti di base separatamente. Se utilizzi i perfezionamenti per aggiungere campi a una vista o per unire visualizzazioni a un'esplorazione, i campi o le visualizzazioni aggiunti verranno mostrati insieme ai contenuti della vista originale.

Quando fai clic sul nome di una vista perfezionata o di un'esplorazione perfezionata nel riquadro del browser degli oggetti, l'IDE si apre sulla riga del tuo LookML in cui è definito il perfezionamento. Se una vista o un'esplorazione sono state perfezionate più volte, l'IDE passa all'ultimo perfezionamento dell'oggetto includendo l'ordine.

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


view: +user_with_age_extension {

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

Quando espandi la vista user_with_age_extension nel riquadro del browser degli oggetti, il campo country viene mostrato insieme ai campi originali della vista.

Quando aggiungi perfezionamenti al tuo progetto, fai attenzione all'ordine in cui vengono applicati i perfezionamenti. I perfezionamenti vengono applicati riga per riga crescendo verso il basso all'interno di un singolo file e in base all'ordine in cui i relativi file sono inclusi se un oggetto viene perfezionato più volte in più file. Consulta la pagina della documentazione sui perfezionamenti LookML per informazioni sull'ordine di applicazione dei perfezionamenti.