Scrivi SQL con l'assistenza di Gemini

Anteprima

Questo prodotto è coperto dai Termini delle offerte pre-GA dei Google Cloud Termini di servizio. I prodotti pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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

• Genera query SQL utilizzando prompt in linguaggio naturale.
• Completa le query SQL nell'editor query.
• Spiega le query SQL nell'editor di query.

Scopri come e quando Gemini for 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.

Nota: l'assistenza alla programmazione fa parte di Gemini Code Assist ed è disponibile senza costi fino a quando non verrà inclusa nell'edizione Gemini Code Assist Standard. Questa modifica verrà comunicata in un secondo momento. A quel punto, dovrai acquistare una licenza della versione Standard di Gemini Code Assist per continuare a utilizzare l'assistenza alla programmazione in AlloyDB per PostgreSQL Studio.

Prima di iniziare

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

```sql
CREATE TABLE Singers (
  BirthDate  TIMESTAMPTZ,
  SingerId   BIGINT PRIMARY KEY,
  FirstName  VARCHAR(1024),
  LastName   VARCHAR(1024),
  SingerInfo BYTEA
);
```
After you create the `Singers` table, click
<span class="material-symbols-outlined">refresh</span>**Refresh** to
update your database schema.

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

Ruoli e autorizzazioni richiesti

Attenzione: gli utenti con accesso ampio al database potrebbero riscontrare una perdita di dati quando utilizzano Gemini. Ti consigliamo di utilizzare un account con meno privilegi di database quando utilizzi Gemini.

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.

Generare query SQL utilizzando prompt in linguaggio naturale

Poiché si tratta di una tecnologia in fase iniziale, i prodotti Gemini per Google Cloud possono generare output apparentemente plausibili, ma di fatto errati, in particolare quando vengono eseguite operazioni di scrittura in Data Manipulation Language (DML) o Data Definition Language (DDL). Ti consigliamo di verificare tutti gli output di Gemini per i Google Cloud prodotti prima di utilizzarli. Per ulteriori informazioni, consulta Gemini per Google Cloud e l'AI responsabile.

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.

Nota: quando inserisci un prompt per Gemini in AlloyDB, le informazioni sullo schema del database sono incluse con il prompt. Sono inclusi nomi delle tabelle, nomi delle colonne, tipi di dati e descrizioni delle colonne. Lo schema e i dati del database rimangono in AlloyDB e non vengono inviati a 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, quindi 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'
   

   Nota: Gemini potrebbe suggerire una sintassi diversa ogni volta che inserisci lo stesso prompt.

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');
   

   Nota: Gemini potrebbe suggerire una sintassi diversa ogni volta che inserisci lo stesso prompt.

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. Poi 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.

Completare gli enunciati SQL nell'editor di query

Per aiutarti a scrivere codice SQL, Gemini in AlloyDB fornisce suggerimenti di completamento del codice basati sull'IA. Con Gemini attivo, quando inserisci del testo nell'editor di query di AlloyDB, Gemini prevede e compila automaticamente il codice SQL.

Per utilizzare i suggerimenti di codice in linea:

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 su Nuova scheda dell'editor SQL. Assicurati che il completamento SQL sia abilitato.

7. Inserisci una query e uno spazio o un a capo alla fine della riga. Mentre inserisci il testo, Gemini mostra il codice SQL suggerito in base agli oggetti supportati nello schema del database selezionato.

   Ad esempio, per aggiungere una riga alla tabella Singers, inizia a scrivere il seguente codice SQL: INSERT INTO Singers.

   Gemini suggerisce SQL simile al seguente:

   INSERT INTO Singers
   (SingerId, FirstName, LastName, BirthDate)
   VALUES
     (1, 'Marc', 'Singer', '1970-03-24')
   

   Nota: Gemini potrebbe suggerire una sintassi SQL diversa ogni volta che inserisci la stessa istruzione SQL.

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

   • Per accettare il codice SQL generato da Gemini, premi Tab e poi fai clic su Esegui per eseguire il codice SQL suggerito.
   • Per modificare il codice SQL generato da Gemini, premi Tab, modifica il codice SQL e poi fai clic su Esegui.
   • Per ignorare il suggerimento, premi Esc o continua a digitare.

Spiega gli enunciati SQL nell'editor di query

Puoi utilizzare Gemini in AlloyDB per spiegare le query SQL in linguaggio naturale. Questa spiegazione può 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

• Leggi la panoramica di Gemini per Google Cloud .
• Scopri in che modo Gemini utilizza i tuoi dati.
• Scopri come analizzare i tuoi dati Google Cloud utilizzando Gemini.