Scrivi SQL con l'assistenza di Gemini

Anteprima - Gemini in Spanner

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questo documento descrive come utilizzare Gemini in Database per ricevere assistenza basata sull'AI per quanto segue in Spanner:

• Genera query SQL utilizzando prompt in linguaggio naturale.
• Completa gli enunciati SQL nell'editor di query.
• Spiega le query SQL nell'editor di query.

Scopri come e quando Gemini for Google Cloud utilizza i tuoi dati.

Questo documento è rivolto ad amministratori di database e 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

1. Assicurati di avere configurato Gemini in Databases.
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 Completamento SQL e Generare query da commenti. Puoi selezionare e provare le funzionalità per te stesso senza influire sul lavoro di altre persone nel progetto.

9. (Facoltativo) Se vuoi seguire gli esempi in questo documento, innanzitutto crea 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à 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 Gestire 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

Poiché si tratta di una tecnologia in fase iniziale, i prodotti Gemini for Google Cloud possono generare output apparentemente plausibili, ma di fatto errati. Ti consigliamo di verificare tutti gli output di Gemini per i prodotti Google Cloud prima di utilizzarli. Per ulteriori informazioni, consulta Gemini for Google Cloud e l'AI responsabile.

Puoi fornire a Gemini commenti (o prompt) in linguaggio naturale per generare query basate sul tuo schema. Ad esempio, puoi chiedere a Gemini di generare SQL in risposta ai seguenti prompt:

• "Crea una tabella che monitori i risultati del sondaggio sulla soddisfazione dei clienti".
• "Aggiungi una colonna di date denominata compleanno alla tabella Cantanti."
• "Quanti cantanti sono nati negli anni '90?"

Nota: quando inserisci un prompt per Gemini in Spanner, le informazioni sullo schema del database vengono incluse con il prompt. Sono inclusi nomi delle tabelle e delle colonne, tipi di dati e descrizioni delle colonne. Lo schema e i dati del database rimangono in Spanner e non vengono inviati a Gemini.

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 visualizza un elenco di oggetti nel database.

5. Per eseguire query sul database, fai clic sulla scheda Nuovo editor SQL. Assicurati che la generazione di SQL sia abilitata.

6. Per generare SQL, digita un commento nell'editor query iniziando con -- seguito da un commento a riga singola e 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'
   
   

   Nota: Gemini potrebbe suggerire una sintassi diversa ogni volta che inserisci lo stesso prompt.

7. Esamina il codice SQL generato ed esegui una delle seguenti azioni:

   • Per accettare il codice SQL generato da Gemini, premi Tab e poi fai clic su Esegui per eseguire il codice SQL suggerito.
   • Per modificare il codice SQL generato da Gemini, premi Tab, modifica il codice SQL e poi fai clic su Esegui.
   • Per ignorare il suggerimento, premi Esc o continua a digitare.

Completare gli enunciati SQL nell'editor di query

Per aiutarti a scrivere codice SQL, Gemini in Spanner fornisce suggerimenti di completamento del codice basati sull'AI. Con Gemini attivo, quando inserisci del testo nell'editor di query di Spanner Studio, Gemini prevede e completa automaticamente il codice SQL.

Suggerimenti di codice in linea

Per utilizzare i suggerimenti di codice in linea:

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 query sul database, fai clic su Nuova scheda dell'editor SQL. Assicurati che il completamento SQL sia abilitato.

6. Inserisci una query e uno spazio o un a capo alla fine della riga. Man mano che inserisci il testo, Gemini mostra il codice SQL suggerito in base agli oggetti supportati nello schema del database selezionato.

   Ad esempio, per aggiungere una riga alla tabella Singers, inizia a scrivere il seguente codice SQL: INSERT INTO Singers.

   Gemini suggerisce SQL simile al seguente:

   INSERT INTO Singers
   (SingerId, FirstName, LastName, BirthDate)
   VALUES
     (1, 'Marc', 'Singer', '1970-03-24')
   

   Nota: Gemini potrebbe suggerire una sintassi SQL diversa ogni volta che inserisci la stessa istruzione SQL.

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

   • Per accettare il codice SQL generato da Gemini, premi Tab e poi fai clic su Esegui per eseguire il codice SQL suggerito.
   • Per modificare il codice SQL generato da Gemini, premi Tab, modifica il codice 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 codice:

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. Fai clic su pen_spark Aiutami a scrivere codice accanto all'editor query.

7. Nella finestra Aiutami a scrivere codice, 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');
   

   Nota: Gemini potrebbe suggerire una sintassi diversa ogni volta che inserisci lo stesso prompt.

8. Esamina il codice SQL generato ed esegui una delle seguenti azioni:

   • Per accettare il codice SQL generato da Gemini, fai clic su Inserisci per inserire l'istruzione nell'editor di query. Quindi fai clic su Esegui per eseguire il codice 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 scrivere codice.

Spiega gli enunciati 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 delle 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

• Leggi la panoramica di Gemini per Google Cloud.
• Scopri in che modo Gemini utilizza i tuoi dati.