Scrivi SQL con l'assistenza di Gemini

Anteprima — Gemini in Bigtable

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 ottenere assistenza basata sull'AI con la generazione di query SQL utilizzando prompt in linguaggio naturale in Bigtable.

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 Bigtable, SQL e l'analisi dei dati. Se non hai familiarità con Bigtable, consulta la guida rapida: crea un'istanza Bigtable 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 acquisire una licenza della versione Gemini Code Assist Standard per continuare a utilizzare l'assistenza per la codifica in Bigtable Studio.

Limitazioni

• Non puoi utilizzare Gemini in Bigtable per spiegare le query SQL in linguaggio naturale.

• Gemini in Bigtable potrebbe generare query non valide in GoogleSQL per Bigtable o query che utilizzano le seguenti istruzioni o sintassi non supportate:

  • Istruzioni DML (Data Manipulation Language) diverse da SELECT, ad esempio INSERT, UPDATE o DELETE.
  • Istruzioni DDL (Data Definition Language), ad esempio CREATE, ALTER o DROP.
  • Istruzioni di controllo dell'accesso ai dati.
  • Sintassi delle query per sottoquery, JOIN, UNION e CTE.

  Per ulteriori informazioni, consulta la panoramica di GoogleSQL per Bigtable.

Prima di iniziare

1. Abilita l'API Gemini for Google Cloud in un Google Cloud progetto.

2. Per completare le attività descritte in questo documento, assicurati di disporre delle autorizzazioni IAM (Identity and Access Management) necessarie.

3. (Facoltativo) Se vuoi seguire gli esempi riportati in questo documento, crea e popola test-table come descritto in Creare una tabella di test.

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.

Genera query SQL utilizzando prompt in linguaggio naturale

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

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

• Conta il numero di dispositivi che hanno un piano dati da 1 GB.
• "List all phones that were connected to Wifi on May 1st, 2019."
• Quali tablet hanno il piano dati da 10 GB abilitato?

Nota: quando inserisci un prompt per Gemini in Bigtable, le informazioni sullo schema del database vengono incluse nel prompt. Queste informazioni possono includere nomi di tabelle e colonne, tipi di dati e descrizioni delle colonne. Lo schema e i dati del database rimangono in Bigtable e non vengono inviati a Gemini.

Per generare SQL in Bigtable con Gemini:

1. Nella Google Cloud console, vai alla pagina Bigtable.

   Vai a Bigtable

2. Seleziona un'istanza dall'elenco.

3. Nel riquadro di navigazione, fai clic su Bigtable Studio.

4. Apri una nuova scheda facendo clic su e poi scegli Editor.

5. Fai clic su Genera SQL.

6. Nella finestra di dialogo Aiutami a programmare , inserisci il prompt e poi fai clic su Genera.

   Ad esempio, se inserisci il prompt Count the number of devices that have a 1GB data plan., Gemini genera SQL simile al seguente:

   SELECT
       count(*)
   FROM
       `test_table`
   WHERE
       cell_plan['data_plan_01gb'] = 'true'
   

   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 eseguire l'SQL suggerito, fai clic su Inserisci e poi su Esegui.
   • Per modificare il prompt, fai clic su Modifica e poi su Aggiorna.
   • Per modificare l'SQL suggerito, fai clic su Inserisci. Nel generatore di query, modifica manualmente la query e poi fai clic su Esegui.

8. (Facoltativo) Per continuare l'esempio di test_table, se inserisci il prompt Show all data for phones from May 2019., Gemini genera SQL simile al seguente:

   SELECT
       *
   FROM
       `test_table`
   WHERE
       _key LIKE 'phone#%#201905%'
   

Passaggi successivi

• Leggi la panoramica di Gemini per Google Cloud .