Eseguire il deployment dei Looker Blocks

Questa pagina descrive i passaggi per installare un Looker Block predefinito per Cortex Framework che si trova in un repository GitHub pubblico, ad esempio:

Per il deployment della dashboard di Looker per Dun & Bradstreet, consulta Dashboard di Data Studio per Dun & Bradstreet.

Prerequisiti

Per accedere a queste dashboard predefinite e utilizzarle, devi prima eseguire le seguenti operazioni:

  1. Esegui il deployment di Cortex Framework: assicurati di aver configurato Cortex Framework con le tue origini dati. Per ulteriori informazioni, consulta Prerequisiti di Cortex Framework per il deployment.
  2. Accedi a Looker:accedi a Looker e familiarizza con la piattaforma.
  3. Esplora le dashboard disponibili: esplora le dashboard predefinite e gli insight disponibili nella dashboard di cui vuoi eseguire il deployment. Per ulteriori informazioni, consulta Looker Blocks disponibili.

Dopo aver completato i prerequisiti, puoi installare il Looker Block.

Installazione

I Looker Blocks utilizzano LookML (Looker Modeling Language) per definire il modello semantico per le dashboard di Looker. Per installare il modello LookML corrispondente all'origine dati Cortex, utilizza una delle seguenti opzioni:

  • Opzione A: installa tramite Looker Marketplace da un URL Git.
  • Opzione B: installa creando un fork del repository.

Le sezioni seguenti descrivono i passaggi per ogni opzione.

Opzione A: installa tramite Looker Marketplace da un URL Git

Il Looker Marketplace è una posizione centralizzata all'interno di Looker per trovare, eseguire il deployment e gestire Looker Blocks, applicazioni, visualizzazioni e plug-in. Per installare tramite Looker Marketplace da un URL Git:

  1. Vai all'istanza di Looker.
  2. Fai clic sul pulsante Marketplace nella barra dei menu di Looker .
  3. Dal menu Marketplace, seleziona l'opzione Gestisci.
  4. Nella pagina Gestisci, seleziona il menu con tre puntini Opzioni .
  5. Seleziona il pulsante Installa tramite URL Git.
  6. Inserisci l'URL e l'SHA del commit del repository scelto:
  7. Fai clic su Installa.
  8. Accetta e continua nella finestra di dialogo dei termini e condizioni.
  9. Inserisci i parametri obbligatori corrispondenti ai tuoi dati:
    • Nome connessione
    • ID progetto
    • Set di dati per i report
  10. Fai clic su Installa.

Per ulteriori informazioni, consulta la documentazione di Looker relativa all'installazione di uno strumento da un URL Git.

Opzione B: installa creando un fork del repository

Per installare i Looker Blocks creando un fork del repository:

  1. Crea un fork del repository GitHub:

    1. Vai al repository GitHub del Looker Block scelto:
    2. Fai clic su Fork nell'angolo in alto a destra del repository.
    3. Crea un fork con il tuo nome utente. Viene creata una copia del repository nel tuo account GitHub.

  2. Crea un progetto LookML vuoto:

    1. Verifica di essere in modalità di sviluppo.
    2. Seleziona Progetti dal menu Sviluppa.

    3. Nella parte in alto a sinistra della pagina Progetti LookML, seleziona Configura nuovo modello per aprire la pagina Configura un modello.

    4. Nella pagina Configura un modello, specifica le opzioni per il modello:

      1. Modello: assegna al modello lo stesso nome del file model.lkml nel repository. Ad esempio, assegna al modello cortex-<datasource>.

      2. Progetto: assegna un nome al progetto. Assegna al progetto lo stesso nome del modello o specifica un nome diverso.

      3. Connessioni consentite:specifica le connessioni ai database che possono essere utilizzate dal modello oppure specifica che il modello può utilizzare qualsiasi connessione attuale o futura.

    5. Fai clic su Salva per salvare il progetto come Progetto in attesa.

    6. Nella pagina Progetti LookML, individua il nuovo progetto nella sezione Progetti in attesa.

    7. Fai clic su Aggiungi LookML per aprire la pagina Nuovo progetto.

    8. Nella pagina Nuovo progetto, specifica le opzioni per il tuo progetto:

      1. Nome progetto: già compilato con il valore specificato nel passaggio precedente.
      2. Punto di partenza: seleziona Progetto vuoto.

    9. Seleziona Crea progetto. Looker crea il progetto e lo apre nell'IDE di Looker.

    Per ulteriori informazioni, consulta la documentazione originale di Looker relativa alla generazione di un modello LookML.

  3. Collega il nuovo progetto LookML al repository di cui hai creato un fork: segui i passaggi descritti nella documentazione di Looker, Configurazione e test di una connessione Git.

  4. Aggiorna i valori delle costanti nel file manifest.lkml:

    1. Apri il file manifest.lkml nel repository di cui hai creato un fork in Looker.
    2. Individua la sezione delle costanti e aggiorna i valori come descritto nella sezione Parametri obbligatori.

  5. Esegui il commit e il deployment delle modifiche in produzione. Con il progetto Looker basato sul repository di cui hai creato un fork, puoi personalizzare LookML in base alle esigenze specifiche della tua attività. Segui i passaggi descritti in Trasferire le modifiche in produzione.

Parametri obbligatori

Questi valori obbligatori vengono configurati durante la procedura di installazione di Marketplace. Se questo blocco è stato installato da un repository Git di cui hai creato un fork, devi aggiornare i valori di queste costanti nel file manifest.lkml del progetto.

Parametro Valore Descrizione Looker Blocks
Connection Name Nome della connessione Il nome della connessione BigQuery che consente a Looker di eseguire query sul set di dati REPORTING di Cortex. deve essere abilitato. Tutti
Project ID ID progetto Il Google Cloud progetto in cui si trova il set di dati per i report in BigQuery. Per ulteriori informazioni, consulta Identificare i progetti. Tutti
Reporting Dataset Nome del set di dati per i report Il set di dati REPORTING di Cortex Data Foundation di cui è stato eseguito il deployment in cui si trovano le visualizzazioni del set di dati dell'origine dati all'interno del Google Cloud progetto BigQuery. A seconda delle impostazioni di deployment per Cortex Data Foundation, in genere il nome di questo set di dati segue il pattern che termina con _REPORTING. Tutti
Client Numero cliente SAP (mandt) Il numero cliente SAP (mandt) da utilizzare per i report. SAP
Sign Change Yes o No Per i report sul conto economico, le entrate vengono generalmente visualizzate nel libro mastro come numero negativo, che indica un credito. Se imposti il valore di Sign Change su Yes, viene visualizzato come numero positivo nei report sul conto economico. SAP

Requisiti aggiuntivi specifici per il blocco

Alcuni blocchi hanno requisiti specifici per il deployment. Per ulteriori informazioni, consulta il deployment specifico del blocco:

Blocca Link a requisiti aggiuntivi
SAP Specifiche aggiuntive per il Looker Block di Cortex Framework per SAP.
Oracle EBS Specifiche aggiuntive per il Looker Block di Cortex Framework per Oracle EBS.

Ulteriori risorse

Per ulteriori informazioni su LookML, consulta la seguente documentazione e la seguente formazione: