Scrivi SQL con l'assistenza di Gemini

Questo documento descrive come utilizzare Gemini Code Assist per ottenere assistenza basata sull'AI per le seguenti operazioni in Spanner:

Scopri come e quando Gemini for 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 Creare ed eseguire query su un database utilizzando la Google Cloud console.

Prima di iniziare

  1. (Facoltativo) Configura Gemini Code Assist.

  2. Per completare le attività descritte in questo documento, assicurati di disporre delle autorizzazioni Identity and Access Management (IAM) necessarie.

  3. Nella Google Cloud console, vai alla pagina Spanner.

    Vai a Spanner

  4. Seleziona un'istanza dall'elenco.

  5. Seleziona un database.

  6. Nel menu di navigazione, fai clic su Spanner Studio.

  7. In Spanner Studio, fai clic sul pulsante settings_suggestion Gemini Code Assist per visualizzare le funzionalità di Gemini in Spanner.

  8. Seleziona le funzionalità di Gemini che vuoi attivare, ad esempio ad esempio, Generazione di query da commenti. Puoi selezionare e provare le funzionalità senza influire sugli altri utenti che lavorano al tuo progetto.

  9. (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 e poi 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 della data denominata compleanno alla tabella Singers."
  • "Quanti cantanti sono nati negli anni '90?"

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

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

    Vai a Spanner

  2. Seleziona un'istanza dall'elenco.

  3. Seleziona un database.

  4. Nel riquadro di navigazione, fai clic su Spanner Studio. Nel riquadro Explorer viene visualizzato un elenco di oggetti nel database.

  5. Per eseguire query sul database, fai clic su Nuova scheda dell'editor SQL. Assicurati che la generazione di SQL sia attivata.

  6. Per generare SQL, digita un commento nell'editor di query che inizi con -- seguito da un commento su una sola riga, e poi premi Return.

    Ad esempio, se inserisci il prompt -- add a row to table singers e premi Return, 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, 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'

  7. 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.

Spiegare 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.

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

    Vai a Spanner

  2. Seleziona un'istanza dall'elenco.

  3. Seleziona un database.

  4. Nel riquadro di navigazione, fai clic su Spanner Studio.

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

  6. Nell'editor di query, incolla la query.

  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.

Passaggi successivi