Scrivere LookML con l'assistenza di Gemini

Questa pagina di documentazione descrive come utilizzare l'assistenza Gemini per creare dimensioni, gruppi di dimensioni e misure in un progetto LookML. La generazione di suggerimenti per il codice LookML in risposta ai prompt scritti รจ una funzionalitร  di Gemini in Looker disponibile nelle istanze di Looker (originale) e Looker (Google Cloud core).

Gemini in Looker fornisce assistenza basata sull'AI generativa per aiutarti a utilizzare i tuoi dati.

Scopri come e quando Gemini per Google Cloud utilizza i tuoi dati.

Questa pagina รจ destinata agli sviluppatori di Looker.

Prima di iniziare

Per utilizzare Gemini nell'IDE di Looker, tieni presente i seguenti requisiti:

  • Gemini in Looker deve essere attivato per la tua istanza di Looker:
  • Devi disporre di un ruolo Looker che contenga l'autorizzazione develop per almeno un modello in un progetto LookML.
  • Devi disporre del ruolo Gemini di Looker.

Usare Gemini nell'IDE di Looker

Per utilizzare Gemini per creare LookML nel tuo progetto Looker:

  1. Nella tua istanza di Looker, attiva la modalitร  di sviluppo.
  2. Apri il progetto nell'IDE di Looker.
  3. Utilizza il browser di file dell'IDE per aprire un file di visualizzazione LookML in cui vuoi inserire LookML.

  4. Seleziona l'icona Aiutami a scrivere il codice dal selettore del riquadro laterale.

    L'IDE di Looker con l'icona Aiutami a programmare evidenziata.

  5. Con il riquadro Aiutami a scrivere il codice aperto, fai clic per posizionare il cursore su una riga del file di visualizzazione LookML. In base al tipo di file LookML e alla posizione del cursore nel file, Gemini fornisce opzioni appropriate per guidarti, ad esempio Crea una dimensione o Crea una misura.

  6. Seleziona una delle seguenti opzioni dal riquadro Aiutami a scrivere il codice:

    • Creare un gruppo di dimensioni
    • Creare una dimensione
    • Creare una misura
    • Altro suggerimento di codice: puoi utilizzare l'opzione Altro suggerimento di codice se vuoi provare diversi elementi LookML. Ricorda che Gemini รจ una tecnologia in fase iniziale, quindi verifica e testa tutti gli output prima di eseguirne il deployment.

  7. Nel campo di testo del riquadro Aiutami a scrivere il codice, utilizza un linguaggio colloquiale per descrivere la dimensione, il gruppo di dimensioni o la metrica che vuoi creare. Per indicazioni, consulta le sezioni Suggerimenti per l'utilizzo di Gemini nell'IDE di Looker ed Esempi di prompt in questa pagina.

  8. Premi Invio o fai clic sull'icona Invia per inviare la richiesta a Gemini. Gemini risponderร  con il codice suggerito.

  9. Con il codice suggerito, puoi:

    • Tieni il puntatore sopra il pulsante Inserisci per visualizzare l'anteprima del codice LookML suggerito nel file. Puoi spostare il cursore su una riga diversa del file per visualizzarne l'anteprima in una posizione diversa prima di inserire il codice LookML nel file.
    • Fai clic sul pulsante Modifica per modificare manualmente il codice LookML suggerito.
    • Fai clic sul pulsante Inserisci per inserire il codice LookML nel file nella posizione del cursore.
    • Fornisci un feedback sul codice suggerito selezionando l'icona Mi piace (Questa risposta รจ stata utile) o Non mi piace (Questa risposta non รจ stata soddisfacente).
    • Fai clic sul link Nuovo suggerimento di codice per ricominciare e inserire un nuovo prompt per Gemini.

    Gemini che mostra un'anteprima del posizionamento del codice quando il cursore passa sopra il pulsante Inserisci.

  10. Fai clic su Salva modifiche nel file LookML.

  11. Verifica il codice LookML procedendo nel seguente modo:

Suggerimenti per l'utilizzo di Gemini nell'IDE di Looker

Ecco alcuni suggerimenti per l'utilizzo di Gemini nell'IDE di Looker:

  • Per risultati ottimali, scrivi i prompt in inglese americano. Per ulteriori informazioni, consulta la documentazione relativa alle limitazioni di Gemini Google Cloud .
  • Il riquadro Aiutami a programmare non conserva il contesto di un prompt precedente nella conversazione e non conserva i prompt tra accessi e aggiornamenti.
  • Quando utilizzi il codice LookML suggerito da Gemini, convalidalo sempre con lo strumento di convalida LookML e testa i nuovi campi in un'esplorazione.
  • A seconda della tua richiesta, Gemini potrebbe suggerire LookML che fa riferimento a campi in altri file di visualizzazione. Quando aggiungi il codice LookML suggerito al file, salvalo ed esegui lo strumento di convalida LookML. Il validatore LookML mostrerร  gli errori se devi aggiungere istruzioni include al file del modello.

Prompt di esempio

Per darti qualche idea, ecco alcuni prompt di esempio e i relativi risultati:

Creare una dimensione utilizzando la longitudine e la latitudine

Ecco un prompt che utilizza l'opzione Crea una dimensione e chiede a Gemini di creare una nuova dimensione basata sui campi longitude e latitude definiti nel file della visualizzazione:

show coordinates with longitude and latitude

Gemini restituisce questo codice suggerito:

   dimension: coordinates {
      type: location
      sql_latitude: ${TABLE}.latitude ;;
      sql_longitude: ${TABLE}.longitude ;;
   }

Puoi verificare questo LookML in un'esplorazione selezionando il nuovo campo coordinates, insieme ai campi longitude e latitude su cui si basa. Poichรฉ Gemini ha creato la dimensione utilizzando type:location, i risultati dell'esplorazione includono un link ipertestuale per visualizzare le coordinate su una mappa:

Looker Explore che mostra i campi di latitudine e longitudine, con il nuovo campo delle coordinate con valori corrispondenti a quelli di latitudine e longitudine.

Crea una misura per le vendite totali di oggi

Ecco un prompt che utilizza l'opzione Crea una misura e chiede a Gemini di creare una nuova misura per la somma di tutti gli ordini di oggi:

show the total sale price of today's orders

Gemini restituisce questo codice suggerito:

   measure: todays_orders {
      type: sum
      sql: ${basic_order_items.sale_price} ;;
      filters: [basic_order_items.created_at_date: "today"]
  }

Invia il tuo feedback

Puoi fornire feedback sul codice LookML generato nel riquadro Aiutami a scrivere codice. Se il codice LookML generato sembra corretto, fai clic sull'icona Mi piace thumb_up. Se il codice LookML generato non sembra corretto o non รจ quello che ti aspettavi, fai clic sull'icona Non mi piace thumb_down.