Creare query con Esplora tabelle

Per richiedere assistenza o fornire un feedback su questa funzionalità, invia un'email all'indirizzo bq-studio-product-team@google.com.

Questo documento mostra come utilizzare l'esploratore di tabelle per esaminare i dati delle tabelle e creare query di esplorazione dei dati.

Informazioni su Esplora tabelle

Esplora tabelle offre un modo automatizzato per esplorare visivamente i dati delle tabelle e creare query in base alla selezione dei campi della tabella.

In Esplora tabelle, seleziona i campi della tabella da esaminare. Puoi selezionare fino a 10 campi della tabella alla volta.

L'esploratore delle tabelle mostra i campi selezionati come schede interattive con l'elenco dei 10 valori più comuni per ogni campo, ordinati in base alla colonna count. Puoi interagire con le schede selezionando i campi e i valori distinti che vuoi esaminare più da vicino. Esplora tabelle crea una query di esplorazione dei dati in base alla tua selezione.

Puoi copiare questa query in una nuova query nell'editor di query o applicarla in Esplora tabelle. Quando applichi la query, l'esploratore di tabelle la esegue e aggiorna le schede visualizzate con i risultati della query. Per continuare l'esplorazione dei dati della tabella, seleziona altri campi o valori dalle schede aggiornate.

Limitazioni

• Esplora tabelle è disponibile per tabelle BigQuery, tabelle BigLake, tabelle esterne e viste.
• L'esploratore di tabelle ti consente di esplorare una sola tabella alla volta. La funzionalità non supporta l'esplorazione simultanea di più tabelle o la generazione di operazioni tra tabelle, ad esempio le operazioni JOIN.
• Esplora tabelle crea query SQL che riflettono direttamente la tua selezione di campi della tabella e valori distinti. Puoi eseguire query create da Esplora tabelle o modificarle manualmente nell'editor di query. Esplora tabelle non fornisce assistenza basata sull'AI per generare, completare o spiegare le query SQL.
• Per esplorare i dati delle tabelle e generare query per tabelle con controllo dell'accesso (ACL) a livello di colonna o autorizzazioni utente limitate, devi disporre dell'accesso in lettura per tutti i campi selezionati. Per eseguire le query generate, devi disporre di autorizzazioni sufficienti.

Prezzi

Esplora tabelle esegue query in base alla selezione dei campi della tabella e dei valori univoci per visualizzare i risultati dell'esplorazione della tabella. Queste query comportano addebiti per i prezzi di computing. Esplora tabelle mostra la quantità di dati che verranno elaborati per ogni query prima che tu confermi la selezione dei campi della tabella, attivando l'esecuzione della query.

Puoi anche sostenere costi di calcolo se esegui una query generata da Esplora tabelle.

Per ulteriori informazioni sui prezzi di calcolo di BigQuery, consulta la sezione Prezzi.

Prima di iniziare

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the BigQuery API.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the BigQuery API.

Enable the API

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per visualizzare i dati delle tabelle e generare query con Esplora tabelle, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Utente job BigQuery (roles/bigquery.jobUser) sul progetto.
• Visualizzatore dati BigQuery (roles/bigquery.dataViewer) su tutte le tabelle e le viste che vuoi esplorare.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per visualizzare i dati delle tabelle e generare query con Esplora tabelle. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare i dati delle tabelle e generare query con Esplora tabelle sono necessarie le seguenti autorizzazioni:

• bigquery.jobs.create sul progetto da cui viene eseguita la query, indipendentemente da dove sono archiviati i dati.
• bigquery.tables.getData su tutte le tabelle e le viste che vuoi esplorare.

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per ulteriori informazioni su BigQuery Identity and Access Management (IAM), consulta la pagina Controllo dell'accesso con IAM.

Esplorare i dati in una tabella per creare una query

Per esplorare i dati della tabella e creare una query in base alla selezione di campi e valori della tabella, segui questi passaggi:

1. Nella console Google Cloud , vai a BigQuery Studio.

   Vai a BigQuery Studio

2. Nel riquadro Explorer, seleziona la tabella per cui vuoi creare una query.

3. Fai clic sulla scheda Esplora tabelle e poi su Seleziona campi.

4. Nel riquadro Seleziona campi, seleziona fino a 10 campi della tabella da esplorare.

5. Per una tabella partizionata, nella sezione Filtro di partizionamento, imposta un filtro di partizionamento personalizzato. I filtri di partizione possono ridurre il calcolo fatturabile durante l'esplorazione delle tabelle.

   1. Seleziona Applica filtro di partizionamento personalizzato.

   2. Nei campi delle impostazioni visualizzati, configura il filtro di partizionamento.

   La visualizzazione delle impostazioni del filtro dipende dal tipo di partizione della tabella: ora, giorno, mese, anno o intervallo.

6. Fai clic su Salva.

   Quando fai clic su Salva, BigQuery esegue una query per mostrare i valori comuni per i campi selezionati, il che comporta addebiti. Nella parte superiore del riquadro Seleziona campi puoi visualizzare la quantità di dati che verranno elaborati.

   Esplora tabelle mostra i campi selezionati come schede in un elenco contenente fino a i dieci valori più comuni ordinati in base alla colonna Count. Nella sezione Query generata, puoi visualizzare una query che puoi eseguire per mostrare gli stessi dati.

7. (Facoltativo) Per modificare i risultati, puoi provare quanto segue:

   1. Nelle schede dei campi selezionati visualizzate, seleziona valori distinti per filtrare ulteriormente i dati.
   2. Per ripristinare tutte le modifiche, fai clic su Reimposta.
   3. Nella sezione Query generata, fai clic su Copia nella query per copiare il codice generato in una nuova query senza titolo nell'editor di query. Nella scheda della query appena creata, puoi modificare, eseguire e gestire la query.

8. Per eseguire la query generata, fai clic su Applica.

   BigQuery esegue la query generata e aggiorna le schede visualizzate con i risultati della query.

9. Per continuare l'esplorazione della tabella, seleziona nuovi campi o valori distinti dalle schede visualizzate aggiornate.

Risoluzione dei problemi

Access Denied: Project [project_id]: User does not have bigquery.jobs.create
permission in project [project_id].

Questo errore si verifica quando un principal non dispone dell'autorizzazione per creare job di query nel progetto.

Soluzione: un amministratore deve concederti l'autorizzazione bigquery.jobs.create per il progetto su cui stai eseguendo la query. Questa autorizzazione è richiesta in aggiunta a qualsiasi autorizzazione necessaria per accedere ai dati sottoposti a query.

Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Passaggi successivi

• Scopri come esplorare i dati generando insight.
• Scopri come scrivere query con l'assistenza di Gemini in BigQuery.