esegui una query
Questo documento mostra come eseguire una query in BigQuery e comprendere quanti dati verranno elaborati dalla query prima dell'esecuzione mediante una prova.
Query interattive e batch
In BigQuery puoi eseguire due tipi di query:
- Job di query interattive, ovvero job che BigQuery esegue on demand.
- Job di query in batch, ovvero job che BigQuery attende di eseguire fino a quando le risorse di calcolo inattive non sono disponibili.
Per impostazione predefinita, BigQuery esegue le query come job di query interattive, che vengono eseguiti il prima possibile. BigQuery calcola dinamicamente il limite di query in parallelo in base alla disponibilità delle risorse e favorisce l'esecuzione di più query interattive simultanee rispetto alle query batch. Una volta raggiunto il limite di query in parallelo, altre query attendono in coda. Per ulteriori informazioni, consulta la sezione Coda di query.
BigQuery salva i risultati delle query in una tabella temporanea (predefinita) o permanente. Quando specifichi una tabella permanente come tabella di destinazione per i risultati, puoi scegliere se aggiungere o sovrascrivere una tabella esistente oppure crearne una nuova con un nome univoco.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per eseguire un job di query, 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 viste a cui fa riferimento la tua query. Per eseguire query sulle viste, devi avere questo ruolo anche per tutte le tabelle e le viste sottostanti. Se utilizzi viste autorizzate o set di dati autorizzati, non hai bisogno di accedere ai dati di origine sottostanti.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per eseguire un job di query. Per visualizzare esattamente le autorizzazioni necessarie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per eseguire un job di query sono necessarie le seguenti autorizzazioni:
-
bigquery.jobs.create
sul progetto da cui viene eseguita la query, a prescindere da dove sono archiviati i dati. -
bigquery.tables.getData
su tutte le tabelle e le viste a cui fa riferimento la query. Per eseguire query sulle viste, devi disporre di questa autorizzazione anche per tutte le tabelle e le viste sottostanti. Se utilizzi viste autorizzate o set di dati autorizzati, non hai bisogno di accedere ai dati di origine sottostanti.
Potresti anche riuscire a ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.
Risoluzione dei problemi
Il seguente errore si verifica quando un principio non dispone dell'autorizzazione per creare job di query nel progetto: Access Denied: Project [project_id]: User does not have
bigquery.jobs.create permission in project [project_id].
Soluzione: verifica di disporre dell'autorizzazione bigquery.jobs.create
per il progetto da cui esegui le query. Questa autorizzazione è richiesta in aggiunta a qualsiasi autorizzazione richiesta per i dati sottoposti a query.
Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.
Esegui una query interattiva
Per eseguire una query interattiva, seleziona una delle seguenti opzioni:
Console
Vai alla pagina BigQuery.
Fai clic su
Crea una nuova query.Nell'editor query, inserisci una query GoogleSQL valida.
Ad esempio, esegui una query sul set di dati pubblico BigQuery
usa_names
per determinare i nomi più comuni negli Stati Uniti tra il 1910 e il 2013:SELECT name, gender, SUM(number) AS total FROM `bigquery-public-data.usa_names.usa_1910_2013` GROUP BY name, gender ORDER BY total DESC LIMIT 10;
(Facoltativo) Specifica la tabella di destinazione e la località per i risultati della query:
- Nell'editor query, fai clic su Altro e poi su Impostazioni query.
- Nella sezione Destinazione, seleziona Imposta una tabella di destinazione per i risultati della query.
- In Set di dati, inserisci il nome di un set di dati esistente per la tabella di destinazione, ad esempio
myProject.myDataset
. - In ID tabella, inserisci un nome per la tabella di destinazione, ad
esempio
myTable
. Se la tabella di destinazione è una tabella esistente, in Preferenza di scrittura della tabella di destinazione, scegli se aggiungere o sovrascrivere la tabella con i risultati della query.
Se la tabella di destinazione è una nuova tabella, BigQuery la crea quando esegui la query.
Nella sezione Impostazioni aggiuntive, fai clic sul menu Località dei dati e seleziona un'opzione.
In questo esempio, il set di dati
usa_names
è archiviato nella località multiregionale degli Stati Uniti. Se specifichi una tabella di destinazione per questa query, anche il set di dati che contiene la tabella di destinazione deve trovarsi nella località multiregionale degli Stati Uniti. Non puoi eseguire query su un set di dati in una località e scrivere i risultati in una tabella in un'altra.Fai clic su Salva.
Fai clic su
Esegui.Se non specifichi una tabella di destinazione, il job di query scrive l'output in una tabella temporanea (cache).
Ora puoi esplorare i risultati della query nella scheda Risultati del riquadro Risultati delle query.
(Facoltativo) Per ordinare i risultati della query per colonna, fai clic su
Apri menu di ordinamento accanto al nome della colonna e seleziona un ordinamento. Se i byte stimati elaborati per l'ordinamento sono maggiori di zero, il numero di byte viene visualizzato nella parte superiore del menu.(Facoltativo) Per visualizzare i risultati della query, vai alla scheda Grafico. Puoi aumentare o diminuire lo zoom del grafico, scaricarlo come file PNG o attivare/disattivare la visibilità della legenda.
Nel riquadro Configurazione del grafico, puoi modificare il tipo di grafico (a linee, a barre o a dispersione) e configurare le misure e le dimensioni del grafico. I campi di questo riquadro sono precompilati con la configurazione iniziale dedotta dallo schema della tabella di destinazione della query. La configurazione viene conservata tra le seguenti esecuzioni di query nello stesso editor query. Le dimensioni supportano i tipi di dati
INTEGER
,INT64
,FLOAT
,FLOAT64
,NUMERIC
,BIGNUMERIC
,TIMESTAMP
,DATE
,DATETIME
,TIME
eSTRING
, mentre le misure supportano i tipi di datiINTEGER
,INT64
,FLOAT
,FLOAT64
,NUMERIC
eBIGNUMERIC
.(Facoltativo) Nella scheda JSON, puoi esplorare i risultati della query in formato JSON, dove la chiave è il nome della colonna e il valore è il risultato della colonna.
bq
-
Nella console Google Cloud, attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
Utilizza il comando
bq query
. Nell'esempio seguente, il flag--use_legacy_sql=false
consente di utilizzare la sintassi di GoogleSQL.bq query \ --use_legacy_sql=false \ 'QUERY'
Sostituisci QUERY con una query GoogleSQL valida. Ad esempio, esegui una query sul set di dati pubblico BigQuery
usa_names
per determinare i nomi più comuni negli Stati Uniti tra il 1910 e il 2013:bq query \ --use_legacy_sql=false \ 'SELECT name, gender, SUM(number) AS total FROM `bigquery-public-data.usa_names.usa_1910_2013` GROUP BY name, gender ORDER BY total DESC LIMIT 10;'
Il job di query scrive l'output in una tabella temporanea (cache).
Se vuoi, puoi specificare la tabella di destinazione e la località per i risultati della query. Per scrivere i risultati in una tabella esistente, includi il flag appropriato per aggiungere (
--append_table=true
) o sovrascrivere (--replace=true
) la tabella.bq query \ --location=LOCATION \ --destination_table=TABLE \ --use_legacy_sql=false \ 'QUERY'
Sostituisci quanto segue:
LOCATION: la regione o più regioni per la tabella di destinazione, ad esempio
US
In questo esempio, il set di dati
usa_names
è archiviato nella località multiregionale degli Stati Uniti. Se specifichi una tabella di destinazione per questa query, anche il set di dati che contiene la tabella di destinazione deve trovarsi nella località multiregionale degli Stati Uniti. Non puoi eseguire query su un set di dati in una posizione e scrivere i risultati in una tabella in un'altra.Puoi impostare un valore predefinito per la località utilizzando il file.bigqueryrc.
TABLE: un nome per la tabella di destinazione, ad esempio
myDataset.myTable
Se la tabella di destinazione è una nuova tabella, BigQuery crea la tabella quando esegui la query. Tuttavia, devi specificare un set di dati esistente.
Se la tabella non si trova nel progetto attuale, aggiungi l'ID progetto Google Cloud utilizzando il formato
PROJECT_ID:DATASET.TABLE
, ad esempiomyProject:myDataset.myTable
. Se--destination_table
non è specificato, viene generato un job di query che scrive l'output in una tabella temporanea.
API
Per eseguire una query utilizzando l'API, inserisci un nuovo job
e compila la proprietà di configurazione del job query
. (Facoltativo) Specifica la tua località nella proprietà location
nella sezione jobReference
della risorsa job.
Sondaggio per ottenere i risultati chiamando il numero
getQueryResults
.
Sondaggio fino a quando jobComplete
non sarà uguale a true
. Verifica la presenza di errori e avvisi nell'elenco errors
.
C#
Prima di provare questo esempio, segui le istruzioni per la configurazione di C# nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Per eseguire una query con un proxy, consulta Configurazione di un proxy.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
PHP
Prima di provare questo esempio, segui le istruzioni per la configurazione di PHP nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Ruby
Prima di provare questo esempio, segui le istruzioni per la configurazione di Ruby nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Per ulteriori informazioni, consulta Query interattive e batch.
Eseguire una query batch
Per eseguire una query batch, seleziona una delle seguenti opzioni:
Console
Vai alla pagina BigQuery.
Fai clic su
Crea una nuova query.Nell'editor query, inserisci una query GoogleSQL valida.
Ad esempio, esegui una query sul set di dati pubblico BigQuery
usa_names
per determinare i nomi più comuni negli Stati Uniti tra il 1910 e il 2013:SELECT name, gender, SUM(number) AS total FROM `bigquery-public-data.usa_names.usa_1910_2013` GROUP BY name, gender ORDER BY total DESC LIMIT 10;
Fai clic su
Altro e poi su Impostazioni query.Nella sezione Gestione delle risorse, seleziona Batch.
(Facoltativo) Specifica la tabella di destinazione e la località per i risultati della query:
- Nella sezione Destinazione, seleziona Imposta una tabella di destinazione per i risultati della query.
- In Set di dati, inserisci il nome di un set di dati esistente per la tabella di destinazione, ad esempio
myProject.myDataset
. - In ID tabella, inserisci un nome per la tabella di destinazione, ad
esempio
myTable
. Se la tabella di destinazione è una tabella esistente, in Preferenza di scrittura della tabella di destinazione, scegli se aggiungere o sovrascrivere la tabella con i risultati della query.
Se la tabella di destinazione è una nuova tabella, BigQuery la crea quando esegui la query.
Nella sezione Impostazioni aggiuntive, fai clic sul menu Località dei dati e seleziona un'opzione.
In questo esempio, il set di dati
usa_names
è archiviato nella località multiregionale degli Stati Uniti. Se specifichi una tabella di destinazione per questa query, anche il set di dati che contiene la tabella di destinazione deve trovarsi nella località multiregionale degli Stati Uniti. Non puoi eseguire query su un set di dati in una località e scrivere i risultati in una tabella in un'altra.
Fai clic su Salva.
Fai clic su
Esegui.Se non specifichi una tabella di destinazione, il job di query scrive l'output in una tabella temporanea (cache).
(Facoltativo) Per ordinare i risultati della query per colonna, fai clic su
Apri menu di ordinamento accanto al nome della colonna e seleziona un ordinamento. Se i byte stimati elaborati per l'ordinamento sono maggiori di zero, il numero di byte viene visualizzato nella parte superiore del menu.(Facoltativo) Per visualizzare i risultati della query, vai alla scheda Grafico. Puoi aumentare o diminuire lo zoom del grafico, scaricarlo come file PNG o attivare/disattivare la visibilità della legenda.
Nel riquadro Configurazione del grafico, puoi modificare il tipo di grafico (a linee, a barre o a dispersione) e configurare le misure e le dimensioni del grafico. I campi di questo riquadro sono precompilati con la configurazione iniziale dedotta dallo schema della tabella di destinazione della query. La configurazione viene conservata tra le seguenti esecuzioni di query nello stesso editor query. Le dimensioni supportano i tipi di dati
INTEGER
,INT64
,FLOAT
,FLOAT64
,NUMERIC
,BIGNUMERIC
,TIMESTAMP
,DATE
,DATETIME
,TIME
eSTRING
, mentre le misure supportano i tipi di datiINTEGER
,INT64
,FLOAT
,FLOAT64
,NUMERIC
eBIGNUMERIC
.
bq
-
Nella console Google Cloud, attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
Usa il comando
bq query
e specifica il flag--batch
. Nell'esempio seguente, il flag--use_legacy_sql=false
consente di utilizzare la sintassi GoogleSQL.bq query \ --batch \ --use_legacy_sql=false \ 'QUERY'
Sostituisci QUERY con una query GoogleSQL valida. Ad esempio, esegui una query sul set di dati pubblico BigQuery
usa_names
per determinare i nomi più comuni negli Stati Uniti tra il 1910 e il 2013:bq query \ --batch \ --use_legacy_sql=false \ 'SELECT name, gender, SUM(number) AS total FROM `bigquery-public-data.usa_names.usa_1910_2013` GROUP BY name, gender ORDER BY total DESC LIMIT 10;'
Il job di query scrive l'output in una tabella temporanea (cache).
Se vuoi, puoi specificare la tabella di destinazione e la località per i risultati della query. Per scrivere i risultati in una tabella esistente, includi il flag appropriato per aggiungere (
--append_table=true
) o sovrascrivere (--replace=true
) la tabella.bq query \ --batch \ --location=LOCATION \ --destination_table=TABLE \ --use_legacy_sql=false \ 'QUERY'
Sostituisci quanto segue:
LOCATION: la regione o più regioni per la tabella di destinazione, ad esempio
US
In questo esempio, il set di dati
usa_names
è archiviato nella località multiregionale degli Stati Uniti. Se specifichi una tabella di destinazione per questa query, anche il set di dati che contiene la tabella di destinazione deve trovarsi nella località multiregionale degli Stati Uniti. Non puoi eseguire query su un set di dati in una posizione e scrivere i risultati in una tabella in un'altra.Puoi impostare un valore predefinito per la località utilizzando il file.bigqueryrc.
TABLE: un nome per la tabella di destinazione, ad esempio
myDataset.myTable
Se la tabella di destinazione è una nuova tabella, BigQuery crea la tabella quando esegui la query. Tuttavia, devi specificare un set di dati esistente.
Se la tabella non si trova nel progetto attuale, aggiungi l'ID progetto Google Cloud utilizzando il formato
PROJECT_ID:DATASET.TABLE
, ad esempiomyProject:myDataset.myTable
. Se--destination_table
non è specificato, viene generato un job di query che scrive l'output in una tabella temporanea.
API
Per eseguire una query utilizzando l'API, inserisci un nuovo job
e compila la proprietà di configurazione del job query
. (Facoltativo) Specifica la tua località nella proprietà location
nella sezione jobReference
della risorsa job.
Quando compili le proprietà del job di query, includi la proprietà configuration.query.priority
e imposta il valore su BATCH
.
Sondaggio per ottenere i risultati chiamando il numero
getQueryResults
.
Sondaggio fino a quando jobComplete
non sarà uguale a true
. Verifica la presenza di errori e avvisi nell'elenco errors
.
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Java
Per eseguire una query batch, imposta la priorità della query su QueryJobConfiguration.Priority.BATCH quando crei una QueryJobConfiguration.
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Per ulteriori informazioni, consulta Query interattive e batch.
Quote
Per informazioni sulle quote relative alle query interattive e batch, consulta Job di query.
Visualizza il numero di query interattive e batch
Puoi visualizzare il numero di query interattive e batch utilizzando la
vista INFORMATION_SCHEMA.JOBS_BY_PROJECT
.
L'esempio seguente utilizza la vista INFORMATION_SCHEMA.JOBS_BY_PROJECT
per ottenere
il numero di query interattive e batch eseguite nelle ultime 7 ore:
SELECT
priority,
COUNT(*) active_jobs,
FROM
`region-us`.INFORMATION_SCHEMA.JOBS_BY_PROJECT
WHERE
creation_time > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 hour)
AND end_time IS NULL
AND job_type = 'QUERY'
GROUP BY priority
La vista INFORMATION_SCHEMA.JOBS_BY_PROJECT
utilizza il campo priority
per indicare se una query è INTERACTIVE
o BATCH
. Per maggiori informazioni, consulta la sezione Schema.
Prova
Una prova in BigQuery fornisce le seguenti informazioni:
- stima degli addebiti in modalità on demand
- convalida della tua query
- dimensioni approssimative e complessità della query in modalità capacità
Le prove non utilizzano slot di query e non ti viene addebitato alcun costo per l'esecuzione di una prova. Puoi utilizzare la stima restituita da una prova per calcolare i costi delle query nel Calcolatore prezzi.
Esegui una prova
Per eseguire una prova, segui questi passaggi:
Console
Vai alla pagina di BigQuery.
Inserisci la query nell'editor di query.
Se la query è valida, viene visualizzato automaticamente un segno di spunta insieme alla quantità di dati che verrà elaborata dalla query. Se la query non è valida, viene visualizzato un punto esclamativo insieme a un messaggio di errore.
bq
Inserisci una query come la seguente utilizzando il flag --dry_run
.
bq query \ --use_legacy_sql=false \ --dry_run \ 'SELECT COUNTRY, AIRPORT, IATA FROM `project_id`.dataset.airports LIMIT 1000'
Per una query valida, il comando produce la seguente risposta:
Query successfully validated. Assuming the tables are not modified, running this query will process 10918 bytes of data.
API
Per eseguire una prova utilizzando l'API, invia un job di query con dryRun
impostato su true
nel tipo JobConfiguration.
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
PHP
Prima di provare questo esempio, segui le istruzioni per la configurazione di PHP nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Imposta la proprietà
QueryJobConfig.dry_run
su True
.
Client.query()
restituisce sempre un
QueryJob
completato quando viene fornita una configurazione di query dry run.
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Passaggi successivi
- Scopri come gestire i job di query.
- Scopri come visualizzare la cronologia delle query.
- Scopri come salvare e condividere query.
- Scopri di più sulle code di query.