Eseguire query sui dati

L'editor SQL unificato dell'estensione IDE di Google Cloud Data Agent Kit ti consente di eseguire query SQL sui tuoi dati Google Cloud direttamente dal tuo IDE.

Se utilizzi il plug-in Data Agent Kit con un agente di codifica supportato, puoi eseguire query SQL nell'agente o utilizzare prompt in linguaggio naturale per generare query SQL.

Origini dati supportate

Data Agent Kit ti consente di eseguire query su tabelle e viste nei seguenti servizi di datiGoogle Cloud :

  • BigQuery
  • Bigtable
  • Spanner
  • AlloyDB per PostgreSQL
  • Cloud SQL per MySQL
  • Cloud SQL per PostgreSQL

Per Cloud SQL, sono supportate le query che utilizzano l'autenticazione del database Identity and Access Management (IAM) e l'autenticazione integrata del database (con password archiviate come secret regionali in Secret Manager). Per saperne di più su come Cloud SQL autentica gli utenti integrati con Secret Manager, consulta Eseguire istruzioni SQL utilizzando l'API Data per Cloud SQL per MySQL e Cloud SQL per PostgreSQL. Per AlloyDB, sono supportate solo le query che utilizzano l'autenticazione database IAM.

Prima di iniziare

Prima di eseguire query sui dati:

  1. Installa l'estensione.
  2. Configura le impostazioni dell'estensione.
  3. Consulta le indicazioni riportate in Trovare ed esplorare i dati.

Crea un nuovo file SQL

Puoi aprire l'editor SQL in diversi modi.

Crea un nuovo file SQL dal menu File

  1. Nella barra dei menu di VS Code, fai clic su File e poi su Nuovo file di testo. Nell'editor viene visualizzato un file senza titolo.
  2. Salva il nuovo file con l'estensione .sql.
  3. Fai clic su Seleziona connessione nella scheda dell'editor.
  4. Completa i passaggi descritti in Configurare le impostazioni delle query.

Crea una nuova query dal catalogo

  1. Nella scheda Google Cloud Data Agent Kit della barra delle attività, espandi Catalog (Catalogo) per trovare il set di dati che vuoi interrogare.
  2. Fai clic con il tasto destro del mouse o ctrl+clic sul nome del set di dati, poi seleziona Query per aprire un nuovo file SQL preconfigurato per quel set di dati.

Crea una nuova query dalla sezione BigQuery

  1. Nella scheda Google Cloud Data Agent Kit della barra delle attività, espandi BigQuery.
  2. Fai clic su + Nuova query. Nell'editor viene visualizzato un file SQL senza titolo configurato con BigQuery come origine dati.

Configura le impostazioni delle query

Le impostazioni richieste per la query SQL variano in base al Google Cloud servizio.

AlloyDB

  1. Nell'Editor SQL, fai clic su Apri impostazioni query.
  2. Seleziona Database.
  3. Seleziona AlloyDB.
  4. Seleziona un cluster.
  5. Seleziona un'istanza. La query viene indirizzata a questa istanza.
  6. Seleziona un database.
  7. Fai clic su Salva.

BigQuery

  1. Nell'Editor SQL, fai clic su Apri impostazioni query.
  2. Seleziona BigQuery.
  3. Fai clic su Salva.

Bigtable

  1. Nell'Editor SQL, fai clic su Apri impostazioni query.
  2. Seleziona Database.
  3. Seleziona Bigtable.
  4. Seleziona un'istanza.
  5. (Facoltativo) Per utilizzare un profilo app diverso da quello predefinito, selezionalo.
  6. Componi la query.
  7. Fai clic su Salva.

Cloud SQL

  1. Nell'Editor SQL, fai clic su Apri impostazioni query.
  2. Seleziona Database.
  3. Seleziona Cloud SQL.
  4. Seleziona un'istanza. La query viene indirizzata a questa istanza.
  5. Seleziona un database da interrogare.

  6. Nella sezione Metodo di autenticazione, seleziona la modalità di autenticazione:

    • Autenticazione IAM dei database: esegui l'autenticazione utilizzando il tuo account Google Cloud .

    • Autenticazione del database integrata: esegui l'autenticazione come utente del database integrato la cui password è archiviata come secret regionale in Secret Manager.

      1. Nell'elenco Utente, seleziona un utente del database. Se l'elenco non può essere caricato, inserisci il nome utente nel campo Utente. Per Cloud SQL per MySQL, l'utente root predefinito non è supportato.
      2. Nell'elenco Password (memorizzata in Secret Manager), seleziona il secret regionale che memorizza la password dell'utente. Se non hai ancora un secret, seleziona Crea nuovo secret nella regione REGION, inserisci un Nome e la Password, quindi fai clic su Crea secret. Il secret viene creato nella stessa regione dell'istanza.
      3. (Facoltativo) Nell'elenco Versione secret, seleziona una versione specifica. Per impostazione predefinita, è selezionata l'opzione latest, che utilizza sempre la versione più recente del secret.

      Per saperne di più sui requisiti integrati per gli utenti e i secret regionali, consulta Eseguire istruzioni SQL utilizzando l'API Data per Cloud SQL per MySQL e Cloud SQL per PostgreSQL.

  7. Fai clic su Salva.

Spanner

  1. Nell'Editor SQL, fai clic su Apri impostazioni query.
  2. Seleziona Database.
  3. Seleziona Chiave.
  4. Seleziona un'istanza. La query viene indirizzata a questa istanza.
  5. Seleziona un database da interrogare.
  6. Fai clic su Salva.

Modificare le impostazioni delle query

Le impostazioni delle query sono specifiche per ogni file SQL. Dopo aver aperto un file SQL, puoi modificare le impostazioni.

  1. Nell'editor, fai clic sull'origine dati visualizzata. Viene visualizzato l'editor Impostazioni query.
  2. Completa i passaggi descritti in Configurare le impostazioni delle query.

Esegui una query

Dopo aver creato un file di query e composto la query, fai clic su ▷ Esegui query.

La scheda Risultati del riquadro Risultati query mostra i risultati della query.

Per eseguire un sottoinsieme delle istruzioni SQL nell'editor di query, evidenzia il sottoinsieme prima di fare clic su ▷ Esegui query.

Funzionalità dell'editor SQL

Non tutte le funzionalità dell'editor SQL sono supportate per ogni tipo di origine dati. La tabella seguente elenca le funzionalità dell'editor SQL supportate per tipo di origine dati durante l'anteprima.

Funzionalità

BigQuery

Bigtable

Spanner

Cloud SQL

AlloyDB per PostgreSQL

Risultati delle query

✅

✅

✅

✅

✅

Informazioni sul job

Non applicabile

Non applicabile

Non applicabile

Non applicabile

Non applicabile

Dettagli esecuzione

✅

✅

Tempo trascorso

❌

Non supportata

❌

Non supportata

❌

Non supportata

Visualizzazione

✅

✅

✅

✅

✅

Impostazioni query

✅

✅

✅

✅

✅

Supporto delle query multi-istruzione

✅

✅

✅

✅

✅

Catalogo: inserisci il nome della risorsa nell'editor

✅

✅

✅

✅

✅

Passaggi successivi