Scrivi SQL con l'assistenza di Gemini

Questo documento descrive come utilizzare Gemini, un collaboratore basato sull'AI in Trusted Cloud by S3NS, per eseguire le seguenti operazioni in Cloud SQL Studio:

Scopri come e quando Gemini per Trusted 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

  1. Per completare le attività descritte in questo documento, assicurati di disporre delle autorizzazioni Identity and Access Management (IAM) necessarie.
  2. Conferma l'accesso a Cloud SQL Studio. Se non hai accesso a Cloud SQL Studio, consulta la sezione Ruoli e autorizzazioni richiesti per Cloud SQL Studio.

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

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per completare le attività descritte in questo documento, chiedi all'amministratore di concederti il ruolo IAM Cloud SQL Admin (roles/cloudsql.admin) 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.

Per utilizzare explain SQL statements in the query editor e cloudaicompanion.companions.generateCode per utilizzare help me code, devi disporre anche dell'autorizzazione cloudaicompanion.companions.generateChat.

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?"

Se lo schema cambia, ad esempio con l'aggiunta di 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 di Gemini:

  1. Nella Trusted Cloud console, vai alla pagina Cloud SQL.

    Vai a Cloud SQL

  2. Seleziona un'istanza dall'elenco.

  3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

  4. Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Nel riquadro Explorer viene visualizzato un elenco di oggetti nel database.

  5. Nella barra delle app, fai clic su pen_sparkGemini per visualizzare le funzionalità di Gemini in Cloud SQL.

  6. Assicurati che l'opzione Generazione di commenti dalle query sia attivata.

  7. Per eseguire query sul database, fai clic su Nuova scheda dell'editor SQL.

  8. Per generare SQL, digita un commento nell'editor di query a partire da -- seguito da un commento su una sola riga e poi premi Invio o Invio.

    Ad esempio, inserisci il seguente prompt:

    -- add a row to table singers

    Premi Invio. 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, inserisci il seguente 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'

  9. Esamina il suggerimento SQL ed esegui una delle seguenti azioni:

    • Per visualizzare le opzioni per accettare l'SQL generato da Gemini, tieni il puntatore sopra la query. Vengono visualizzate le seguenti opzioni:
      • Accetta: per accettare la query suggerita, premi Tab, poi fai clic su Esegui.
      • Accetta parola: per accettare parzialmente la query suggerita, premi Control+Right arrow (o Command+Right arrow su macOS), quindi fai clic su Esegui.
    • 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.

Strumento Aiutami a programmare

Per utilizzare lo strumento Aiutami a scrivere il codice:

  1. Nella Trusted Cloud console, vai alla pagina Cloud SQL.

    Vai a Cloud SQL

  2. Seleziona un'istanza dall'elenco.

  3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

  4. Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Nel riquadro Explorer viene visualizzato un elenco di oggetti nel database.

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

  6. Fai clic su pen_spark Aiutami a scrivere codice accanto all'editor di query.

  7. Nella finestra Aiutami a programmare, inserisci un prompt. Ad esempio, add a row to table singers e fai clic su Genera.

    Gemini genera SQL simile al seguente:

    INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
VALUES (1, Alex, 'M.', '1977-10-16');

  8. 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 rifiutare il suggerimento.
    • Per ignorare il suggerimento, chiudi la finestra Aiutami a scrivere il codice.

Spiega le istruzioni SQL nell'editor di query

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

  1. Nella Trusted Cloud console, vai alla pagina Cloud SQL.

    Vai a Cloud SQL

  2. Seleziona un'istanza dall'elenco.

  3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

  4. Accedi a Cloud SQL Studio utilizzando il nome del database, il nome utente e la password. Nel riquadro Explorer viene visualizzato un elenco di oggetti nel database.

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

  6. Nell'editor di query, incolla la query per cui vuoi ricevere una spiegazione.

  7. Evidenzia la query che vuoi che Gemini spieghi, poi fai clic su spark Spiega questa query.

    La spiegazione della query SQL viene visualizzata nella finestra Chat di Gemini.

Passaggi successivi