Scrivi SQL con l'assistenza di Gemini

Questo documento descrive come utilizzare Gemini, un collaboratore basato sull'IA in Google Cloud, per eseguire le seguenti operazioni in AlloyDB per PostgreSQL:

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

Questo documento è rivolto ad amministratori di database e data engineer che conoscono AlloyDB e hanno una certa familiarità con SQL e l'analisi dei dati. Se non hai mai utilizzato AlloyDB, consulta la panoramica di AlloyDB.

Prima di iniziare

  1. Assicurati che Gemini Cloud Assist sia configurato per il tuo Google Cloud account utente e il tuo progetto.

  2. (Facoltativo) Se vuoi seguire gli esempi in questo documento, crea la tabella Singers utilizzando lo schema seguente:

    CREATE TABLE Singers (
  BirthDate  TIMESTAMPTZ,
  SingerId   BIGINT PRIMARY KEY,
  FirstName  VARCHAR(1024),
  LastName   VARCHAR(1024),
  SingerInfo BYTEA
);

    Dopo aver creato la tabella Singers, fai clic su AggiornaAggiorna per aggiornare lo schema del database.

Per disattivare le funzionalità di Gemini in AlloyDB, ripeti questo passaggio, quindi deseleziona le funzionalità di Gemini che vuoi disattivare.

Ruoli e autorizzazioni richiesti

Per utilizzare Gemini con AlloyDB, devi disporre delle seguenti autorizzazioni:

  • alloydb.clusters.get
  • alloydb.databases.list
  • alloydb.instances.executeSql
  • alloydb.instances.list
  • alloydb.users.list

Puoi ottenere questa autorizzazione tramite il ruolo roles/alloydb.admin. Se non disponi di questo ruolo, contatta l'amministratore dell'organizzazione per richiedere l'accesso. Potresti anche riuscire a ottenere le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.

Inoltre, assicurati di disporre delle autorizzazioni a livello di database per il database che utilizzi per l'autenticazione.

Genera query SQL utilizzando prompt in linguaggio naturale

Puoi fornire a Gemini commenti (o prompt) in linguaggio naturale per generare query basate sul tuo schema. Ad esempio, puoi chiedere a Gemini di generare SQL in risposta ai seguenti prompt:

  • "Crea una tabella che monitori i risultati del sondaggio sulla soddisfazione dei clienti".
  • "Aggiungi una colonna di date denominata compleanno alla tabella Cantanti."
  • "Quanti cantanti sono nati negli anni '90?"

Se lo schema cambia, ad esempio con l'aggiunta di una nuova tabella o colonna, devi fare clic su AggiornaAggiorna per aggiornarlo prima di utilizzare Gemini.

Per generare SQL in AlloyDB con l'assistenza di Gemini:

  1. Nella console Google Cloud, apri la pagina AlloyDB.

    Passa ad AlloyDB

  2. Seleziona un cluster dall'elenco.

  3. Nel menu di navigazione, fai clic su AlloyDB.

  4. Seleziona un database e un utente e inserisci la password dell'utente.

  5. Fai clic su Authenticate (Autentica). Il riquadro Explorer mostra un elenco degli oggetti nel database.

  6. Per eseguire query sul database, fai clic sulla scheda Nuovo editor SQL. Assicurati che la generazione di SQL sia abilitata.

  7. Per generare SQL, digita un commento nell'editor query iniziando con -- seguito da un commento a riga singola e premi Invio.

    Ad esempio, se inserisci il prompt -- add a row to table singers e premi Invio, Gemini genera SQL simile al seguente:

    INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
VALUES (1, Alex, 'M.', '1977-10-16');

    Per continuare l'esempio utilizzando la tabella Singers, se inserisci il prompt -- show all singers born in the 70s, Gemini genera SQL simile al seguente:

    SELECT *
FROM Singers
WHERE Singers.BirthDate
BETWEEN '1970-01-01' AND '1979-12-31'

  8. Esamina il suggerimento SQL ed esegui una delle seguenti azioni:

    • Per visualizzare le opzioni per accettare il codice SQL generato da Gemini, tienilo sopra la query. Vengono visualizzate le seguenti opzioni:
      • Accetta: per accettare la query suggerita, premi Tab, poi fai clic su Esegui.
      • Accetta parola: per accettare parzialmente la query suggerita, premi Control+Right arrow. (o Command+Right arrow su macOS), quindi fai clic su Esegui.
    • Per modificare il codice SQL originale, premi Tab, modifica il codice SQL e poi fai clic su Esegui.
    • Per ignorare il suggerimento, premi Esc o continua a digitare.

Strumento Aiutami a programmare

Per utilizzare lo strumento Aiutami a scrivere codice:

  1. Nella console Google Cloud, apri la pagina AlloyDB.

    Passa ad AlloyDB

  2. Seleziona un cluster dall'elenco.

  3. Nel menu di navigazione, fai clic su AlloyDB.

  4. Seleziona un database e un utente e inserisci la password dell'utente.

  5. Fai clic su Authenticate (Autentica). Il riquadro Explorer mostra un elenco degli oggetti nel database.

  6. Per eseguire una query sul database, fai clic su Nuova scheda.

  7. Fai clic su pen_spark Aiutami a scrivere codice accanto all'editor di query.

  8. Nella finestra Aiutami a scrivere codice, inserisci un prompt. Ad esempio, add a row to table singers e fai clic su Genera.

    Gemini genera SQL simile al seguente:

    INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
VALUES (1, Alex, 'M.', '1977-10-16');

  9. Esamina il codice SQL generato ed esegui una delle seguenti azioni:

    • Per accettare il codice SQL generato da Gemini, fai clic su Inserisci per inserire l'istruzione nell'editor di query. Quindi fai clic su Esegui per eseguire il codice SQL suggerito.
    • Per chiedere a Gemini di generare una nuova query, fai clic su Modifica. Dopo aver modificato il prompt, fai clic su Aggiorna. Puoi quindi decidere di accettare la nuova dichiarazione generata o ignorare il suggerimento.
    • Per ignorare il suggerimento, chiudi la finestra Aiutami a scrivere codice.

Spiega gli enunciati SQL nell'editor di query

Puoi inserire query in linguaggio naturale per richiedere spiegazioni delle query SQL. Queste spiegazioni possono aiutarti a comprendere la sintassi, lo schema sottostante e il contesto aziendale per query complesse o lunghe.

  1. Nella console Google Cloud, apri la pagina AlloyDB.

    Passa ad AlloyDB

  2. Seleziona un cluster dall'elenco.

  3. Nel menu di navigazione, fai clic su AlloyDB.

  4. Seleziona un database e un utente e inserisci la password dell'utente.

  5. Fai clic su Authenticate (Autentica). Il riquadro Explorer mostra un elenco degli oggetti nel database.

  6. Per eseguire una query sul database, fai clic su Nuova scheda.

  7. Nell'editor delle query, incolla la query.

  8. Evidenzia la query che vuoi che Gemini spieghi, poi fai clic su pen_spark Spiega questa query.

    La spiegazione SQL viene visualizzata nella finestra Chat di Gemini.

Passaggi successivi