Questo documento descrive come puoi utilizzare Gemini, un collaboratore basato sull'AI di Google Cloud, per:
- Genera query SQL utilizzando prompt in linguaggio naturale.
- Completa 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 Spanner, SQL e analisi dei dati. Se non hai mai utilizzato Spanner, consulta Creare ed eseguire query su un database utilizzando la console Google Cloud.
Prima di iniziare
- Assicurati di aver configurato Gemini in Databases.
- Per completare le attività in questo documento, assicurati di disporre delle autorizzazioni IAM (Identity and Access Management) necessarie.
Nella console Google Cloud, vai alla pagina Spanner.
Seleziona un'istanza dall'elenco.
Seleziona un database.
Nel menu di navigazione, fai clic su Spanner Studio.
Nella barra delle app, fai clic su pen_spark Gemini per visualizzare le funzionalità di Gemini in Spanner.
Seleziona le funzionalità di Gemini che vuoi abilitare, ad esempio, il completamento SQL e la generazione di commenti per le query. Puoi selezionare e provare le varie funzionalità senza che ciò influisca sugli altri che lavorano al tuo progetto.
(Facoltativo) Se vuoi seguire gli esempi in questo documento, crea prima la tabella
Singers
come descritto in Creare uno schema per il database.
Per disabilitare le funzionalità di Gemini in Spanner, ripeti questi passaggi e deseleziona le funzionalità di Gemini che vuoi disabilitare.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per completare le attività in questo documento, chiedi all'amministratore di concederti il ruolo IAM Spanner Database Reader (roles/spanner.databaseReader
) per il progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Genera query SQL utilizzando prompt in linguaggio naturale
Puoi fornire commenti (o prompt) in linguaggio naturale Gemini per generare query basate sul tuo schema. Ad esempio, puoi chiedere a Gemini di generare codice 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?"
Per generare codice SQL in Spanner con l'assistenza di Gemini, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Spanner.
Seleziona un'istanza dall'elenco.
Seleziona un database.
Nel riquadro di navigazione, fai clic su Spanner Studio. Il riquadro Explorer mostra un elenco degli oggetti nel database.
Per eseguire una query sul database, fai clic sulla generazione SQL sia abilitata.
scheda Nuova editor SQL. Assicurati che laPer generare SQL, digita un commento nell'editor query iniziando con
--
seguito da un commento di una sola riga, quindi premiReturn
.Ad esempio, se inserisci il prompt
-- add a row to table singers
e premiReturn
, Gemini genera un 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
, se inserisci il prompt-- show all singers born in the 70s
, Gemini genera un codice SQL simile al seguente:SELECT * FROM Singers WHERE Singers.BirthDate BETWEEN '1970-01-01' AND '1979-12-31'
Esamina l'SQL generato ed esegui una delle seguenti azioni:
- Per accettare l'SQL generato da Gemini, premi
Tab
e fai clic su Esegui per eseguire l'SQL suggerito. - Per modificare l'SQL generato da Gemini, premi
Tab
, modifica l'SQL e fai clic su Esegui. - Per ignorare il suggerimento, premi
Esc
o continua a digitare.
- Per accettare l'SQL generato da Gemini, premi
Completa le istruzioni SQL nell'editor query
Per aiutarti a scrivere codice SQL, Gemini in Spanner offre suggerimenti perAIl completamento Quando Gemini è abilitato, quando inserisci testo nell'editor query di Spanner Studio, Gemini prevede e compila automaticamente il codice SQL.
Suggerimenti di codice incorporato
Per utilizzare i suggerimenti per il codice in linea, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Spanner.
Seleziona un'istanza dall'elenco.
Seleziona un database.
Nel riquadro di navigazione, fai clic su Spanner Studio.
Per eseguire una query sul database, fai clic su completamento SQL sia abilitato.
Nuova scheda dell'editor SQL. Assicurati che ilInserisci 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 il seguente SQL: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 accettare l'SQL generato da Gemini, premi
Tab
e fai clic su Esegui per eseguire l'SQL suggerito. - Per modificare l'SQL generato da Gemini, premi
Tab
, modifica l'SQL e fai clic su Esegui. - Per ignorare il suggerimento, premi
Esc
o continua a digitare.
- Per accettare l'SQL generato da Gemini, premi
Strumento Aiutami a programmare
Per utilizzare lo strumento Aiutami a programmare:
Nella console Google Cloud, vai alla pagina Spanner.
Seleziona un'istanza dall'elenco.
Seleziona un database.
Nel riquadro di navigazione, fai clic su Spanner Studio.
Per eseguire una query sul database, fai clic su
Nuova scheda.Fai clic su pen_spark Aiutami a programmare accanto all'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 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 di accettare la nuova dichiarazione generata o ignorare il suggerimento.
- Per ignorare il suggerimento, chiudi la finestra Aiutami a programmare.
Spiegazione delle istruzioni SQL nell'editor query
Puoi usare Gemini in Spanner 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 Spanner.
Seleziona un'istanza dall'elenco.
Seleziona un database.
Nel riquadro di navigazione, fai clic su Spanner Studio.
Per eseguire una query sul database, fai clic su
Nuova scheda.Incolla la query nell'editor di query.
Evidenzia la query che vuoi che Gemini spieghi, quindi fai clic su spark. Spiega questa query.
La spiegazione SQL viene visualizzata nel riquadro Gemini.
Passaggi successivi
- Leggi la panoramica di Gemini in Google Cloud.
- Scopri in che modo Gemini utilizza i tuoi dati.
- Scopri come analizzare i tuoi dati in Google Cloud utilizzando Gemini.