Eseguire il deployment dei Looker Blocks

Questa pagina descrive i passaggi per installare un Looker Block precompilato 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 precompilate e utilizzarle, devi prima eseguire le seguenti operazioni:

  1. Eseguire 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. Accedere a Looker:accedi a Looker e familiarizza con la piattaforma.
  3. Esplorare le dashboard disponibili: esplora le dashboard precompilate 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 il commit SHA 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 collegamento
    • 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.

<th">Parametro <th">Valore <th">Descrizione <th">Looker Blocks </th"></th"></th"></th"><td"> Connection Name <td"> Nome della connessione <td">Il nome della connessione BigQuery che consente a Looker di eseguire query sul set di dati REPORTING di Cortex. deve essere abilitato. <td">Tutti </td"></td"></td"></td"><td"> Project ID <td"> ID progetto <td">Il Google Cloud progetto in cui si trova il set di dati per i report in BigQuery. Per ulteriori informazioni, consulta Identificare i progetti. <td">Tutti </td"></td"></td"></td"><td"> Reporting Dataset <td">Nome del set di dati per i report <td">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 di Cortex Data Foundation, il nome di questo set di dati in genere termina con _REPORTING. <td">Tutti </td"></td"></td"></td"><td"> Client <td"> Numero cliente SAP (mandt) <td">Il numero cliente SAP (mandt) da utilizzare per i report. <td">SAP </td"></td"></td"></td"><td"> Sign Change <td"> Yes o No <td">Per i report sul conto economico reporting, le entrate vengono generalmente visualizzate nel libro mastro come numero negativo number, che indica un credito. Se imposti il valore di Sign Change su Yes, viene visualizzato come numero positivo nei report sul conto economico. <td">SAP </td"></td"></td"></td">

Requisiti aggiuntivi specifici per il blocco

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

<th">Blocco <th">Link ai requisiti aggiuntivi </th"></th"><td"> SAP <td">Specifiche aggiuntive per il Looker Block di Cortex Framework per SAP. </td"></td"><td"> Oracle EBS <td">Specifiche aggiuntive per il Looker Block di Cortex Framework per Oracle EBS. </td"></td">

Ulteriori risorse

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