Scrivi SQL con l'assistenza di Gemini

MySQL   |  PostgreSQL   |  SQL Server

Anteprima — Gemini Code Assist

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Puoi elaborare i dati personali per questa funzionalità come indicato nell' Addendum per il trattamento dei dati Cloud, fatti salvi gli obblighi e le restrizioni descritti nell' 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.

Questo documento descrive come utilizzare Gemini, un collaboratore basato sull'AI in Google Cloud, per eseguire le seguenti operazioni in Cloud SQL Studio:

• Generare query SQL utilizzando prompt in linguaggio naturale
• Spiegare le query SQL nell'editor di query

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

Questo documento è destinato agli amministratori di database e ai data engineer che hanno dimestichezza con SQL, l'analisi dei dati e Cloud SQL. Se non hai familiarità con Cloud SQL, consulta la panoramica di Cloud SQL.

Nota: l'assistenza alla programmazione fa parte di Gemini Code Assist ed è disponibile senza costi aggiuntivi finché non viene inclusa nell'edizione Gemini Code Assist Standard. Questa modifica verrà comunicata in un secondo momento. A quel punto, dovrai acquisire una licenza dell'edizione Gemini Code Assist Standard per continuare a utilizzare l'assistenza alla programmazione in Cloud SQL Studio.

Prima di iniziare

1. Per completare le attività descritte in questo documento, assicurati di disporre delle autorizzazioni Identity and Access Management (IAM) necessarie.
2. Verifica l'accesso a Cloud SQL Studio. Se non hai accesso a Cloud SQL Studio, allora consulta Ruoli e autorizzazioni richiesti per Cloud SQL Studio

3. (Facoltativo) Per seguire gli esempi riportati in questo documento, crea una tabella Singers utilizzando lo schema seguente:

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

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

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per completare le attività descritte in questo documento, chiedi all'amministratore di concederti il ruolo IAM Cloud SQL Admin (roles/cloudsql.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Sono necessarie anche le seguenti autorizzazioni:

• Autorizzazioni serviceusage.services.list o serviceusage.services.get per le funzionalità di lettura
• cloudaicompanion.companions.generateChat autorizzazione a utilizzare le istruzioni SQL di spiegazione nell'editor di query
• cloudaicompanion.companions.generateCode autorizzazione per utilizzare Aiutami a programmare

Generare query SQL utilizzando prompt in linguaggio naturale

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

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

• "Aggiungi una colonna di date denominata birthday alla tabella Singers."
• "Quanti cantanti sono nati negli anni '90?"

Se lo schema cambia, ad esempio se aggiungi una nuova tabella o colonna, allora fai clic su refreshAggiorna per aggiornare lo schema prima di utilizzare Gemini.

Nota: quando inserisci un prompt per Gemini in Cloud SQL, le informazioni sullo schema del database vengono incluse nel prompt. Questi metadati possono includere nomi di tabelle e colonne, tipi di dati e descrizioni delle colonne. I dati del database rimangono in Cloud SQL e non vengono inviati a Gemini.

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

1. Nella Google Cloud console, vai alla pagina Cloud SQL.

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

4. Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Il riquadro Explorer mostra un elenco di oggetti nel database.

5. Nella barra delle attività, fai clic su settings_suggestionGemini per visualizzare le funzionalità di Gemini in Cloud SQL.

6. Assicurati che l'opzione Generazione di query da commenti sia attivata.

7. Per eseguire query sul database, fai clic su Nuova scheda dell'editor SQL.

8. Per generare SQL, digita un commento nell'editor di query che inizi con -- seguito da un commento su una sola riga, quindi premi Return o Enter.

   Ad esempio, inserisci il seguente prompt:

   -- add a row to table singers
   

   Premi Return o Enter. 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, inserisci il seguente 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 query diverse ogni volta che inserisci lo stesso prompt.

9. Esamina il suggerimento SQL 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 convalidare le query 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, quindi 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:

1. Nella Google Cloud console, vai alla pagina Cloud SQL.

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

4. Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Il riquadro Explorer mostra un elenco di oggetti nel database.

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

6. Fai clic su settings_suggestion Aiutami a programmare accanto all'editor di query.

7. Nella finestra Aiutami a programmare, 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.

8. 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 convalidare le query generate prima di eseguirle.
   • Per accettare l'SQL generato da Gemini, fai clic su Inserisci per inserire l'istruzione nell'editor di query. Quindi 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. A questo punto, puoi decidere di accettare la nuova istruzione generata o ignorare il suggerimento.
   • Per ignorare il suggerimento, chiudi la finestra Aiutami a programmare.

Spiegare le istruzioni SQL nell'editor di query

Puoi utilizzare Gemini in Cloud SQL 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 Google Cloud console, vai alla pagina Cloud SQL.

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

4. Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Il riquadro Explorer mostra un elenco di oggetti nel database.

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

6. Nell'editor di query, incolla la query per cui vuoi ricevere una spiegazione.

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

   La spiegazione SQL viene visualizzata nel riquadro Gemini Cloud Assist.

Utilizzare Gemini per correggere gli errori nelle query

Anteprima — Gemini Code Assist

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Puoi elaborare i dati personali per questa funzionalità come indicato nell' Addendum per il trattamento dei dati Cloud, fatti salvi gli obblighi e le restrizioni descritti nell' 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 ora offre una funzionalità estesa che ti aiuta a correggere gli errori nelle query Cloud SQL senza dover uscire da Cloud SQL Studio.

Le funzionalità basate sull'AI di Gemini sono integrate in Cloud SQL Studio per fornire 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 Cloud SQL Studio.
• Evidenzia i segmenti della query originale che potrebbero causare il problema e fornisce un riepilogo in linguaggio naturale delle modifiche.
• 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 scopi generici che potrebbero fornire un aiuto meno sfumato e potrebbero anche esporre i tuoi dati a potenziali rischi per la sicurezza.
• Fornisce una risoluzione dei problemi più rapida ed efficiente per i problemi comuni come errori di sintassi, schema ed esecuzione.

Autorizzazioni obbligatorie

Prima di iniziare, verifica di disporre delle seguenti autorizzazioni:

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

Correggere la query utilizzando Gemini e Cloud SQL Studio

Per utilizzare le funzionalità di Gemini per correggere determinati errori in una query in Cloud SQL Studio:

1. Nella Google Cloud console, vai alla pagina Cloud SQL.

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

4. Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Il riquadro Explorer mostra un elenco di oggetti nel database.

5. Nella barra delle attività, fai clic su settings_suggestionGemini per visualizzare le funzionalità di Gemini in Cloud SQL.

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

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

8. Fai clic su Esegui.

   Se la query contiene un problema, viene restituito un errore.

   Ad esempio, il messaggio restituito potrebbe essere un errore di convalida nella scheda Esegui o un messaggio di errore nella scheda Risultati.

9. Fai clic su Correggi.

10. Nella finestra della query si apre un editor delle differenze ("editor diff") nella scheda, 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. Esamina le modifiche suggerite alla query e aggiornale in base alle esigenze. Quindi, accetta ed esegui la nuova query:

    Fai clic su Accetta ed esegui.

Limitazioni

• Questa funzionalità è accessibile solo in Cloud SQL Studio nella Google Cloud console.
• Si applicano i limiti della finestra contestuale 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 dati in Google Cloud utilizzando Gemini.