Navigare 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 del progetto in un unico posto, insieme alle relazioni gerarchiche tra questi oggetti. Questa può essere un'alternativa utile per navigare nel progetto per file o cartella.

Visualizzazione degli oggetti in un progetto

Il riquadro del browser degli oggetti mostra i modelli, le esplorazioni, le visualizzazioni e i campi definiti nel progetto, nonché la gerarchia degli oggetti e il tipo di ciascun 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 li ordina alfabeticamente all'interno di ogni tipo. Utilizzando il riquadro del browser degli oggetti, puoi mostrare o nascondere le gerarchie di oggetti espandendoli o comprimendoli.

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 browser degli oggetti per comprimere o espandere l'oggetto. Per impostazione predefinita, qualsiasi modello di un progetto viene espanso nel riquadro del browser degli oggetti, mostrando un elenco delle esplorazioni definite nel modello.

Visualizzare il tipo di un oggetto

Il riquadro del browser degli 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 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 parametro secondario 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 la dimensione type: number:

Il browser degli 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 passare direttamente al codice LookML di un oggetto dal riquadro del browser degli oggetti:

Fai clic sul nome dell'oggetto.

Per accedere al codice LookML di un oggetto:

  1. Nel riquadro del browser degli 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.

Ricerca dell'oggetto

Per cercare un oggetto o un file:

  1. Nel riquadro del browser degli oggetti, fai clic sull'icona Vai all'oggetto o al file .

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

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

Situazioni speciali

Visualizzazione degli oggetti importati nel riquadro del browser degli oggetti

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

Ad esempio, supponiamo che tu abbia utilizzato il parametro local_dependency nel file manifest del progetto per importare un progetto locale denominato e_redlook, che contiene una visualizzazione denominata product_facts:


# Your project
project_name: "e_thelook"

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

Per rendere disponibile la visualizzazione product_facts 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 product_facts Esplora nel riquadro del browser degli oggetti ed espandere l'esplorazione 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é si tratta di un file di progetto importato.

Visualizzazione degli oggetti estesi nel riquadro del browser degli oggetti

Se il tuo progetto include una visualizzazione o un'esplorazione che espande un'altra visualizzazione o esplorazione, puoi utilizzare il riquadro del browser degli oggetti per visualizzare e accedere al codice LookML dell'oggetto che espande. Quando espandi una visualizzazione che ne espande un'altra, il riquadro del browser degli oggetti mostra i campi della visualizzazione di base, oltre a eventuali campi aggiunti nella visualizzazione espansa.

Ad esempio, il seguente file di visualizzazione definisce una visualizzazione denominata user_with_age_extension che espande un'altra visualizzazione 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 visualizzazione di base users_extended sia i nuovi campi definiti nella visualizzazione user_with_age_extension.

Puoi accedere al codice LookML dell'oggetto esteso selezionandone il nome nel riquadro del browser degli oggetti.

Visualizzazione degli oggetti perfezionati nel riquadro del browser degli oggetti

Puoi utilizzare il riquadro del browser degli oggetti per visualizzare i contenuti di una visualizzazione o esplorazione perfezionata oppure per accedere a LookML per i perfezionamenti nel tuo progetto.

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

Quando fai clic sul nome di una visualizzazione o di un'esplorazione perfezionata nel riquadro del browser degli oggetti, l'IDE si apre sulla riga in LookML in cui è definita la raffinatezza. 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 che tu voglia aggiungere una nuova dimensione, country, alla visualizzazione user_with_age_extension senza modificare il codice 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 browser degli 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 dal basso verso l'alto all'interno di un singolo file e nell'ordine in cui i file sono 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 relativa ai perfezionamenti di LookML.