Esegui il deployment di Looker Blocks

Questa pagina descrive i passaggi per installare un blocco di Looker predefinito per Cortex Framework in un repository GitHub pubblico, ad esempio:

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

Prerequisiti

Per accedere e utilizzare queste dashboard predefinite, devi prima svolgere quanto segue:

  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 acquisisci familiarità con la piattaforma.
  3. Esplora le dashboard disponibili: esplora le dashboard predefinite e le informazioni disponibili nella dashboard che vuoi implementare. Per ulteriori informazioni, consulta la sezione Blocchi di Looker disponibili.

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

Installazione

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

  • Opzione A: installa tramite Looker Marketplace da un URL Git.
  • Opzione B: esegui l'installazione eseguendo il fork del repository.

Le sezioni seguenti descrivono i passaggi per ogni opzione.

Opzione A: installa tramite Looker Marketplace da un URL Git

Looker Marketplace è una piattaforma centralizzata all'interno di Looker per trovare, eseguire il deployment e gestire blocchi, applicazioni, visualizzazioni e plug-in di Looker. Per eseguire l'installazione 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 Opzioni con tre puntini .
  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. Fai clic su Accetta e continua nella finestra di dialogo dei Termini e condizioni.
  9. Inserisci i parametri obbligatori corrispondente 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 eseguendo il fork del repository

Per installare i blocchi di Looker eseguendo il 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. Verrà 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 Sviluppo.

    3. In alto a sinistra nella 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 il nome cortex-<datasource>.

      2. Project (Progetto): assegna un nome al progetto. Assegnagli lo stesso nome del modello o specifica un altro nome.

      3. Connessioni consentite:specifica le connessioni al 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 sulla generazione di un modello LookML.

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

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

    1. Apri il file manifest.lkml nel repository creato con 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 tuo repository sottoposto a fork, puoi personalizzare il LookML in base alle esigenze specifiche della tua attività. Segui i passaggi descritti in Eseguire il deployment delle modifiche in produzione.

Parametri obbligatori

Questi valori obbligatori vengono configurati durante la procedura di installazione del marketplace o, se questo blocco è stato installato da un repository Git sottoposto a forking, 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 Cortex REPORTING. deve essere attivata. Tutti
Project ID ID progetto Il Google Cloud progetto in cui risiede il set di dati dei report in BigQuery. Per ulteriori informazioni, consulta la sezione Identificazione dei progetti. Tutti
Reporting Dataset Nome del set di dati per i report Il set di dati REPORTING di Cortex Data Foundation di cui sono state implementate le visualizzazioni dei set di dati delle origini dati all'interno del progetto Google Cloud BigQuery. A seconda delle impostazioni di deployment per Cortex Data Foundation, in genere il nome di questo set di dati è del tipo 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 Utili e perdite/Bilancio di esercizio, le entrate vengono generalmente visualizzate nel libro mastro come numero negativo, che indica un credito. Se imposti il valore Modifica segno su Yes, viene visualizzato come numero positivo nei report del conto economico. SAP

Requisiti aggiuntivi specifici per blocco

Per il deployment di alcuni blocchi sono previsti requisiti specifici. Per ulteriori informazioni, consulta il deployment specifico per blocco:

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

Risorse aggiuntive

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