extends (per le visualizzazioni)

Questa pagina si riferisce al parametro extends che fa parte di una visualizzazione.

extends può essere utilizzato anche nell'ambito di un'esplorazione, come descritto nella pagina della documentazione dedicata al parametro extends (per le esplorazioni).

extends può essere utilizzato anche nell'ambito di una dashboard LookML, come descritto nella pagina della documentazione Parametri della dashboard.

Utilizzo

view: view_name {
  extends: [view_name, view_name, ...]
}
Gerarchia
view
extends
Valore predefinito
Nessuno

Accetta
Parentesi quadre contenenti un elenco di nomi delle visualizzazioni separati da virgole

Definizione

Il parametro extends ti consente di basarti sui contenuti e sulle impostazioni di un altro file di visualizzazione, utilizzando quest'ultimo come punto di partenza. In caso di conflitti, la visualizzazione di estensione utilizzerà le proprie impostazioni, ignorando quelle della visualizzazione estesa. Per i dettagli su come Looker esegue questa operazione, consulta Riutilizzare il codice con extends.

Scopri i perfezionamenti di LookML.

L'estensione di una visualizzazione o di un'esplorazione è ideale per gli scenari in cui vuoi avere più versioni della visualizzazione o dell'esplorazione. Tuttavia, se il tuo obiettivo è semplicemente modificare una vista o un'esplorazione senza modificare il file LookML che la contiene, ti consigliamo di utilizzare un perfezionamento. Puoi anche utilizzare un parametro extends all'interno di un perfezionamento. Per ulteriori informazioni e casi d'uso, consulta la pagina della documentazione relativa ai miglioramenti di LookML.

Quando estendi una vista, è importante utilizzare il parametro sql_table_name nella vista da estendere, se non è già presente. Il parametro sql_table_name definisce la tabella del database su cui verrà eseguita una query da una vista. Per qualsiasi visualizzazione, il valore predefinito è il nome della visualizzazione. Pertanto, se non utilizzi già sql_table_name, assegnagli lo stesso valore del nome della vista.

È anche importante che nel nuovo file della visualizzazione utilizziamo il parametro include per indicare il nome file della visualizzazione che vogliamo estendere.

Evita di estendere le viste basate su tabelle derivate permanenti (PDT). Ogni estensione di una PDT creerà una nuova copia della tabella nel database. In questo caso, ti consigliamo di utilizzare i perfezionamenti LookML. Per ulteriori informazioni e casi d'uso, consulta la pagina della documentazione relativa ai miglioramenti di LookML.

Esempio

Ecco un esempio di file di visualizzazione che possiamo estendere. La vista è denominata looker_events e il nome del file della vista è events.view.

File: events.view 

view: looker_events {
  sql_table_name: looker_db.events ;;
  # The normal contents of the view follow
}

Ora creiamo un nuovo file di visualizzazione e definiamo una visualizzazione che estende la visualizzazione looker_events. Nel nuovo file, dobbiamo utilizzare il parametro include per indicare il nome del file della visualizzazione che vogliamo estendere:

File: new_events.view 

include: "events.view"
view: name_of_the_new_view {
  extends: [looker_events]

  measure: additional_measure {
    type: count
  }
  # Additional things you want to add or change
}

Abbiamo poi aggiunto una nuova misura che verrà visualizzata nella nuova visualizzazione, oltre a tutte le dimensioni e le misure definite nella visualizzazione looker_events che abbiamo esteso.

Utilizzare i metadati per visualizzare le estensioni di un oggetto

Puoi fare clic su un parametro explore o view in Looker IDE e utilizzare il riquadro dei metadati per visualizzare eventuali estensioni dell'oggetto o per vedere a quale oggetto si estende. Per informazioni, consulta la pagina della documentazione Metadati per gli oggetti LookML.

Aspetti da considerare

Alcuni parametri sono additivi

In molti casi, se l'oggetto di estensione contiene lo stesso parametro dell'oggetto esteso, i valori dell'oggetto di estensione sostituiranno i valori dei parametri dell'oggetto esteso.

Tuttavia, le estensioni possono essere additive per alcuni parametri, il che significa che i valori dell'oggetto di estensione vengono utilizzati insieme a quelli dell'oggetto esteso.

I seguenti parametri sono additivi:

Nel seguente esempio, la vista carriers ha una dimensione name con un parametro link:

view: carriers {
  sql_table_name: flightstats.carriers ;;

  dimension: name {
    sql: ${TABLE}.name ;;
    type: string
    link: {
      label: "Google {{ value }}"
      url: "http://www.google.com/search?q={{ value }}"
      icon_url: "http://google.com/favicon.ico"
    }
  }
}

Ecco la visualizzazione carriers_extended, che estende la visualizzazione carriers. La visualizzazione carriers_extended ha anche una dimensione name con impostazioni diverse nel parametro link:


include: "/views/carriers.view.lkml"

view: carriers_extended {
  extends: [carriers]

  dimension: name {
    sql: ${TABLE}.name ;;
    type: string
    link: {
      label: "Dashboard for {{ value }}"
      url: "https://docsexamples.dev.looker.com/dashboards/307?Carrier={{ value }}"
      icon_url: "https://www.looker.com/favicon.ico"
    }
  }
}

Nella visualizzazione carriers_extended, i due parametri link sono additivi, quindi la dimensione name avrà entrambi i link.

Progetti con localizzazione

Quando estendi un oggetto, tieni presente che anche alle tue estensioni si applicano le regole di localizzazione. Se estendi un oggetto e poi definisci nuove etichette o descrizioni, devi fornire le definizioni di localizzazione nei file di stringhe delle impostazioni internazionali del progetto. Per ulteriori informazioni, consulta la pagina della documentazione Localizzazione del modello LookML.