Personalizzazione dei blocchi di Looker Marketplace

I Looker Blocks sono modelli dei dati predefiniti per pattern di analisi e origini dati comuni. Questa pagina descrive in che modo gli sviluppatori possono personalizzare i Looker Blocks installati da Looker Marketplace. Il Looker Marketplace è una piattaforma centralizzata per trovare, eseguire il deployment e gestire molti tipi di contenuti Looker, come applicazioni, visualizzazioni e plug-in.

Per ulteriori informazioni su tutti i Looker Blocks disponibili e sui metodi alternativi di personalizzazione dei blocchi, consulta la pagina della documentazione di Looker Blocks.

Requisiti per l'installazione e la gestione dei Looker Blocks da Looker Marketplace

Prima di poter installare e utilizzare alcuni blocchi da Looker Marketplace, tieni presente i seguenti requisiti:

Se stai installando il blocco tramite Looker Marketplace, l'amministratore di Looker deve abilitare la funzionalità Marketplace.
Gli utenti devono disporre delle autorizzazioni develop, manage_models e deploy per installare e gestire i pacchetti da Marketplace.
Se il blocco specifico contiene un parametro local_dependency, utilizza il processo di importazione del progetto locale. Per informazioni dettagliate sull'importazione dei progetti, consulta la pagina della documentazione Importare file da altri progetti. I seguenti blocchi contengono un parametro local_dependency:
- Analisi dei dati di marketing digitale
- Analisi delle vendite
- Analisi dei dati web

Consulta la pagina della documentazione di Looker Marketplace per informazioni su installazione e gestione dei Looker Blocks da Looker Marketplace.

Accedere a LookML per un blocco di Marketplace

I blocchi basati su progetti che utilizzano i perfezionamenti vengono installati da Marketplace come un singolo progetto CONFIG modificabile che importa da remoto il progetto CORE, che contiene tutto il codice LookML e la parametrizzazione costante.

Una volta che un blocco è installato da Marketplace, puoi accedere al relativo progetto dal menu Sviluppa facendo clic sul nome del progetto nell'elenco dei progetti. In genere, il nome di un blocco di perfezionamenti di Marketplace è preceduto da marketplace_ seguito dall'ID scheda.

Sebbene non sia possibile modificare direttamente il progetto CORE di sola lettura di un blocco, potresti voler utilizzare il codice LookML definito nei file CORE di sola lettura del blocco come riferimento quando personalizzi i file CONFIG del blocco. Puoi visualizzare i file CORE del blocco accedendo ai file di progetto del blocco nell'IDE ed espandendo la imported_projects directory nel browser dei file IDE.

Struttura dei file di blocco

Quando installi un blocco creato per i perfezionamenti, questi file vengono creati automaticamente come parte della parte CONFIG del progetto di blocco:

Nome del file	Accesso	Funzione
`<model_name>.model.lkml`	Sola lettura per tutti gli utenti	File del modello virtuale collegato all'installazione del blocco; gestisce l'importazione di tutti i modelli dal progetto CORE del blocco. Quando un blocco viene disinstallato o aggiornato, i file del modello associati vengono eliminati, evitando conflitti tra i modelli tra più installazioni di blocchi.
`manifest.lkml`	Modificabile per gli utenti con autorizzazioni `develop`	Descrive il progetto e le relative dipendenze esterne. Contiene l'ID scheda di Marketplace per l'installazione del blocco e facilita l'importazione remota dei file di progetto CORE del blocco tramite la parola chiave `marketplace`.
`marketplace_lock.lkml`	Sola lettura per tutti gli utenti	Contiene un riferimento alla parola chiave `marketplace_ref` del file manifest che gestisce l'importazione remota del progetto CORE. Fornisce le informazioni specifiche su scheda, versione e modello associate all'installazione. Contiene informazioni sulle costanti configurate durante l'installazione (e che possono essere aggiornate utilizzando l'opzione Gestisci nell'interfaccia utente di Marketplace).
`refinements.lkml`	Modificabile per gli utenti con autorizzazioni `develop`	Consente agli sviluppatori di perfezionare le visualizzazioni e le esplorazioni definite nei file di progetto CORE importati.

Personalizzare un blocco di Marketplace

Attiva la modalità di sviluppo per apportare personalizzazioni ai file modificabili del blocco.

Se disponi delle autorizzazioni develop, puoi personalizzare il codice LookML nel file refinements.lkml del progetto CONFIG del blocco. Puoi perfezionare le visualizzazioni e le esplorazioni già definite nel progetto CORE del blocco o persino aggiungere nuove visualizzazioni ed esplorazioni non ancora definite nel progetto CORE. Tutto ciò che è possibile con i perfezionamenti LookML in altri progetti LookML è possibile nel file refinements.lkml del blocco. La combinazione del perfezionamento e del codice LookML originale si comporta come se fosse il codice LookML originale dell'oggetto.

Puoi anche apportare modifiche al file manifest.lkml del progetto CONFIG per specificare le dipendenze che devono essere acquisite per quel blocco.

Non sei limitato alla modifica di questi file per ottenere le personalizzazioni che vuoi. Puoi anche creare nuovi file nel progetto CONFIG, assicurandoti di include tutti i nuovi file nel file refinements.lkml.

Personalizzare il file di perfezionamenti

Se disponi delle autorizzazioni develop, puoi aggiungere codice LookML personalizzato al progetto CONFIG per combinare dati aggiuntivi o modificare il modello analitico principale del blocco. Puoi creare nuove visualizzazioni e unirle alle esplorazioni esistenti, definire nuovi campi o ridefinire i campi esistenti oppure applicare le etichette in base alle esigenze per creare un modello per l'analisi che vuoi fornire. Se hai creato nuovi file nel progetto CONFIG, devi include nel file di perfezionamenti.

Ad esempio, supponiamo che tu abbia installato un blocco e che il relativo file refinements.lkml contenga il seguente codice LookML:

include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"

dove listing_id è il valore del parametro listing del file manifest.lkml.

Puoi utilizzare i perfezionamenti per aggiungere una nuova dimensione a una visualizzazione denominata flights:

include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"

view: +flights {
  dimension: air_carrier {
    type: string
    sql: ${TABLE}.air_carrier ;;
  }
}

In alternativa, puoi applicare un'etichetta a un'esplorazione denominata aircraft in modo che venga visualizzata nell'interfaccia utente come Aircraft Simplified:

include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"

explore: +aircraft {
  label: "Aircraft Simplified"
}

Il file refinements.lkml viene incluso automaticamente nel file del modello "virtuale" del blocco, che importa essenzialmente i modelli dal progetto CORE.

Per ulteriori informazioni su questo argomento avanzato, consulta la documentazione sui perfezionamenti LookML.

Personalizzare il file manifest modificabile

Nei blocchi che utilizzano i perfezionamenti, sia il progetto CORE sia il progetto CONFIG hanno file manifest; tuttavia, solo il file manifest del progetto CONFIG è modificabile.

Puoi modificare il file CONFIG manifest.lkml per aggiungere i parametri del progetto a quelli già visualizzati nel file manifest del progetto CORE. Ad esempio, puoi aggiungere un local_dependency per unire il blocco a un altro blocco nella stessa istanza di Looker.

Aggiornare i valori delle costanti

Le costanti del blocco sono definite nel file manifest del progetto CORE importato. La sostituzione del valore di una costante, se consentita, deve essere eseguita nell'interfaccia utente di Marketplace durante la configurazione o aggiornando il blocco. Per aggiornare un blocco, gli utenti devono disporre delle autorizzazioni develop, manage_models e deploy.

Per sostituire il valore di una costante aggiornando un blocco:

In Looker Marketplace, vai al blocco che vuoi aggiornare.
Fai clic sul pulsante Gestisci.
Accanto al nome del blocco che vuoi aggiornare, fai clic sull'icona a forma di ingranaggio. Si apre la finestra di configurazione del blocco.
Apporta le modifiche necessarie ai valori delle costanti.
Fai clic su Aggiorna per chiudere la finestra di configurazione del blocco e aggiornare il blocco con le modifiche.

Le modifiche vengono applicate al file marketplace_lock.lkml di sola lettura nel progetto installato.

Conservare le personalizzazioni di un blocco di Marketplace che utilizza extends

Alcuni dei blocchi disponibili in Looker Marketplace erano composti da progetti che utilizzano LookML extends. Looker sta convertendo tutti i blocchi di Marketplace per le istanze su Looker 21.8 o versioni successive in una struttura di progetto che utilizza i perfezionamenti LookML e rimuoverà il supporto per i blocchi basati su extends.

Looker consiglia di installare la versione basata sui perfezionamenti di tutti i blocchi di Marketplace presenti nell'istanza non appena diventano disponibili, sostituendo i blocchi creati con extends. Sebbene questa procedura di sostituzione sia semplice (puoi installare il nuovo blocco (perfezionamenti) dalla scheda del blocco di Looker Marketplace e disinstallare il blocco originale (extends) nella pagina Gestisci di Looker Marketplace), non conserverà le personalizzazioni apportate al blocco creato con extends. Inoltre, Looker non trasferirà alcun contenuto o funzione di Looker basato su questi contenuti (dashboard, esplorazioni, consegne di contenuti programmate, avvisi) dal blocco originale al nuovo blocco.

Questa sezione descrive come conservare le personalizzazioni di un blocco creato con progetti che utilizzano extends, altrimenti difficili o dispendiose da replicare da zero.

Per conservare le personalizzazioni del blocco, un utente con la possibilità di installare e gestire i pacchetti da Marketplace deve eseguire i seguenti passaggi:

Aggiorna il progetto CONFIG del blocco originale per prepararlo alla migrazione
Installa la nuova versione del blocco da Looker Marketplace
Trasferisci le personalizzazioni al nuovo blocco di Marketplace
Ricrea i contenuti di Looker in base al blocco originale
Disinstalla la versione del blocco creata con extends

Aggiornare un blocco personalizzato per prepararlo alla migrazione

Questa sezione descrive come aggiornare i file di progetto chiave in un blocco creato con extends in modo da poter copiare le personalizzazioni del blocco in una nuova versione del blocco basata sui perfezionamenti. Un blocco basato su un progetto che utilizza extends viene installato da Marketplace come un progetto CORE di sola lettura e un progetto CONFIG modificabile.

Vai al progetto CONFIG del blocco dalla sezione Sviluppa in uno dei seguenti modi:
- Fai clic sull'opzione Progetti e poi sul nome del progetto.
- Fai clic sul nome del progetto CONFIG del blocco nell'elenco dei progetti.
In genere, i nomi dei progetti CONFIG terminano con _config, mentre il nome del progetto CORE in genere non ha un suffisso.
Apri il file del modello del progetto, che potrebbe avere un aspetto simile al seguente:


    explore: ga_sessions_config {
      extends: [ga_sessions_core]
      extension: required
      join: user_sales_data {
        sql_on: ${user_sales_data.full_visitor_id} = ${ga_sessions.full_visitor_id} ;;
      }
      join: sales__by__category {
        sql: LEFT JOIN UNNEST(${user_sales_data.sales_by_category}) as sales__by__category;;
      }
    }

    explore: future_input_config {
      extends: [future_input_core]
      extension: required
      join: future_purchase_prediction {
        type: left_outer
        sql_on: ${future_input.full_visitor_id} = ${future_purchase_prediction.full_visitor_id} ;;
        relationship: one_to_one
      }
    }

In modalità di sviluppo, segui questi passaggi:
1. Elimina le righe extends e extension complete.
2. Elimina _config dai nomi explore.
3. Aggiungi + ai nomi explore.
L'esempio precedente del file modello avrebbe il seguente aspetto:


    explore: +ga_sessions {
      join: user_sales_data {
        sql_on: ${user_sales_data.full_visitor_id} = ${ga_sessions.full_visitor_id} ;;
      }
      join: sales__by__category {
        sql: LEFT JOIN UNNEST(${user_sales_data.sales_by_category}) as sales__by__category;;
      }
    }

    explore: +future_input {
      join: future_purchase_prediction {
        type: left_outer
        sql_on: ${future_input.full_visitor_id} = ${future_purchase_prediction.full_visitor_id} ;;
        relationship: one_to_one
      }
    }

Copia e conserva i contenuti di questo file per un passaggio futuro.

Installare il nuovo blocco di Marketplace

Un blocco basato su un progetto che utilizza i perfezionamenti viene installato da Marketplace come un singolo progetto LookML modificabile che importa da remoto il progetto contenente tutto il codice LookML e la parametrizzazione costante.

Seleziona l'icona del negozio nella barra dei menu di Looker per andare a Looker Marketplace.
Fai clic sulla scheda del nuovo blocco di Marketplace basato sui perfezionamenti. Questo blocco ha lo stesso nome del blocco esistente creato con extends.
Fai clic su Installa per installare il nuovo blocco. Una volta installato questo blocco, vedrai due schede identiche nella pagina Gestisci di Looker Marketplace.

Trasferire le personalizzazioni al nuovo blocco di Marketplace

Questa sezione descrive come trasferire gli aggiornamenti apportati al blocco originale (extends) nel nuovo blocco (perfezionamenti).

Dalla sezione Sviluppa, apri il progetto del nuovo blocco in uno dei seguenti modi:
- Fai clic sull'opzione Progetti e poi sul nome del progetto.
- Fai clic sul nome del progetto del blocco nell'elenco dei progetti.
In genere, il nome di un blocco di perfezionamenti di Marketplace è preceduto da marketplace_ seguito dall'ID scheda.
Nel file refinements.lkml, incolla i contenuti aggiornati dal file del modello del blocco originale (extends). Assicurati di conservare le istruzioni include già presenti nel file di perfezionamenti.

Ricreare i contenuti di Looker in base al blocco originale

L'ultimo passaggio per adottare la versione basata sui perfezionamenti di un blocco di Marketplace è disinstallare la versione originale basata su extends del blocco. Alcuni blocchi basati su extends contengono dashboard e esplorazioni LookML predefinite. Se gli utenti hanno creato avvisi o consegne programmate basati su dashboard LookML definite nel blocco originale (extends), questi avvisi o pianificazioni verranno disattivati o non riusciranno, rispettivamente, una volta disinstallato il blocco da Looker Marketplace.

Devi ricreare questi avvisi o consegne programmate nelle dashboard LookML del nuovo blocco (perfezionamenti). Gli amministratori di Looker e gli utenti con le autorizzazioni appropriate per le pianificazioni e gli avvisi possono utilizzare le pagine Avvisi e pianificazioni nella sezione di amministrazione per cercare i nomi delle dashboard del blocco (extends) e poi creare nuovi avvisi o consegne programmate in base alle esigenze nelle dashboard corrispondenti del blocco (perfezionamenti).

Se necessario, devi anche modificare gli altri contenuti di Looker che fanno riferimento alle esplorazioni o alle dashboard LookML del blocco originale (extends) in modo che puntino al nuovo blocco (perfezionamenti).

Disinstallare il blocco originale

Per disinstallare la versione del blocco creata con extends:

Seleziona l'icona del negozio nella barra dei menu di Looker per andare a Looker Marketplace.
In Looker Marketplace, seleziona Gestisci nel menu di navigazione a sinistra per aprire la pagina Gestisci.
Nella pagina Gestisci, fai clic sull'icona del cestino per disinstallare il blocco originale (extends). Puoi distinguere l'elenco dei blocchi extends dall'elenco dei blocchi perfezionamenti esaminando i numeri di versione. Il blocco extends avrà una versione principale precedente al blocco perfezionamenti. Ad esempio, il blocco extends potrebbe essere la versione 1.0.4 e il blocco perfezionamenti potrebbe essere la versione 2.0.0.

Risolvere i problemi relativi a un blocco

Se un blocco di Marketplace mostra errori, è possibile che lo schema non corrisponda alla struttura del blocco.

Potresti anche voler verificare che le costanti fornite durante l'installazione del blocco, che rappresentano la connessione, il database o lo schema del blocco, siano state definite correttamente. A questo scopo, procedi nel seguente modo:

Seleziona l'icona del negozio nella barra dei menu di Looker per andare a Looker Marketplace.
In Looker Marketplace, seleziona Gestisci nel pannello di navigazione principale per aprire la pagina Gestisci.
Nella pagina Gestisci, fai clic sull'icona a forma di ingranaggio del blocco per visualizzarne le impostazioni di configurazione.
Nella finestra Aggiorna configurazioni, verifica che il blocco sia configurato correttamente. Fai clic su Aggiorna dopo aver apportato le modifiche per salvare gli aggiornamenti e chiudere la finestra di configurazione del blocco.