Scrivi SQL con l'assistenza di Gemini

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

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

  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 console Google Cloud , 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. Nella barra delle app, fai clic su pen_spark Gemini per visualizzare le funzionalità di Gemini in Spanner.

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

  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, 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:

  1. Nella console Google Cloud , 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. Il riquadro Explorer mostra 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 abilitata.

  6. Per generare SQL, digita un commento nell'editor di query a partire da -- 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 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'
    
    
  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.

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.

  1. Nella console Google Cloud , 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 una 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, poi fai clic su spark Spiega questa query.

    La spiegazione SQL viene visualizzata nel riquadro Gemini.

Passaggi successivi