si estende (per le visualizzazioni)

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

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

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

Utilizzo

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

Accetta
Parentesi quadre che contengono un elenco di nomi di viste separati da virgole

Definizione

Il parametro extends consente di utilizzare i contenuti e le impostazioni di un altro file di visualizzazione come punto di partenza, utilizzando l'altro file di visualizzazione. In caso di conflitti, la vista estesa utilizzerà le proprie impostazioni, sostituendo le impostazioni della vista estesa. Per informazioni dettagliate sulle modalità di esecuzione di Looker, vedi Riutilizzo di codice con estensioni.

Scopri i perfezionamenti di LookML.
L'estensione di una vista o di un'esplorazione è l'ideale per gli scenari in cui vuoi avere più versioni della vista o di un'esplorazione. Tuttavia, se il tuo obiettivo è semplicemente quello di modificare una vista o un'esplorazione senza modificare il file LookML che lo contiene, puoi 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 perfezionamenti LookML.

Quando estendi una vista, è importante utilizzare il parametro sql_table_name sulla vista che verrà estesa, se non è già presente. Il parametro sql_table_name definisce la tabella nel database che viene sottoposta a query da una vista. Per qualsiasi vista, il valore predefinito è il nome della vista. Pertanto, se non stai già utilizzando sql_table_name, ti basta assegnare lo stesso valore del nome della vista.

È anche importante che nel nuovo file di vista utilizziamo il parametro include per puntare al nome file della vista che vuoi estendere.

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

Esempio

Ecco un file di esempio di esempio che possiamo estendere. Il nome della visualizzazione è looker_events e 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 vista e definiamo una vista che estende la vista looker_events. Nel nuovo file, dobbiamo utilizzare il parametro include per puntare al nome del file della visualizzazione che vuoi 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
}

Inoltre, abbiamo aggiunto una nuova misura che verrà mostrata nella nuova vista oltre a tutte le dimensioni e le misure definite nella vista looker_events che abbiamo esteso.

Utilizzo dei metadati per visualizzare le estensioni per un oggetto

Puoi fare clic su un parametro explore o view nell'IDE di Looker e utilizzare il riquadro dei metadati per visualizzare le estensioni sull'oggetto o vedere quale oggetto si estende. Per informazioni, consulta la pagina Metadati degli oggetti LookML.

Aspetti da considerare

Alcuni parametri sono cumulativi

In molti casi, se l'oggetto in estensione contiene lo stesso parametro dell'oggetto in fase di estensione, i valori dell'oggetto che viene esteso sostituiscono quelli dell'oggetto esteso.

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

I seguenti parametri sono additive:

Nell'esempio seguente, 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"
    }
  }
}

Questa è la vista carriers_extended, che estende la visualizzazione carriers. La vista 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 vista carriers_extended, i due parametri link sono cumulativi, quindi la dimensione name avrà entrambi i link. La dimensione è simile a quella di un'esplorazione:

Progetti con localizzazione

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