Looker BlocksTM è un modello di dati predefinito per pattern di analisi e origini dati comuni. Questa pagina descrive come gli sviluppatori possono personalizzare i blocchi Looker installati da Looker Marketplace. Looker Marketplace è una posizione 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 blocchi di Looker disponibili, inclusi i blocchi non disponibili al momento in Looker Marketplace, e sui metodi di personalizzazione dei blocchi alternativi, consulta la pagina della documentazione sui blocchi di Looker.
Requisiti per l'installazione e la gestione di Looker Blocks da Looker Marketplace
Prima di poter installare e utilizzare alcuni blocchi da Looker Marketplace, l'amministratore di Looker deve abilitare queste funzionalità:
- Se stai installando il blocco tramite Looker Marketplace, l'amministratore di Looker deve attivare la funzionalità Marketplace.
Se il blocco specifico contiene un parametro
local_dependency, l'amministratore di Looker deve anche abilitare la funzionalità Labs progetto locale Labs. Questi blocchi contengono un parametrolocal_dependency:- Analisi dei dati di marketing digitale
- Analisi delle vendite
- Analisi dei dati web
Per installare e gestire i pacchetti dal Marketplace, gli utenti devono disporre delle autorizzazioni develop, manage_models e deploy.
Consulta la pagina della documentazione di Looker Marketplace per informazioni sull'installazione e sulla gestione di Looker Blocks da Looker Marketplace.
Accesso al codice LookML per un blocco del Marketplace
I blocchi basati su progetti che utilizzano perfezionamenti vengono installati dal Marketplace come un singolo progetto CONFIG modificabile, che importa da remoto il progetto CORE, che contiene tutto il codice LookML e la parametrizzazione costante.
Dopo aver installato un blocco dal Marketplace, puoi accedere al relativo progetto dal menu Sviluppo facendo clic sul nome del progetto nell'elenco dei progetti. Il nome di un blocco di perfezionamenti di Marketplace è generalmente preceduto da marketplace_ seguito dall'ID scheda.
Anche se non puoi modificare direttamente il progetto CORE di sola lettura di un blocco, potresti voler usare il LookML di LookML definito nei file CORE di sola lettura del blocco come riferimento quando personalizzi i file CONFIG del blocco. Per visualizzare i file CORE del blocco, vai ai file di progetto del blocco nell'IDE ed espandi la directory imported_projects nel browser dei file IDE:
Blocca struttura file
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 di modello virtualeassociato all'installazione del blocco; gestisce l'importazione di qualsiasi modello dal progetto CORE del blocco. Quando un blocco viene disinstallato o aggiornato, il file o i file modello associati vengono eliminati, impedendo conflitti di modelli tra più installazioni di blocchi. |
manifest.lkml |
Modificabile per gli utenti con autorizzazioni develop |
Descrive il progetto e le sue dipendenze esterne. Contiene l'ID scheda Marketplace per l'installazione di 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 informazioni specifiche sulla scheda, sulla versione e sul modello associate all'installazione. Contiene informazioni sulle costanti configurate durante l'installazione (e possono essere aggiornate utilizzando l'opzione Gestisci nella UI del 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. |
Personalizzazione di un blocco del Marketplace
Attiva la modalità di sviluppo per personalizzare le personalizzazioni dei file a blocchi.
Se hai le 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 che non sono già definite nel progetto CORE. Tutto ciò che è possibile ottenere con i perfezionamenti LookML in altri progetti LookML è possibile nel file refinements.lkml del blocco. La combinazione del perfezionamento e del LookML originale si comporta come se fosse il LookML originale dell'oggetto.
Puoi anche apportare modifiche al file manifest.lkml del progetto CONFIG per specificare tutte le dipendenze che devono essere acquisite per quel blocco.
Non è sufficiente modificare questi file per ottenere le personalizzazioni richieste. Puoi anche creare nuovi file nel progetto CONFIG. Assicurati di include tutti i nuovi file nel file refinements.lkml.
Personalizzare il file dei perfezionamenti
Se hai le autorizzazioni develop, puoi aggiungere un codice LookML personalizzato al progetto CONFIG per aggiungere altri dati o modificare il modello analitico principale del blocco. Puoi creare nuove viste e unirle a esplorazioni esistenti, definire nuovi campi o ridefinire i campi esistenti oppure applicare etichette, se necessario, per creare un modello per l'analisi che vuoi fornire. Se hai creato nuovi file nel progetto CONFIG, devi include inserirli nel file di perfezionamenti.
Ad esempio, supponiamo che tu abbia installato un blocco e che il relativo file refinements.lkml contenga:
include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"
dove listing_id è il valore del parametro listing dal file manifest.lkml.
Puoi utilizzare i perfezionamenti per aggiungere una nuova dimensione a una vista 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 chiamata aircraft in modo che risulti nell'interfaccia utente come Aereo semplificato:
include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"
explore: +aircraft {
label: "Aircraft Simplified"
}
Il file refinements.lkml viene incluso automaticamente nel file di modello "virtual" del blocco, che sostanzialmente importa i modelli dal progetto CORE.
Per ulteriori informazioni su questo argomento avanzato, consulta la documentazione relativa ai perfezionamenti LookML.
Personalizzare il file manifest modificabile
Nei blocchi che utilizzano i perfezionamenti, sia i progetti CORE che i progetti CONFIG hanno file manifest; tuttavia, solo il file manifest del progetto CONFIG è modificabile.
Puoi modificare il file manifest.lkml di CONFIG per aggiungere i parametri di progetto a quelli già visualizzati nel file manifest del progetto CORE. Ad esempio, puoi aggiungere local_dependency per aggiungere il tuo blocco a un altro blocco nella stessa istanza di Looker.
Prima di poter utilizzare o creare un blocco che contiene un parametro
local_dependency, un amministratore Looker deve prima attivare la funzionalità Labs progetto locale Labs.
Aggiornare i valori delle costanti
Le costanti del blocco sono definite nel file manifest del progetto CORE importato. L'override del valore di una costante, se consentito, 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 un valore di una costante aggiornando un blocco:
- In Looker Marketplace, vai al blocco che vuoi aggiornare.
- Fai clic sul pulsante Gestisci.
- Fai clic sull'icona a forma di ingranaggio accanto al nome del blocco che vuoi aggiornare. Viene visualizzata la finestra di configurazione del blocco.
- Modifica i valori costanti in base alle esigenze.
- Fai clic su Aggiorna per chiudere la finestra di configurazione del blocco e aggiornare il blocco con le modifiche apportate.
Le modifiche si riflettono nel file marketplace_lock.lkml di sola lettura nel progetto installato.
Preservare le personalizzazioni da un blocco di Marketplace che utilizza le estensioni
Alcuni dei blocchi disponibili in Looker Marketplace sono stati composti da progetti che utilizzano le estensioni LookML. 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 estensioni.
Looker consiglia di installare la versione basata sui perfezionamenti di qualsiasi blocco di Marketplace, presente sulla tua istanza, man mano che questi blocchi diventano disponibili, sostituendo quelli creati con estensioni. 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 (estendi) dalla pagina Manage (Gestisci) di Looker Marketplace; tuttavia, non verranno conservate le personalizzazioni apportate al blocco creato con le estensioni. Inoltre, Looker non trasferirà contenuti o funzioni di Looker basati su questi contenuti (dashboard, esplorazioni, distribuzione di contenuti pianificata, avvisi) dal blocco originale al nuovo blocco.
In questa sezione viene descritto come conservare le personalizzazioni in un blocco creato con progetti che utilizzano estensioni che altrimenti sarebbero difficili o dispendiose in termini di tempo da replicare da zero.
Per mantenere le personalizzazioni dei tuoi blocchi, un utente con la possibilità di installare e gestire pacchetti dal Marketplace deve:
- Aggiorna il progetto CONFIG del blocco originale per prepararti alla migrazione
- Installa la nuova versione del blocco da Looker Marketplace
- Trasferire le personalizzazioni al nuovo blocco del Marketplace
- Ricrea i contenuti di Looker in base al blocco originale
- Disinstallare la versione del blocco creato con estensioni
Aggiornare un blocco personalizzato per prepararsi alla migrazione
In questa sezione viene descritto come aggiornare i file di progetto principali in un blocco creato con estensioni 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 le estensioni viene installato dal Marketplace come progetto CORE di sola lettura e come progetto CONFIG modificabile.
Vai al progetto CONFIG del blocco dalla sezione Sviluppo in uno dei seguenti modi:
- Fai clic sull'opzione Progetti, quindi 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 il seguente aspetto:
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
}
}
-
- Elimina l'intera riga
extendseextension. - Elimina
_configdai nomiexplore. - Anteponi
+ai nomiexplore.
L'esempio del file modello precedente avrebbe il seguente aspetto:
- Elimina l'intera riga
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.
Installazione del nuovo blocco del Marketplace
Per scoprire di più sui blocchi già sottoposti a conversione, che vanno dall'estensione ai perfezionamenti, consulta la sezione Panoramica della versione di Looker 21. Per distinguere l'elenco delle estensioni di blocco dall'elenco dei blocchi dei perfezionamenti, puoi esaminare i numeri di versione. Il blocco estende sarà una versione principale dietro il blocco perfezionamenti. Ad esempio, il blocco estende può essere la versione
1.0.4e il blocco perfezionamenti può essere la versione2.0.0.
Un blocco basato su un progetto che utilizza i perfezionamenti viene installato dal Marketplace come singolo progetto LookML modificabile che importa da remoto il progetto contenente tutta la LookML e la parametrizzazione costante.
- Seleziona l'icona del negozio nella barra dei menu di Looker per accedere a Looker Marketplace.
- Fai clic sulla scheda relativa al nuovo blocco del Marketplace basato sui perfezionamenti. Questo blocco ha lo stesso nome del blocco esistente che è stato creato con estensioni.
- Fai clic su Installa per installare il nuovo blocco. Una volta installato questo blocco, nella pagina Manage (Gestisci) di Looker Marketplace vedrai due schede identiche.
Trasferimento delle personalizzazioni nel nuovo blocco del Marketplace
In questa sezione viene descritto come trasferire gli aggiornamenti apportati al blocco originale (estensioni) nel nuovo blocco (perfezionamenti).
Nella sezione Sviluppo, apri il progetto del nuovo blocco in uno dei seguenti modi:
- Fai clic sull'opzione Progetti, quindi sul nome del progetto.
- Fai clic sul nome del progetto nel blocco nell'elenco dei progetti.
Il nome di un blocco di perfezionamenti di Marketplace è generalmente preceduto da marketplace_ seguito dall'ID scheda.
Nel file
refinements.lkml, incolla i contenuti aggiornati dal file del modello di blocco originale (estende). Assicurati di conservare tutte le istruzioniincludeche si trovano già nel file dei perfezionamenti.
Ricreazione dei contenuti di Looker in base al blocco originale
Il passaggio finale nell'adozione della versione basata sui perfezionamenti di un blocco del Marketplace consiste nel disinstallare la versione originale basata su estensioni del blocco. Alcuni blocchi basati su estensioni contengono dashboard LookML predefinite ed esplorazioni. Se gli utenti hanno creato avvisi o distribuzione programmate basati su dashboard LookML definite nel blocco originale (estendi), i relativi avvisi o pianificazioni verranno disattivati o non andranno a buon fine una volta disinstallato il blocco da Looker Marketplace.
Devi ricreare questi avvisi o queste consegne programmate nelle dashboard LookML del nuovo blocco (perfezionamenti). Gli amministratori e gli utenti di Looker con le autorizzazioni appropriate per schedules e alerts possono utilizzare le pagine Alerts &s (Pianificazione) nella sezione di amministrazione per cercare i nomi delle dashboard di (extendes) del blocco e quindi creare nuovi avvisi o consegne programmate in base alle esigenze nei blocchi (perfezionamenti) corrispondenti.
Devi inoltre modificare qualsiasi altro contenuto di Looker che faccia riferimento alle esplorazioni del blocco originale (estendi) o delle dashboard di LookML in modo che reindirizzino al nuovo blocco (perfezionamenti), in base alle esigenze.
Disinstallazione del blocco originale
Per disinstallare la versione del blocco creato con estensioni:
Seleziona l'icona del negozio nella barra dei menu di Looker per accedere a Looker Marketplace.
In Looker Marketplace, seleziona Manage (Gestisci) nel riquadro di navigazione a sinistra per aprire la pagina Manage (Gestisci).
Nella pagina Gestisci, fai clic sull'icona del cestino per disinstallare il blocco originale (estensioni). Per distinguere l'elenco delle estensioni di blocco dall'elenco dei blocchi dei perfezionamenti, puoi esaminare i numeri di versione. Il blocco estende sarà una versione principale dietro il blocco perfezionamenti. Ad esempio, il blocco estende può essere la versione
1.0.4e il blocco perfezionamenti può essere la versione2.0.0.
Una volta disinstallato il blocco, la scheda di blocco originale (estensioni) scomparirà dalla barra di navigazione a sinistra nell'istanza di Looker, le relative esplorazioni scompariranno dalla sezione Explore, le dashboard LookML scompariranno dalla cartella Dashboard LookML e tutti gli avvisi o le pubblicazioni programmate basate sulla dashboard LookML del blocco verranno disattivati o avranno esito negativo.
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 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. Ecco come fare:
Seleziona l'icona del negozio nella barra dei menu di Looker per accedere a Looker Marketplace.
In Looker Marketplace, seleziona Manage (Gestisci) nel riquadro di navigazione a sinistra per aprire la pagina Manage (Gestisci).
Nella pagina Gestisci, fai clic sull'icona a forma di ingranaggio del blocco per visualizzare le relative impostazioni di configurazione.
Nella finestra Aggiorna configurazioni, verifica che il blocco sia configurato correttamente. Fai clic su Aggiorna dopo aver apportato eventuali modifiche per salvare gli aggiornamenti e chiudere la finestra di configurazione del blocco.