Creare query con l'esploratore di tabelle

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

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

Questo documento mostra come utilizzare Esplora 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 della tabella alla volta.

L'esplorazione tabella mostra i campi selezionati sotto forma di schede interattive con l'elenco dei 10 valori più comuni per ogni campo, ordinato 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 basata sulla tua selezione.

Puoi copiare questa query in una nuova query nell'editor di query o applicarla nell'esploratore di tabelle. Quando applichi la query, l'esploratore di tabelle 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.
• Lo strumento di esplorazione delle tabelle ti consente di esplorare una singola tabella alla volta. La funzionalità non supporta l'esplorazione simultanea di più tabelle generando operazioni su più tabelle, ad esempio 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. Lo strumento Esplora tabelle non fornisce assistenza basata sull'AI per la generazione, o spiegare le query SQL.
• per esplorare i dati delle tabelle e generare query per tabelle a livello di colonna. controllo dell'accesso (ACL) 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 gli importi previsti per 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.

Potrebbero esserti addebitati costi di calcolo. se esegui una query generata da Esplora 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) del 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 nel 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 saperne di più 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 i costi fatturabili il calcolo durante l'esplorazione delle 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 visualizza 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'esplorazione tabella mostra i campi selezionati come schede in un elenco di al massimo i dieci valori più comuni ordinati in base alla colonna Count. Nella sezione Query generata, puoi visualizzare 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 selezionate, selezionare 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 il codice generato in una nuova query senza titolo nell'editor 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 aggiornate visualizzate.

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'entità non dispone dell'autorizzazione per creare job di query nel progetto.

Soluzione: un amministratore deve concederti la bigquery.jobs.create l'autorizzazione di accesso al progetto su cui stai eseguendo la 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.