Questo documento descrive come utilizzare Gemini Code Assist per ricevere assistenza basata sull'AI per le seguenti operazioni in Spanner:
- 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 è destinato agli amministratori di database e ai data engineer che hanno familiarità con Spanner, SQL e l'analisi dei dati. Se non hai mai utilizzato Spanner, consulta Crea ed esegui query su un database utilizzando la console Google Cloud .
Prima di iniziare
(Facoltativo) Configura Gemini Code Assist.
Per completare le attività descritte in questo documento, assicurati di disporre delle autorizzazioni Identity and Access Management (IAM) 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 attivare, ad esempio la generazione di query da commenti. Puoi selezionare e provare le funzionalità in autonomia senza influire sugli altri che lavorano al tuo progetto.
(Facoltativo) Se vuoi seguire gli esempi riportati in questo documento, crea prima la tabella
Singers
come descritto in Creare uno schema per il database.
Per disattivare le funzionalità di Gemini in Spanner, ripeti questi passaggi, quindi deseleziona le funzionalità di Gemini che vuoi disattivare.
Ruoli obbligatori
Per ottenere le autorizzazioni
necessarie per completare le attività descritte in questo documento,
chiedi all'amministratore di concederti il
ruolo IAM Gemini for Google Cloud User (roles/cloudaicompanion.user
) 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.
Generare query SQL utilizzando prompt in linguaggio naturale
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:
- "Crea una tabella che tenga traccia dei risultati del sondaggio sulla soddisfazione dei clienti".
- "Aggiungi una colonna di date chiamata compleanno alla tabella Cantanti".
- "Quanti cantanti sono nati negli anni '90?"
Per generare SQL in Spanner con l'assistenza di Gemini:
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 di oggetti nel database.
Per eseguire query sul database, fai clic su generazione di SQL sia abilitata.
Nuova scheda dell'editor SQL. Assicurati che laPer generare SQL, digita un commento nell'editor di query a partire da
--
seguito da un commento su una sola riga e poi 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 l'esempio utilizzando la tabella
Singers
, se inserisci il 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'
Esamina l'SQL generato ed esegui una delle seguenti azioni:
- Per accettare l'SQL generato da Gemini, premi
Tab
e poi fai clic su Esegui per eseguire l'SQL suggerito. - Per modificare l'SQL generato da Gemini, premi
Tab
, modifica l'SQL e poi fai clic su Esegui. - Per ignorare il suggerimento, premi
Esc
o continua a digitare.
- Per accettare l'SQL generato da Gemini, premi
Spiega le istruzioni SQL nell'editor di query
Puoi utilizzare 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.Nell'editor di query, incolla la query.
Evidenzia la query che vuoi che Gemini spieghi, poi fai clic su spark Spiega questa query.
La spiegazione SQL viene visualizzata nel riquadro Gemini.
Passaggi successivi
- Leggi la panoramica di Gemini per Google Cloud .
- Scopri in che modo Gemini utilizza i tuoi dati.