Esecuzione programmatica dei job
Per eseguire un job BigQuery in modo programmatico utilizzando l'API REST o le librerie client:
- Richiama il metodo
jobs.insert
. - Richiedi periodicamente la risorsa job ed esamina la proprietà status per scoprire quando il job è stato completato.
- Controlla se il job è stato completato correttamente.
Prima di iniziare
Concedi i ruoli IAM (Identity and Access Management) che concedono agli utenti le autorizzazioni necessarie per eseguire ogni attività nel documento.
Autorizzazioni obbligatorie
Per eseguire un job BigQuery, devi disporre dell'autorizzazione IAM bigquery.jobs.create
.
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per eseguire un job:
roles/bigquery.user
roles/bigquery.jobUser
roles/bigquery.admin
Inoltre, quando crei un job, ti vengono concesse automaticamente le seguenti autorizzazioni per il job:
bigquery.jobs.get
bigquery.jobs.update
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, consulta Autorizzazioni e ruoli predefiniti.
Job in esecuzione
Per eseguire un job in modo programmatico:
Avvia il job chiamando il metodo
jobs.insert
. Quando chiami il metodojobs.insert
, includi una rappresentazione di risorsa job.Nella sezione
configuration
della risorsa del job, includi una proprietà secondaria che specifichi il tipo di job:load
,query
,extract
ocopy
.Dopo aver chiamato il metodo
jobs.insert
, controlla lo stato del job chiamandojobs.get
con l'ID job e la località, e controlla il valorestatus.state
per conoscerlo. Quandostatus.state
èDONE
, l'esecuzione del job è stata interrotta. Tuttavia, lo statoDONE
non significa che il job sia stato completato correttamente, ma che non è più in esecuzione.Verifica il successo del job. Se il job ha una proprietà
errorResult
, non è riuscito. La proprietàstatus.errorResult
contiene informazioni che descrivono cosa è andato storto in un job non riuscito. Sestatus.errorResult
non è presente, il job è stato completato correttamente, anche se potrebbero essersi verificati alcuni errori non irreversibili, come problemi di importazione di alcune righe in un job di caricamento. Vengono restituiti errori non irreversibili nell'elencostatus.errors
del job.
Esecuzione di job mediante librerie client
Per creare ed eseguire un job utilizzando le librerie client di Cloud per BigQuery:
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery C#.
Per eseguire l'autenticazione in 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 di configurazione di Java disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Java.
Per eseguire l'autenticazione in 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 di configurazione di Python disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Python.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Aggiunta di etichette job
Le etichette possono essere aggiunte ai job di query tramite la riga di comando utilizzando il flag --label
dello strumento a riga di comando bq. Lo strumento bq supporta l'aggiunta
di etichette solo ai job di query.
Puoi anche aggiungere un'etichetta a un job inviato tramite l'API specificando
la proprietà labels
nella configurazione del job quando chiami il metodo
jobs.insert
. L'API
può essere utilizzata per aggiungere etichette a qualsiasi tipo di job.
Non puoi aggiungere etichette o aggiornarle su job in attesa, in esecuzione o completati.
Quando aggiungi un'etichetta a un job, questa viene inclusa nei dati di fatturazione.
Per ulteriori informazioni, consulta la sezione Aggiunta di etichette dei job.
Passaggi successivi
- Consulta Esecuzione di query per un esempio di codice che avvia e esegue il polling di un job di query.
- Per ulteriori informazioni sulla creazione di una rappresentazione delle risorse del job, consulta la pagina della panoramica dei job nel riferimento API.