Scrivi SQL con l'assistenza di Gemini

Anteprima

Questo prodotto è coperto dai Termini delle offerte pre-GA dei Termini di servizio Google Cloud . 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.

Per scrivere, perfezionare e comprendere più rapidamente le query SQL in AlloyDB per PostgreSQL, puoi utilizzare Gemini, un collaboratore basato sull'AI inGoogle Cloud, per svolgere le seguenti attività in AlloyDB Studio:

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

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

Questo documento è rivolto ad amministratori di database e data engineer che hanno dimestichezza con AlloyDB e una certa familiarità con SQL e l'analisi dei dati. Se non conosci 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 di 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 disabilitare le funzionalità di Gemini in AlloyDB, ripeti questo passaggio, quindi deseleziona le funzionalità di Gemini che vuoi disabilitare.

Ruoli e autorizzazioni richiesti

Attenzione: gli utenti con un accesso ampio al database potrebbero subire 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
• cloudaicompanion.companions.generateCode
• cloudaicompanion.instances.generateCode
• serviceusage.services.get o serviceusage.services.list

Puoi ottenere questa autorizzazione tramite il ruolo roles/alloydb.admin. Se non hai questo ruolo, contatta l'Amministratore organizzazione per richiedere l'accesso. Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i 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

Poiché si tratta di una tecnologia in fase iniziale, Gemini per i prodotti Google Cloud può generare output apparentemente plausibili, ma di fatto errati. Ti consigliamo di verificare tutti gli output di Gemini per i prodotti Google Cloud prima di utilizzarli. Per saperne di più, consulta Gemini in Google Cloud e l'AI responsabile.

Puoi fornire a Gemini commenti in linguaggio naturale (o prompt) 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 tenga traccia dei risultati del sondaggio sulla soddisfazione dei clienti."
• "Aggiungi una colonna di date denominata birthday alla tabella Singers."
• "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 aggiornare lo schema prima di utilizzare Gemini.

Nota: quando inserisci un prompt, le informazioni sullo schema del database vengono incluse nel prompt. Sono inclusi nomi delle tabelle e 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, segui questi passaggi:

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

   Vai ad AlloyDB

2. Seleziona un cluster dall'elenco.

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

4. Seleziona un database e un utente, quindi 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 nuova scheda dell'editor SQL. Assicurati che la generazione SQL sia abilitata.

7. Per generare SQL, digita un commento nell'editor di query che inizia con -- seguito da un commento su una singola riga, quindi premi Invio.

   Ad esempio, se inserisci il prompt -- add a row to table singers e premi Invio, Gemini genera un codice 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 un 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:

   Attenzione: poiché le query Data Manipulation Language (DML) e Data Definition Language (DDL) generate da Gemini possono sovrascrivere i dati, ti consigliamo di convalidare le query SQL generate prima di eseguirle.
   • Per visualizzare le opzioni per accettare l'SQL generato da Gemini, tieni il puntatore sopra la query. Vengono visualizzate le seguenti opzioni:
     • Accetta: per accettare la query suggerita, premi Tab, quindi 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 l'SQL originale, premi Tab, modifica l'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 programmare, segui questi passaggi:

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

   Vai ad AlloyDB

2. Seleziona un cluster dall'elenco.

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

4. Seleziona un database e un utente, quindi 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 sulla nuova scheda .

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

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

   Gemini genera un codice 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 l'SQL generato ed esegui una delle seguenti azioni:

   Attenzione: poiché le query DML (Data Manipulation Language) e DDL (Data Definition Language) generate da Gemini possono sovrascrivere i dati, ti consigliamo di convalidarle prima di eseguirle.
   • Per accettare l'SQL generato da Gemini, fai clic su Inserisci per inserire l'istruzione nell'editor di query. Poi fai clic su Esegui per eseguire l'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 di ignorare il suggerimento.
   • Per ignorare il suggerimento, chiudi la finestra Aiutami a programmare.

Spiega le istruzioni 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.

   Vai ad AlloyDB

2. Seleziona un cluster dall'elenco.

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

4. Seleziona un database e un utente, quindi 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 sulla nuova scheda .

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

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

   La spiegazione SQL viene visualizzata nel riquadro Gemini Cloud Assist.

Utilizza Gemini per correggere gli errori nelle query

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Puoi trattare i dati personali per questa funzionalità, come indicato nell'Addendum per il trattamento dei dati Cloud, fatti salvi gli obblighi e le restrizioni all'interno dell'accordo che regola l'accesso a Google Cloud. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Gemini offre una funzionalità estesa che ti aiuta a correggere gli errori nelle query AlloyDB senza dover uscire dall'editor di query.

Le funzionalità basate sull'AI di Gemini sono integrate nell'editor di query per offrire i seguenti vantaggi:

• Fornisce un confronto riga per riga della query originale accanto a una nuova query con le modifiche consigliate utilizzando l'editor di query.
• Evidenzia i segmenti della query originale che potrebbero causare il problema e fornisce un riepilogo delle modifiche in linguaggio naturale.
• Fa riferimento al messaggio di errore esatto e alle informazioni sullo schema associate alla query per fornire correzioni accurate e pertinenti.
• Elimina la necessità di affidarsi a LLM di terze parti per uso generico che potrebbero fornire un aiuto meno dettagliato e potrebbero anche esporre i tuoi dati a potenziali rischi per la sicurezza.
• Fornisce una risoluzione dei problemi più rapida ed efficiente per problemi comuni come errori di sintassi, schema e runtime.

Autorizzazioni obbligatorie

Prima di iniziare, verifica di disporre delle seguenti autorizzazioni:

• Le autorizzazioni descritte in Autorizzazioni richieste.
• L'autorizzazione API Gemini for Google Cloud, cloudaicompanion.googleapis.com/instances.generateCode.

Correggi la query utilizzando Gemini

Per utilizzare le funzionalità di Gemini per correggere determinati errori in una query, segui questi passaggi:

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

   Vai ad AlloyDB

2. Seleziona un cluster dall'elenco.

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

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

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

6. Nella barra delle applicazioni, fai clic su settings_suggestionGemini per visualizzare le funzionalità di Gemini in AlloyDB.

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

8. Nell'editor di query, inserisci una query che potrebbe essere errata o incompleta.

9. Fai clic su Esegui.

   Se la query contiene un problema, viene restituito un errore nella scheda Risultati.

10. Fai clic su Correggi.

    Nella finestra della query, nella scheda si apre un editor delle differenze ("editor diff"), che mostra un confronto riga per riga della query esistente con le modifiche consigliate. L'editor di query fornisce anche un riepilogo delle modifiche suggerite.

11. Rivedi le modifiche suggerite alla query e aggiornale in base alle esigenze.

12. Per accettare le modifiche ed eseguire la nuova query, fai clic su Accetta ed esegui.

Limitazioni

• Questa funzionalità è accessibile solo nell'editor di query di AlloyDB Studio nella consoleGoogle Cloud .
• Si applicano i limiti della finestra contestuale di Gemini attuali.

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 in Google Cloud utilizzando Gemini.