Tieni presente che stai visualizzando la documentazione di Looker. Per la documentazione di Looker Studio, visita https://support.google.com/looker-studio.

Personalizzazione dei blocchi di Looker Marketplace

I Looker BlocksTM sono modelli dati predefiniti per pattern analitici e origini dati comuni. In questa pagina viene descritto 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 saperne di più su tutti i blocchi Looker disponibili, inclusi quelli attualmente non disponibili in Looker Marketplace, e sui metodi alternativi di personalizzazione dei blocchi, consulta la pagina della documentazione relativa ai blocchi Looker.

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

Prima di poter installare e utilizzare alcuni blocchi da Looker Marketplace, l'amministratore di Looker deve abilitare le seguenti 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 attivare anche la funzionalità Importazione progetto locale Labs. Questi blocchi contengono un parametro local_dependency:
- Analisi del marketing digitale
- Analisi delle vendite
- Analisi dei dati web

Gli utenti devono disporre delle autorizzazioni develop, manage_models e deploy per installare e gestire i pacchetti dal Marketplace.

Consulta la pagina della documentazione di Looker Marketplace per informazioni sull'installazione e sulla gestione dei blocchi di Looker da Looker Marketplace.

Accesso a LookML per un blocco Marketplace

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

Dopo aver installato un blocco dal Marketplace, puoi accedere al progetto corrispondente dal menu Sviluppo facendo clic sul nome del progetto nell'elenco dei progetti. Il nome di un blocco perfezionamenti Marketplace è in genere preceduto da marketplace_ seguito dall'ID scheda.

Anche se non puoi modificare direttamente il progetto CORE di sola lettura di un blocco, potresti voler utilizzare il 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 directory imported_projects nel browser di file IDE.

Blocca struttura di file

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

Nome del file	Accesso	Funzione
`<model_name>.model.lkml`	Sola lettura per tutti gli utenti	File del modello Virtuale collegato all'installazione a blocchi; gestisce l'importazione di qualsiasi modello dal progetto CORE del blocco. Quando un blocco viene disinstallato o aggiornato, il file del modello o i file associati vengono eliminati, evitando conflitti di modelli tra installazioni di più 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 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` nel file manifest che gestisce l'importazione remota del progetto CORE. Fornisce informazioni specifiche sull'elenco, sulla versione e sul 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 viste e le esplorazioni definite nei file di progetto CORE importati.

Personalizzazione di un blocco Marketplace

Attiva la Modalità di sviluppo per personalizzare i file modificabili del blocco.

Se disponi delle autorizzazioni develop, puoi personalizzare il LookML nel file refinements.lkml del progetto CONFIG del blocco. Puoi perfezionare le viste e le esplorazioni già definite nel progetto CORE del blocco o anche aggiungere nuove viste ed esplorazioni che non sono già definite nel progetto CORE. Tutto ciò che è possibile con i perfezionamenti di 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 le dipendenze da acquisire per quel blocco.

Non devi limitarti a modificare questi file per ottenere le personalizzazioni desiderate. Puoi anche creare nuovi file nel progetto CONFIG, ma assicurati di include tutti i nuovi file nel file refinements.lkml.

Personalizzazione del file dei perfezionamenti

Se disponi di autorizzazioni develop, puoi aggiungere LookML personalizzato al progetto CONFIG per inserire altri dati o modificare il modello analitico di base del blocco. Puoi creare nuove viste e unirle alle esplorazioni esistenti, definire nuovi campi o ridefinire i campi esistenti oppure applicare 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 dei 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 nel 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 denominata aircraft in modo che venga visualizzata nell'interfaccia utente come velivolo 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 del modello "virtuale" del blocco, che sostanzialmente importa i modelli dal progetto CORE.

Consulta la documentazione relativa ai perfezionamenti di LookML per ulteriori informazioni su questo argomento avanzato.

Personalizzare il file manifest modificabile

Nei blocchi che utilizzano i perfezionamenti, i progetti CORE e CONFIG hanno file manifest; tuttavia, è possibile modificare solo il file manifest del progetto CONFIG.

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

Prima di poter utilizzare o creare su un blocco contenente un parametro local_dependency, un amministratore Looker deve abilitare la funzionalità Labs di Importazione progetto locale.

Aggiornamento dei valori per le costanti

Le constants 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 eseguire l'override del 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 da aggiornare. Viene visualizzata la finestra di configurazione dei blocchi.
Apporta le modifiche necessarie ai valori della costante.
Fai clic su Aggiorna per chiudere la finestra di configurazione dei blocchi e aggiornare il blocco con le modifiche.

Le modifiche si rifletteranno nel file di sola lettura marketplace_lock.lkml nel progetto installato.

Conservare le personalizzazioni di un blocco Marketplace che utilizza le estensioni

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

Looker consiglia di installare la versione basata sui perfezionamenti di qualsiasi blocco Marketplace presente nell'istanza man mano che questi blocchi diventano disponibili, sostituendo quelli creati con estensioni. Anche se questa procedura di sostituzione è semplice: puoi installare il nuovo blocco (perfezionamenti) dall'elenco dei blocchi di Looker Marketplace e disinstallare il blocco originale (estende) dalla pagina Gestisci in Looker Marketplace. In questo modo, non verranno conservate le personalizzazioni eventualmente apportate al blocco creato con estensioni. Inoltre, non trasferirà contenuti o funzioni di Looker basati su questi contenuti (dashboard, esplorazioni, caricamenti di contenuti pianificati, avvisi) dal blocco originale a quello nuovo.

Questa sezione descrive come preservare eventuali personalizzazioni di un blocco creato con progetti che utilizzano estensioni che altrimenti sarebbe difficile o dispendioso in termini di tempo da replicare da zero.

Per mantenere le personalizzazioni del blocco, un utente con la possibilità di installare e gestire pacchetti dal Marketplace deve:

Aggiorna il progetto CONFIG del blocco originale per prepararti alla migrazione
Installare la nuova versione del blocco da Looker Marketplace
Trasferisci le personalizzazioni al nuovo blocco Marketplace
Ricreare i contenuti di Looker in base al blocco originale
Disinstalla la versione del blocco creato con le estensioni

Aggiornamento di un blocco personalizzato per preparare la migrazione

Questa sezione descrive 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 estensioni viene installato dal Marketplace come progetto CORE di sola lettura e 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 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
      }
    }

In modalità di sviluppo:
1. Elimina tutte le righe extends e extension.
2. Elimina _config dai nomi di explore.
3. Anteponi + ai nomi explore.
L'esempio di file del modello precedente sarebbe simile al seguente:


    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 Marketplace

Un blocco basato su un progetto che utilizza i perfezionamenti viene installato dal Marketplace come un singolo progetto LookML modificabile che importa in remoto il progetto contenente tutti i 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 del nuovo blocco Marketplace basato sui perfezionamenti. Questo blocco ha lo stesso nome del blocco esistente creato con le estensioni.
Fai clic su Installa per installare il nuovo blocco. Una volta installato questo blocco, vedrai due schede identiche nella pagina Gestisci di Looker Marketplace.

Trasferimento delle personalizzazioni nel nuovo blocco Marketplace

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

Nella sezione Sviluppo, 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.
Il nome di un blocco perfezionamenti Marketplace è in genere preceduto da marketplace_ seguito dall'ID scheda.
Nel file refinements.lkml, incolla i contenuti aggiornati del file del modello del blocco originale (estende). Assicurati di conservare tutte le istruzioni include già presenti nel file dei perfezionamenti.

Ricreare contenuti di Looker in base al blocco originale

Il passaggio finale dell'adozione della versione basata sui perfezionamenti di un blocco Marketplace è la disinstallazione della versione originale basata sulle estensioni del blocco. Alcuni blocchi basati su estensioni contengono esplorazioni e dashboard LookML predefinite. Se gli utenti hanno creato avvisi o consegne programmate che si basano su qualsiasi dashboard LookML definita nel blocco originale (estensione), tali avvisi o pianificazioni saranno rispettivamente disattivati o non riusciti una volta disinstallato il blocco da Looker Marketplace.

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

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

Disinstallazione del blocco originale

Per disinstallare la versione del blocco creato con le estensioni:

Seleziona l'icona del negozio nella barra dei menu di Looker per accedere 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 (estende). Puoi distinguere l'elenco dei blocchi estesi dall'elenco dei blocchi per i perfezionamenti osservando i numeri di versione. Il blocco delle estensioni è una versione principale dietro il blocco dei perfezionamenti. Ad esempio, il blocco delle estensioni potrebbe essere la versione 1.0.4 e il blocco dei perfezionamenti potrebbe essere la versione 2.0.0.

Una volta disinstallato il blocco, l'elenco dei blocchi originale (estende) scomparirà dal riquadro di navigazione a sinistra nell'istanza di Looker, le relative esplorazioni scompariranno dalla sezione Esplora, le relative dashboard LookML scompaiono dalla cartella dashboard di LookML e tutti gli avvisi o le pubblicazioni pianificate basate sulle dashboard LookML del blocco verranno disabilitati o non andranno a buon fine, rispettivamente.

Risoluzione dei problemi relativi a un blocco

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

Potresti anche controllare che le constants fornite durante l'installazione del blocco, che rappresentano la connessione, il database o lo schema del blocco, siano state definite correttamente. A questo scopo, puoi:

Seleziona l'icona del negozio nella barra dei menu di Looker per accedere 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 a forma di ingranaggio del blocco per visualizzarne le impostazioni di configurazione.
Nella finestra Aggiorna configurazioni, verifica che il blocco sia configurato correttamente. Dopo aver apportato le modifiche, fai clic su Aggiorna per salvare gli aggiornamenti e chiudere la finestra di configurazione del blocco.