Scrivi codice SQL con l'assistenza di Gemini

MySQL   |  PostgreSQL   |  SQL Server

Anteprima - Gemini Code Assist

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. L'utente può trattare i dati personali relativi a questa funzionalità come descritto nell'Addendum per il trattamento dei dati Cloud, in conformità agli obblighi e alle limitazioni descritti nel contratto in base al quale accede a Google Cloud. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questo documento descrive come utilizzare Gemini, un collaboratore basato sull'AI Google Cloud, per aiutarti a svolgere le seguenti attività in Cloud SQL Studio:

• Genera query SQL utilizzando prompt in linguaggio naturale
• Completare le istruzioni SQL nell'editor query
• Spiegare le query SQL nell'editor query

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

Questo documento è rivolto agli amministratori di database e ai data engineer che hanno familiarità con SQL, l'analisi dei dati e Cloud SQL. Se non hai mai eseguito per Cloud SQL, Panoramica di Cloud SQL.

Prima di iniziare

1. Assicurati di avere configurare Gemini in Databases.
2. Per completare le attività in questo documento, assicurati di avere le autorizzazioni IAM (Identity and Access Management) necessarie.
3. Conferma l'accesso a Cloud SQL Studio. Se non hai accesso a Cloud SQL Studio, consulta Autorizzazioni e ruoli richiesti per Cloud SQL Studio

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

   CREATE TABLE
   Singers (
     SingerId   BIGINT PRIMARY KEY,
     FirstName  VARCHAR(1024),
     LastName   VARCHAR(1024),
     SingerInfo VARBINARY(MAX),
     BirthDate  DATETIMEOFFSET
   );
   

   Dopo aver creato la tabella Singers, fai clic su aggiornaAggiorna in aggiorna lo schema del database.

Ruoli e autorizzazioni richiesti

Attenzione:gli utenti con accesso ampio al database potrebbero riscontrare la perdita di dati quando utilizzi Gemini in Databases. Ti consigliamo di utilizzare un account con meno privilegi di database quando si utilizza Gemini in Databases.

Per ottenere le autorizzazioni necessarie per completare le attività in questo documento, chiedi all'amministratore di concederti Ruolo IAM Amministratore Cloud SQL (roles/cloudsql.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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

Devi avere anche l'autorizzazione cloudaicompanion.companions.generateChat per usare spiega le istruzioni SQL nell'editor query e cloudaicompanion.companions.generateCode da utilizzare Aiutami a programmare.

Genera query SQL utilizzando prompt in linguaggio naturale

Essendo una tecnologia in fase iniziale, Gemini per Google Cloud prodotti possono generare un output che sembra plausibile, ma che è di fatto errato. Ti consigliamo di convalidare tutti gli output di Gemini per i prodotti Google Cloud prima di utilizzarli. Per ulteriori informazioni, vedi Gemini per Google Cloud e IA responsabile.

Puoi dare a Gemini commenti (o messaggi) in linguaggio naturale per generare query basate sul tuo schema. Ad esempio, puoi chiedere 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 della data denominata Data di nascita alla tabella Cantanti."
• "Quanti cantanti sono nati negli anni '90?"

Se lo schema cambia, ad esempio viene aggiunta una nuova tabella o colonna: fai clic su AggiornaAggiorna per aggiornare lo schema prima di utilizzare Gemini.

Nota: quando inserisci un prompt per Gemini in Cloud SQL, sono incluse informazioni sullo schema del tuo database con il prompt. Questi metadati possono includere nomi di tabelle e colonne, tipi di dati e descrizioni delle colonne. I dati del tuo database rimangono in Cloud SQL e non viene inviato a Gemini.

Per generare query SQL in Cloud SQL con Gemini assistenza, segui questi passaggi:

1. Nella console Google Cloud, 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 degli oggetti nel tuo database.

5. Nella barra delle app, fai clic su pen_sparkGemini per visualizzare Gemini in Cloud SQL.

6. Assicurati che l'opzione Generazione di commenti per le query sia abilitata.

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

8. Per generare SQL, digita un commento nell'editor query iniziando con -- seguito da una commento di una sola riga, e premi Invio o Invio.

   Ad esempio, inserisci questo prompt:

   -- add a row to table singers
   

   Premi Invio Invio. Gemini genera codice SQL simile al seguente:

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

   Per continuare con l'esempio utilizzando la tabella Singers, inserisci quanto segue :

   -- show all singers born in the 70s
   

   Gemelli genera un codice 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:

   • Per visualizzare le opzioni per accettare il codice SQL generato da Gemini: tenere 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 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 console Google Cloud, 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 degli oggetti nel tuo database.

5. Per eseguire una query sul database, fai clic sull' Nuova scheda.

6. Fai clic su pen_spark Aiutami a programmare accanto all'Editor 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 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.

8. Esamina l'SQL generato ed esegui una delle seguenti azioni:

   • Per accettare il codice SQL generato da Gemini, fai clic su Inserisci inserisci 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. Puoi quindi decidere per accettare la nuova dichiarazione generata o ignorare il suggerimento.
   • Per ignorare il suggerimento, chiudi la finestra Aiutami a programmare.

Completa le istruzioni SQL nell'editor query

Per aiutarti a scrivere codice SQL, Gemini in Cloud SQL fornisce suggerimenti per il completamento del codice assistiti dall'AI. Con Gemini abilitata, quando inserisci testo nell'editor query di Cloud SQL Studio Gemini prevede e compila automaticamente il codice SQL.

Per utilizzare i suggerimenti per il codice in linea, segui questi passaggi:

1. Nella console Google Cloud, 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 degli oggetti nel tuo database.

5. Nella barra delle app, fai clic su pen_sparkGemini. per vedere le funzionalità di Gemini in Cloud SQL.

6. Seleziona Completamento SQL.

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

8. Inserisci una query e uno spazio o una nuova riga alla fine della riga. Man mano che inserisci il testo, Gemini mostra l'SQL suggerito basato sulle oggetti supportati nello schema del database selezionato.

   Ad esempio, per aggiungere una riga alla tabella Singers, inizia a scrivere il metodo seguente query:

   INSERT INTO Singers
   

   Gemini suggerisce un codice SQL simile al seguente:

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

   Nota: Gemini potrebbe suggerire query diverse ogni volta che inserisci la stessa affermazione.

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

   • Per visualizzare le opzioni per accettare il codice SQL generato da Gemini: tenere 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 quindi fai clic su Esegui.
   • Per ignorare il suggerimento, premi Esc o continua a digitare.

Spiegazione delle istruzioni SQL nell'editor query

Puoi usare Gemini in Cloud SQL per spiegare le query SQL in linguaggio naturale. Questa spiegazione può aiutarti a comprendere la sintassi, schema sottostante e contesto aziendale per query complesse o lunghe.

1. Nella console Google Cloud, 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 degli oggetti nel tuo database.

5. Per eseguire una query sul database, fai clic sull' Nuova scheda.

6. Nell'editor query, incolla la query che vuoi spiegare.

7. Evidenzia la query che vuoi che Gemini spieghi. poi fai clic su spark Spiega questa query.

   La spiegazione della query SQL viene visualizzata nella finestra della Chat di Gemini.

Passaggi successivi

• Letto Panoramica di Gemini per Google Cloud.
• Impara in che modo Gemini utilizza i tuoi dati.
• Scopri come analizzare i tuoi dati in Google Cloud utilizzando Gemini.