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 ricevere assistenza basata sull'AI per generare query SQL utilizzando prompt in linguaggio naturale in Bigtable.

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

Questo documento è rivolto ad amministratori di database e data engineer che hanno familiarità con Bigtable, SQL e l'analisi dei dati. Se non hai mai utilizzato Bigtable, consulta la guida rapida: crea un'istanza Bigtable utilizzando la console Google Cloud .

Nota: l'assistenza alla programmazione fa parte di Gemini Code Assist ed è disponibile senza costi fino a quando non verrà inclusa nell'edizione Gemini Code Assist Standard. Questa modifica verrà comunicata in un secondo momento. A quel punto, dovrai acquisire una licenza Gemini Code Assist Standard per continuare a utilizzare l'assistenza alla programmazione in Bigtable Studio.

Limitazioni

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

• Gemini in Bigtable potrebbe generare query che non sono 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 le sottoquery, JOIN, UNION e CTE.

  Per ulteriori informazioni, vedi Panoramica di GoogleSQL per Bigtable.

Prima di iniziare

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

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

3. (Facoltativo) Se vuoi seguire gli esempi riportati in questo documento, crea e compila 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) sul 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 per i prodotti Google Cloud può 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 saperne di più, consulta Gemini for Google Cloud e l'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."
• "Elenca tutti gli smartphone che erano connessi al Wi-Fi il 1° maggio 2019".
• "Su quali tablet è abilitato il piano dati da 10 GB?"

Nota: quando inserisci un prompt per Gemini in Bigtable, le informazioni sullo schema del tuo database vengono incluse nel prompt. Possono essere inclusi 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 console Google Cloud , 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 , quindi scegli Editor.

5. Fai clic su Genera SQL.

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

   Ad esempio, se inserisci il prompt Count the number of devices that have a 1GB data plan., Gemini genera un codice 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 un codice SQL simile al seguente:

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

Passaggi successivi

• Leggi la panoramica di Gemini per Google Cloud .