Questo documento descrive come utilizzare Gemini, un collaboratore basato sull'AI di Google Cloud, per svolgere le seguenti operazioni in Cloud SQL Studio:
- Generare query SQL utilizzando prompt in linguaggio naturale
- Istruzioni SQL complete nell'Editor query
- Spiegare le query SQL nell'Editor query
Gemini non utilizza i tuoi prompt o le sue risposte come dati per addestrare i suoi modelli. Per maggiori informazioni, consulta In che modo Gemini per Google Cloud utilizza i tuoi dati.
Questo documento è destinato agli amministratori di database e ai data engineer che hanno familiarità con SQL, l'analisi dei dati e Cloud SQL. Se non hai mai utilizzato Cloud SQL, consulta la panoramica di Cloud SQL.
Prima di iniziare
- Assicurati di aver configurato Gemini nei database.
- Per completare le attività in questo documento, assicurati di disporre delle autorizzazioni IAM (Identity and Access Management) necessarie.
- Conferma l'accesso a Cloud SQL Studio. Se non hai accesso a Cloud SQL Studio, consulta Autorizzazioni e ruoli richiesti per Cloud SQL Studio
(Facoltativo) Per seguire gli esempi 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 aggiornaAggiorna per aggiornare lo schema del database.
Autorizzazioni e ruoli richiesti
Per ottenere le autorizzazioni necessarie per completare le attività indicate in questo documento,
chiedi all'amministratore di concederti il ruolo IAM
Amministratore Cloud SQL (roles/cloudsql.admin
) per il progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Devi inoltre disporre dell'autorizzazione cloudaicompanion.companions.generateChat
per utilizzare
spiegare le istruzioni SQL nell'editor query e
cloudaicompanion.companions.generateCode
per usare
Aiutami a programmare.
Generare query SQL utilizzando prompt in linguaggio naturale
Puoi fornire commenti (o richieste) in linguaggio naturale Gemini per generare query basate sul tuo schema. Ad esempio, puoi richiedere 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 la colonna Data di nascita alla tabella Cantanti."
- "Quanti cantanti sono nati negli anni '90?"
Se lo schema cambia, ad esempio se viene aggiunta una nuova tabella o colonna, fai clic su AggiornaAggiorna per aggiornare lo schema prima di utilizzare Gemini.
Per generare SQL in Cloud SQL con l'assistenza Gemini, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Cloud SQL.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Il riquadro Spazio di esplorazione mostra un elenco di oggetti nel database.
Nella barra delle app, fai clic su pen_sparkGemini per visualizzare le caratteristiche di Gemini in Cloud SQL.
Assicurati che l'opzione Generazione di commenti per le query sia abilitata.
Per eseguire una query sul database, fai clic su
Nuova scheda dell'editor SQL.Per generare SQL, digita un commento nell'editor query che inizia con
--
seguito da un commento a riga singola, quindi premi Invio o Invio.Ad esempio, inserisci il seguente prompt:
-- add a row to table singers
Premi Invio o 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
, inserisci il seguente prompt:-- show all singers born in the 70s
Gemini genera un codice SQL simile a questo:
SELECT * FROM Singers WHERE Singers.BirthDate BETWEEN '1970-01-01' AND '1979-12-31'
Esamina il suggerimento SQL ed esegui una delle seguenti azioni:
- Per visualizzare le opzioni per accettare l'SQL generato da Gemini, tieni il puntatore sulla query. Vengono visualizzate le seguenti opzioni:
- Accetta: per accettare la query suggerita, premi
Tab
, quindi fai clic su Esegui. - Accetta la parola: per accettare parzialmente la query suggerita, premi
Control
+Right arrow
(oCommand
+Right arrow
su macOS), quindi fai clic su Esegui.
- Accetta: per accettare la query suggerita, premi
- 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.
- Per visualizzare le opzioni per accettare l'SQL generato da Gemini, tieni il puntatore sulla query. Vengono visualizzate le seguenti opzioni:
Strumento Aiutami a programmare
Per usare lo strumento Aiutami a programmare:
Nella console Google Cloud, vai alla pagina Cloud SQL.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Il riquadro Spazio di esplorazione mostra un elenco di oggetti nel database.
Per eseguire una query sul database, fai clic su
Nuova scheda.Fai clic su pen_spark Aiutami a programmare accanto a Editor query.
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');
Esamina l'SQL generato ed esegui una delle seguenti azioni:
- Per accettare l'SQL generato da Gemini, fai clic su Inserisci per inserire l'istruzione nell'editor 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 la richiesta, 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 programmare.
Istruzioni SQL complete nell'Editor query
Per aiutarti a scrivere codice SQL, Gemini in Cloud SQL fornisce suggerimenti per il completamento del codice basati sull'AI. Se Gemini è abilitato, quando inserisci del testo nell'editor di query di Cloud SQL Studio, Gemini prevede e compila automaticamente il codice SQL.
Per utilizzare i suggerimenti di codice in linea, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Cloud SQL.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Il riquadro Spazio di esplorazione mostra un elenco di oggetti nel database.
Nella barra delle app, fai clic su pen_sparkGemini per visualizzare le funzionalità Gemini in Cloud SQL.
Seleziona Completamento SQL.
Per eseguire una query sul database, fai clic sulla
scheda Nuovo editor SQL.Inserisci una query e uno spazio o una nuova riga alla fine della riga. Mentre inserisci il testo, Gemini mostra il codice SQL suggerito basato sugli oggetti supportati nello schema del database selezionato.
Ad esempio, per aggiungere una riga alla tabella
Singers
, inizia a scrivere la query seguente: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')
Esamina il suggerimento SQL ed esegui una delle seguenti azioni:
- Per visualizzare le opzioni per accettare l'SQL generato da Gemini, tieni il puntatore sulla query. Vengono visualizzate le seguenti opzioni:
- Accetta: per accettare la query suggerita, premi
Tab
, quindi fai clic su Esegui. - Accetta la parola: per accettare parzialmente la query suggerita, premi
Control
+Right arrow
(oCommand
+Right arrow
su macOS), quindi fai clic su Esegui.
- Accetta: per accettare la query suggerita, premi
- 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.
- Per visualizzare le opzioni per accettare l'SQL generato da Gemini, tieni il puntatore sulla query. Vengono visualizzate le seguenti opzioni:
Spiegare le 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, lo schema sottostante e il contesto aziendale per query complesse o lunghe.
Nella console Google Cloud, vai alla pagina Cloud SQL.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Il riquadro Spazio di esplorazione mostra un elenco di oggetti nel database.
Per eseguire una query sul database, fai clic su
Nuova scheda.Nell'editor query, incolla la query che vuoi spiegare.
Evidenzia la query che vuoi far spiegare a Gemini, poi fai clic su spark Spiega questa query.
La spiegazione della query SQL viene visualizzata nella finestra Chat di Gemini.
Passaggi successivi
- Leggi la panoramica di Gemini in Google Cloud.
- Scopri in che modo Gemini utilizza i tuoi dati.
- Scopri come analizzare i dati in Google Cloud utilizzando Gemini.