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

Questa pagina è stata tradotta dall'API Cloud Translation.

Personalizzazione dei blocchi di Looker Marketplace

I Looker Blocks™ sono modelli di dati predefiniti per pattern di analisi e origini dati comuni. In questa pagina viene descritto come gli sviluppatori possono personalizzare i Looker Blocks installati da Looker Marketplace. Looker Marketplace è una piattaforma centralizzata per trovare, eseguire il deployment e gestire molti tipi di contenuti di Looker, come applicazioni, visualizzazioni e plug-in.

Per ulteriori informazioni su tutti i Looker Blocks disponibili, inclusi i blocchi non attualmente disponibili in Looker Marketplace, nonché su metodi alternativi di personalizzazione dei blocchi, consulta la pagina della documentazione Looker Blocks.

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

Prima di poter installare e utilizzare alcuni blocchi di Looker Marketplace, l'amministratore di Looker deve abilitare le seguenti funzionalità:

Se stai installando il blocco tramite Looker Marketplace, l'amministratore di Looker deve abilitare la funzionalità Marketplace.
Se un determinato blocco contiene un parametro local_dependency, l'amministratore di Looker deve abilitare anche la funzionalità di importazione di progetti locali Labs. Questi blocchi contengono un parametro local_dependency:
- Dati e analisi di marketing digitale
- Dati e analisi di vendita
- Dati e analisi web

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

Per informazioni sull'installazione e sulla gestione di Looker Blocks da Looker Marketplace, consulta la pagina della documentazione di Looker Marketplace.

Accesso a LookML per un blocco di Marketplace

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

Una volta installato dal marketplace, puoi accedere al progetto dal menu Sviluppa facendo clic sul nome del progetto nell'elenco dei progetti. Al nome di un blocco di perfezionamenti del marketplace viene solitamente anteposto marketplace_ seguito dall'ID scheda.

Sebbene non sia possibile modificare direttamente il progetto CORE di sola lettura di un blocco, è consigliabile 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 passando ai file di progetto del blocco nell'IDE ed espandendo la directory imported_projects nel browser dei file dell'IDE.

Blocca la struttura del file

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

Nome del file	Accesso	Funzione
`<model_name>.model.lkml`	Di sola lettura per tutti gli utenti	File del modello virtuale associato all'installazione del blocco; gestisce l'importazione di eventuali modelli dal progetto CORE del blocco. Quando un blocco viene disinstallato o aggiornato, i file del modello associati vengono eliminati, evitando 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 del marketplace per l'installazione del blocco e facilita l'importazione da remoto dei file del progetto CORE del blocco tramite la parola chiave `marketplace`.
`marketplace_lock.lkml`	Di 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 elenco, 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 viste e le esplorazioni definite nei file di progetto CORE importati.

Personalizzare un blocco del marketplace

Attiva la modalità 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 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 di perfezionamento e 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 eventuali dipendenze da acquisire per il blocco in questione.

Non sei limitato alla modifica di questi file per ottenere le personalizzazioni desiderate. Puoi anche creare nuovi file nel progetto CONFIG, ma assicurati di include i nuovi file nel file refinements.lkml.

Personalizzazione del file di perfezionamento

Se disponi delle autorizzazioni develop, puoi aggiungere un LookML personalizzato al progetto CONFIG per combinare altri dati o modificare il modello analitico di base del blocco. Puoi creare nuove visualizzazioni e unirli a esplorazioni esistenti, definire nuovi campi o ridefinire quelli 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 di perfezionamento.

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 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 Aeromobili semplificati:

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 essenzialmente importa i modelli dal progetto CORE.

Per ulteriori informazioni su questo argomento avanzato, consulta la documentazione relativa ai perfezionamenti di LookML.

Personalizzazione del file manifest modificabile

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

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

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

Aggiornamento dei 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 eseguito nell'interfaccia utente del 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.
Fai clic sull'icona a forma di ingranaggio accanto al nome del blocco da 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.

Le modifiche verranno applicate al file marketplace_lock.lkml di sola lettura del progetto installato.

Preservare le personalizzazioni di un blocco del marketplace che utilizza estensioni

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

Looker consiglia di installare la versione basata sui perfezionamenti di tutti i blocchi del marketplace presenti nella tua istanza man mano che diventano disponibili, sostituendo i blocchi creati con gli estensioni. Sebbene questa procedura di sostituzione sia semplice, puoi installare il nuovo blocco (affinamenti) dall'elenco dei blocchi di Looker Marketplace e disinstallare il blocco originale (estensioni) nella pagina Gestisci di Looker Marketplace, ma non verranno conservate le personalizzazioni che potrebbero essere state apportate al blocco creato con gli elementi di estensione. Inoltre, Looker non trasferirà funzioni o contenuti di Looker basati su questi contenuti (dashboard, esplorazioni, caricamenti pianificati di contenuti, avvisi) dal blocco originale al nuovo blocco.

Questa sezione descrive come conservare eventuali personalizzazioni di un blocco creato con progetti che utilizzano estensioni che altrimenti sarebbero difficili o dispendiose in termini di tempo da replicare da zero.

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

Aggiorna il progetto CONFIG del blocco originale in vista della migrazione
Installa la nuova versione del blocco da Looker Marketplace
Trasferire le personalizzazioni al nuovo blocco del marketplace
Rigenerare i contenuti di Looker in base al blocco originale
Disinstalla la versione del blocco creata con extends

Aggiornamento di un blocco personalizzato per preparare la migrazione

Questa sezione descrive come aggiornare i file di progetto chiave in un blocco che è stato 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 come progetto CONFIG modificabile.

Vai al progetto CONFIG del blocco dalla sezione Sviluppa 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.
I nomi dei progetti CONFIG terminano in genere 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 le righe extends e extension.
2. Elimina _config dai nomi explore.
3. Anteponi + ai nomi explore.
Il precedente esempio di file di modello 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 successivo.

Installazione del nuovo blocco del marketplace

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

Seleziona l'icona del negozio nella barra dei menu di Looker per accedere al marketplace di Looker.
Fai clic sull'elenco del nuovo blocco del marketplace basato sui perfezionamenti. Questo blocco ha lo stesso nome del blocco esistente che è stato 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 al nuovo blocco del Marketplace

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

Nella 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.
Al nome di un blocco di perfezionamenti del marketplace viene solitamente anteposto 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 i contenuti di Looker in base al blocco originale

Il passaggio finale per adottare la versione basata sui perfezionamenti di un blocco del marketplace è disinstallare la versione originale basata sugli estensioni del blocco. Alcuni blocchi basati su estensioni contengono esplorazioni e dashboard LookML predefiniti. Se gli utenti hanno creato avvisi o pubblicazioni pianificate basati su dashboard LookML definite nel blocco originale (estensioni), questi avvisi o pianificazioni verranno disattivati o non andranno a buon fine, rispettivamente, una volta disinstallato il blocco dal marketplace di Looker.

Devi ricreare questi avvisi o pubblicazioni pianificate nelle dashboard LookML del nuovo blocco (affinamenti). 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 Amministrazione per cercare i nomi delle dashboard del blocco (estensioni) e creare nuovi avvisi o pubblicazioni pianificate in base alle esigenze nelle dashboard corrispondenti del blocco (ottimizzazioni).

Devi anche modificare qualsiasi altro contenuto Looker che fa riferimento alle esplorazioni o alle dashboard LookML del blocco originale (estende) in modo che puntino al nuovo blocco (perfezionamenti), se necessario.

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 accedere al marketplace di Looker.
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 (estensioni). Puoi distinguere l'elenco di blocchi di estensione dall'elenco di blocchi di perfezionamento osservando i numeri delle versioni. Il blocco delle estensioni sarà 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 menu di navigazione a sinistra nell'istanza di Looker, le relative esplorazioni scompariranno dalla sezione Esplora, le relative dashboard LookML scompariranno dalla cartella dashboard LookML e tutti gli avvisi o caricamenti pianificati basati sulle dashboard LookML del blocco verranno disabilitati o non andranno a buon fine, rispettivamente.

Risolvere i problemi relativi a un blocco

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

Puoi anche controllare 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, puoi:

Seleziona l'icona del negozio nella barra dei menu di Looker per accedere al marketplace di Looker.
Nel marketplace di Looker, 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 visualizzare le relative impostazioni di configurazione.
Nella finestra Aggiorna configurazioni, verifica che il blocco sia configurato correttamente. Fai clic su Aggiorna dopo aver apportato le modifiche per salvarle e chiudere la finestra di configurazione del blocco.