Assistenza per la scrittura in SQL con Gemini

Questo documento descrive come utilizzare Gemini, un collaboratore basato sull'AI di Google Cloud, per svolgere le seguenti operazioni in Spanner:

Gemini non utilizza i tuoi prompt o le sue risposte come dati per addestrare i suoi modelli. Per maggiori informazioni, consulta In che modo Gemini per Google Cloud utilizza i tuoi dati.

Questo documento è destinato agli amministratori di database e ai data engineer che conoscono Spanner, SQL e l'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 aver configurato Gemini nei database.
  2. Per completare le attività in questo documento, assicurati di disporre delle 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 caratteristiche Gemini in Spanner.

  8. Seleziona le funzionalità Gemini che vuoi abilitare, ad esempio Completamento SQL e Generazione di commenti per query. Puoi selezionare e provare le funzionalità in autonomia senza influenzare gli altri utenti nel 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 tuo database.

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

Ruoli obbligatori

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

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Generare query SQL utilizzando prompt in linguaggio naturale

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

Per generare SQL in Spanner con l'assistenza Gemini, 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. Il riquadro Explorer mostra un elenco di oggetti nel database.

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

  6. Per generare SQL, digita un commento nell'editor query che inizia con -- seguito da un commento a riga singola, quindi premi Return.

    Ad esempio, se inserisci il prompt -- add a row to table singers e premi Return, Gemini genera un 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 un 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, quindi 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.

Istruzioni SQL complete nell'Editor query

Per aiutarti a scrivere codice SQL, Gemini in Spanner fornisce suggerimenti per il completamento del codice basato sull&#39AIA. Con Gemini abilitato, quando inserisci testo nell'editor di query di Spanner Studio, Gemini prevede e compila automaticamente il codice SQL.

Suggerimenti di codici incorporati

Per utilizzare i suggerimenti di 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. Assicurati che il completamento SQL sia abilitato.

  6. Inserisci una query e uno spazio o una nuova riga alla fine della riga. Mentre inserisci il testo, Gemini mostra il codice SQL suggerito basato sugli 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 un codice SQL simile al seguente:

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

  7. Esamina il suggerimento SQL 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 e poi fai clic su Esegui.
    • Per ignorare il suggerimento, premi Esc o continua a digitare.

Strumento Aiutami a programmare

Per usare 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 su Nuova scheda.

  6. Fai clic su pen_spark Aiutami a programmare accanto a 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');

  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 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 la richiesta, 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 programmare.

Spiegare le istruzioni SQL nell'Editor query

Con Gemini in Spanner, puoi 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. Incolla la query nell'editor query.

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

    La spiegazione SQL viene visualizzata nel riquadro Gemini.

Passaggi successivi