Creare query con l'esploratore di tabelle

Preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Per richiedere assistenza o fornire un feedback su questa funzionalità, invia un'email all'indirizzo [e-mail].

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

Informazioni su Esplora tabelle

Table Explorer offre un modo automatico 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 di tabella alla volta.

L'esploratore di tabelle mostra i campi selezionati come schede interattive con l'elenco di massimo 10 valori più comuni per ciascun 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. Lo Spazio di esplorazione delle tabelle crea una query di esplorazione dei dati in base alla selezione.

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

Limitazioni

• L'esploratore di tabelle è disponibile per le tabelle BigQuery, le tabelle BigLake, le tabelle esterne e le viste.
• L'esploratore di tabelle ti consente di esplorare una singola 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.
• L'esploratore di tabelle crea query SQL che riflettono direttamente la selezione dei campi della tabella e dei valori distinti. Puoi eseguire le query create dall'esploratore di tabelle o modificarle manualmente nell'editor di query. L'esploratore di tabelle non fornisce assistenza basata sull'IA per generare, completare o spiegare le query SQL.
• Per esplorare i dati delle tabelle e generare query per le tabelle con controllo di 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 distinti per visualizzare i risultati dell'esplorazione della tabella. Per queste query vengono addebitati i prezzi di calcolo. L'esploratore di tabelle mostra la quantità di dati che verranno elaborati per ogni query prima di confermare la selezione dei campi della tabella, attivando l'esecuzione della query.

Inoltre, puoi incorrere in addebiti per l'utilizzo di risorse di calcolo se esegui una query generata dall'esploratore di tabelle.

Per ulteriori informazioni sui prezzi di BigQuery Compute, consulta Prezzi.

Prima di iniziare

1. 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.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

4. Enable the BigQuery API.

   Enable the API

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

7. 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 l'esploratore di tabelle, chiedi all'amministratore di concederti i seguenti ruoli IAM:

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

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

Questi ruoli predefiniti contengono le autorizzazioni necessarie per visualizzare i dati delle tabelle e generare query con l'esploratore delle tabelle. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per visualizzare i dati delle tabelle e generare query con l'esploratore di 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 visualizzazioni che vuoi esplorare.

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

Per ulteriori informazioni su Identity and Access Management (IAM) di BigQuery, consulta 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:

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

   Vai a BigQuery Studio

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

3. Fai clic sulla scheda Esplora tabella 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 quando esplori le tabelle.

   1. Seleziona Applica filtro di partizionamento personalizzato.

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

   La visualizzazione delle impostazioni di 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 visualizzare i valori comuni per i campi selezionati, con conseguente addebito. Puoi vedere la quantità di dati che verranno elaborati nella parte superiore del riquadro Seleziona campi.

   L'esploratore di tabelle mostra i campi selezionati come schede in un elenco di massimo dieci valori più comuni ordinati in base alla colonna Count. Nella sezione Query generata, puoi vedere una query che puoi eseguire per visualizzare 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 annullare 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 principale non dispone dell'autorizzazione per creare job di query nel progetto.

Risoluzione: un amministratore deve concederti l'autorizzazione bigquery.jobs.create per il progetto su cui stai eseguendo una query. Questa autorizzazione è obbligatoria oltre a qualsiasi autorizzazione richiesta 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 con gli approfondimenti dei dati.
• Scopri come scrivere query con l'assistenza di Gemini in BigQuery.