Scrivi codice 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 Databases per sfruttare AI assistenza per quanto segue in Spanner:

• Genera query SQL utilizzando prompt in linguaggio naturale.
• Completa le istruzioni SQL nell'editor query.
• Spiegare le query SQL nell'editor query.

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

Questo documento è rivolto agli amministratori di database e ai data engineer che hanno familiarità con Spanner, SQL e analisi dei dati. Se non hai mai eseguito a Spanner, consulta Crea ed esegui query su un database utilizzando la console Google Cloud.

Prima di iniziare

1. Assicurati di avere configurare Gemini in Databases.
2. Per completare le attività in questo documento, assicurati di avere le autorizzazioni IAM (Identity and Access Management) 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 abilitare, per un esempio, Completamento SQL e Generazione di commenti dalle query. Puoi selezionare e provare le funzionalità per conto tuo senza che ciò influisca sugli altri lavorare al tuo progetto.

9. (Facoltativo) Se vuoi seguire gli esempi in questo documento, devi prima creare la tabella Singers come descritto in Crea uno schema per il database.

Per disabilitare le funzionalità di Gemini in Spanner, ripeti questi passaggi e poi deseleziona le funzionalità di Gemini che vuoi da disattivare.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare le attività in questo documento, chiedi all'amministratore di concederti Ruolo IAM Lettore database Spanner (roles/spanner.databaseReader) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Genera query SQL utilizzando prompt in linguaggio naturale

Essendo una tecnologia in fase iniziale, Gemini per Google Cloud prodotti possono generare un output che sembra plausibile, ma che è di fatto errato. Ti consigliamo di convalidare tutti gli output di Gemini per i prodotti Google Cloud prima di utilizzarli. Per ulteriori informazioni, vedi Gemini per Google Cloud e IA responsabile.

Puoi dare a Gemini commenti (o messaggi) in linguaggio naturale per generare query basate sul tuo schema. Ad esempio, puoi chiedere 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 Data di nascita alla tabella Cantanti."
• "Quanti cantanti sono nati negli anni '90?"

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

come generare codice SQL in Spanner con Gemini assistenza, segui questi passaggi:

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. L'Esploratore visualizza un elenco degli oggetti nel database.

5. Per eseguire una query sul database, fai clic sull' Nuova scheda dell'editor SQL. Accertati che La generazione SQL è abilitata.

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

   Ad esempio, se inserisci il prompt -- add a row to table singers e premi Return, Gemini genera codice SQL simile al seguente:

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

   Per continuare con l'esempio utilizzando la tabella Singers, se inserisci nel prompt -- show all singers born in the 70s, quindi Gemini genera un codice 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 l'SQL generato ed esegui una delle seguenti azioni:

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

Completa le istruzioni SQL nell'editor query

Per aiutarti a scrivere codice SQL, Gemini in Spanner fornisce suggerimenti per il completamento del codice assistiti dall'AI. Con Gemini sia abilitata, quando inserisci testo nell'editor di query di Spanner Studio Gemini prevede e compila automaticamente il codice SQL.

Suggerimenti di codice incorporato

Per utilizzare i suggerimenti per il codice in linea, segui questi passaggi:

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 dell'editor SQL. Accertati che Il completamento SQL è abilitato.

6. Inserisci una query e uno spazio o una nuova riga alla fine della riga. Man mano che inserisci il testo, Gemini mostra l'SQL suggerito basato sulle oggetti supportati nello schema del database selezionato.

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

   Gemini suggerisce un codice SQL simile al seguente:

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

   Nota: Gemini potrebbe suggerire ogni volta una sintassi SQL diversa di inserire 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, quindi fai clic su Esegui per eseguire l'SQL suggerito.
   • Per modificare l'SQL generato da Gemini, premi Tab, modifica l'SQL e fai clic su Esegui.
   • Per ignorare il suggerimento, premi Esc o continua a digitare.

Strumento Aiutami a programmare

Per utilizzare lo strumento Aiutami a programmare:

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 sull' Nuova scheda.

6. Fai clic su pen_spark Aiutami a programmare accanto all'Editor 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 un codice 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 l'SQL generato ed esegui una delle seguenti azioni:

   • Per accettare il codice SQL generato da Gemini, fai clic su Inserisci inserisci 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 per accettare la nuova dichiarazione generata o ignorare il suggerimento.
   • Per ignorare il suggerimento, chiudi la finestra Aiutami a programmare.

Spiegazione delle istruzioni SQL nell'editor query

Puoi usare Gemini in Spanner per spiegare le query SQL in linguaggio naturale. Questa spiegazione può aiutarti a comprendere la sintassi, schema sottostante e 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 sull' Nuova scheda.

6. Incolla la query nell'editor di 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

• Letto Panoramica di Gemini per Google Cloud.
• Impara in che modo Gemini utilizza i tuoi dati.
• Scopri come analizzare i tuoi dati con Gemini per Google Cloud.