Scrivi SQL con l'assistenza di Gemini

Anteprima — Gemini in Spanner

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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

• Generare query SQL utilizzando prompt in linguaggio naturale.
• Spiegare le query SQL nell'editor di query.

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.

Nota: l'assistenza per la codifica fa parte di Gemini Code Assist ed è disponibile senza costi aggiuntivi finché non viene inclusa nella versione Gemini Code Assist Standard. Questa modifica verrà comunicata in un secondo momento. A quel punto, dovrai acquistare una licenza per la versione Gemini Code Assist Standard per continuare a utilizzare l'assistenza per la codifica in Spanner Studio.

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

Poiché si tratta di una tecnologia in fase iniziale, Gemini for Google Cloud i prodotti può generare risultati apparentemente plausibili, ma di fatto errati. Ti consigliamo di convalidare tutti gli output di Gemini for Google Cloud i prodotti prima di utilizzarli. Per saperne di più, consulta Gemini fore l'AI responsabile. Google Cloud

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

Nota: quando inserisci un prompt per Gemini in Spanner, le informazioni sullo schema del database vengono incluse nel 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 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. 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, quindi 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 l'SQL generato ed esegui una delle seguenti azioni:

   • Per accettare l'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, quindi 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.

Utilizzare Gemini per correggere gli errori nelle query

Anteprima — Gemini Code Assist

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Puoi accedere ai dati personali per questa funzionalità come indicato nell' Addendum per il trattamento dei dati Cloud, fatti salvi gli obblighi e le restrizioni all'interno dell' accordo che regola l'accesso a Google Cloud. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Gemini offre una funzionalità estesa che ti aiuta a correggere gli errori nelle query Spanner senza dover uscire dall'editor di query.

Le funzionalità basate sull'AI di Gemini sono integrate in Spanner Studio per offrire i seguenti vantaggi:

• Fornisce un confronto riga per riga della query originale accanto a una nuova query con le modifiche consigliate utilizzando l'editor di query.
• Evidenzia i segmenti della query originale che potrebbero causare il problema e fornisce un riepilogo in linguaggio naturale delle modifiche.
• Fa riferimento al messaggio di errore esatto e alle informazioni sullo schema associate alla query per fornire correzioni accurate e pertinenti.
• Elimina la necessità di affidarsi a LLM di terze parti per scopi generici che potrebbero fornire un aiuto meno sfumato e potrebbero anche esporre i tuoi dati a potenziali rischi per la sicurezza.
• Fornisce una risoluzione dei problemi più rapida ed efficiente per i problemi comuni come errori di sintassi, schema ed esecuzione.

Autorizzazioni obbligatorie

Prima di iniziare, verifica di disporre delle seguenti autorizzazioni:

• I ruoli descritti in Ruoli obbligatori.
• L'autorizzazione API Gemini in Google Cloud, cloudaicompanion.googleapis.com/instances.generateCode.

Correggere la query utilizzando Gemini

Per utilizzare le funzionalità di Gemini per correggere determinati errori in una query:

1. Nell'editor di query, esegui la query.

   Se la query contiene un errore, viene restituito un messaggio di errore in un banner di errore nella parte inferiore dell'editor.

2. Fai clic su Correggi.

   Nella finestra della query si apre un editor delle differenze ("diff editor") nella scheda, che mostra un confronto riga per riga della query esistente con le modifiche consigliate. L'editor di query fornisce anche un riepilogo delle modifiche suggerite.

3. Esamina le modifiche suggerite alla query e aggiornale in base alle esigenze.

4. Per accettare le modifiche ed eseguire la nuova query, fai clic su Accetta ed esegui.

Limitazioni

• Questa funzionalità è accessibile solo nell'editor di query di Spanner Studio nella Google Cloud console.
• Si applicano i limiti attuali della finestra contestuale di Gemini.

Passaggi successivi

• Leggi la panoramica di Gemini per Google Cloud .
• Scopri come Gemini utilizza i tuoi dati.