Utilizzare lo Spazio di esplorazione dei job amministrativi

In qualità di amministratore di BigQuery, puoi utilizzare lo Spazio di esplorazione dei job amministrativi per monitorare l'attività dei job nella tua organizzazione. Lo Spazio di esplorazione dei job fornisce anche una serie di filtri e opzioni di ordinamento per risolvere i problemi e identificare i job problematici. Lo Spazio di esplorazione dei job elimina la necessità di avere una conoscenza approfondita di INFORMATION_SCHEMA e ti consente di visualizzare rapidamente le informazioni sui job, come proprietario, progetto, utilizzo degli slot, durata e altro ancora, senza dover scrivere query INFORMATION_SCHEMA.

Puoi anche selezionare singoli job per aprire la pagina dei dettagli del job , che fornisce dettagli sulle query come grafici di esecuzione, testo SQL e cronologia di esecuzione per aiutarti a diagnosticare e risolvere i problemi relativi alle query. Da questa pagina puoi confrontare due job per evidenziare le differenze significative tra loro e risolvere potenziali problemi di prestazioni.

BigQuery fornisce dettagli e insight sui job tramite le seguenti viste INFORMATION_SCHEMA:

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare lo Spazio di esplorazione dei job amministrativi, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore risorse BigQuery (roles/bigquery.resourceViewer) nella tua organizzazione o nel tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito include le autorizzazioni necessarie per utilizzare lo Spazio di esplorazione dei job amministrativi. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per utilizzare lo Spazio di esplorazione dei job amministrativi sono necessarie le seguenti autorizzazioni:

Per visualizzare i dati a livello di progetto: bigquery.jobs.listAll nel progetto
Per visualizzare i dati a livello di organizzazione: bigquery.jobs.listAll nell'organizzazione
Per filtrare in base alle prenotazioni nella tua organizzazione: bigquery.reservations.list nell'organizzazione

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

Filtra job

Per filtrare i job per le query contenute nelle viste INFORMATION_SCHEMA.JOBS*:

Nella Google Cloud console, vai alla pagina BigQuery.

Vai a BigQuery
Nel menu di navigazione, fai clic su Spazio di esplorazione dei job.
Nell'elenco Località, seleziona la località per cui vuoi visualizzare i job.
Applica i Filtri facoltativi in base alle esigenze:
- Ambito del job. Ad esempio il progetto corrente, l'organizzazione e i tuoi job.
- Stato. Ad esempio completato, errore, attivo e in coda.
- Priorità del job. Ad esempio job interattivi o batch.
- ID job.
- Proprietario. ID email del proprietario del job (applicabile solo quando l'ambito del job è progetto o organizzazione).
- ID progetto. (Applicabile solo quando l'ambito del job è l'organizzazione)
- ID prenotazione. (Applicabile solo quando l'ambito del job è l'organizzazione)
- Tempo slot superiore a. Job che hanno richiesto più tempo rispetto al tempo slot specificato.
- Durata superiore a. Job che hanno richiesto più tempo rispetto alla durata specificata.
- Byte elaborati più di. Job che hanno elaborato più byte rispetto ai byte elaborati specificati.
- Query Insights. Tipi di insight sulle query, come contesa degli slot, capacità di shuffle della memoria superata e modifica della scalabilità dell'input di dati.
- Hash di query. L'hash di query contiene gli hash della query. È un hash STRINGA esadecimale che ignora commenti, valori dei parametri, UDF e valori letterali. Questo campo viene visualizzato per le query GoogleSQL riuscite che non sono hit della cache.
- Etichette. key:value coppie che possono essere assegnate a un job. Puoi filtrare utilizzando una chiave, un valore o una combinazione key:value.
- Categoria di job. Il tipo di query, ad esempio Standard o Query continua.

Visualizza i dettagli dell'esecuzione della query

Per visualizzare i dettagli dell'esecuzione della query dei job:

Vai alla pagina Spazio di esplorazione dei job.

Vai allo Spazio di esplorazione dei job
Per visualizzare i job, fai clic su Spazio di esplorazione dei job.
Filtra i job per visualizzare i job limitati.
Fai clic su un job di cui vuoi visualizzare i dettagli dell'esecuzione della query.
Nel riquadro Risultati delle query, fai clic sulla scheda Grafico di esecuzione per visualizzare i dettagli dell'esecuzione del job.

Per informazioni su come interpretare gli insight, consulta Interpretare gli insight sul rendimento delle query.

Visualizza i dettagli dei job BigQuery

Per richiedere feedback o assistenza per questa funzionalità, invia un'email all'indirizzo bq-performance-troubleshooting+feedback@google.com.

Dallo Spazio di esplorazione dei job amministrativi puoi visualizzare la pagina dei dettagli di BigQuery. La pagina dei dettagli dei job BigQuery combina diversi dettagli delle query in un'unica pagina per facilitare la diagnosi e la risoluzione dei problemi relativi alle query. La scheda Rendimento raccoglie le informazioni sulle query, inclusi il grafico di esecuzione, il testo SQL e la cronologia di esecuzione.

La scheda Rendimento supporta anche il confronto delle query, consentendoti di confrontare l'utilizzo storico della query e di analizzare e risolvere eventuali cali di rendimento. Per saperne di più sul confronto dei job, consulta Confronta job.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per lavorare con i dettagli dei job BigQuery e i dettagli a livello di sistema, chiedi all'amministratore di concederti i seguenti ruoli IAM nella tua organizzazione o nel tuo progetto:

Visualizza i dettagli del job: Visualizzatore risorse BigQuery (roles/bigquery.resourceViewer) - il progetto in cui sono state eseguite le query
Visualizza i dettagli a livello di sistema: Visualizzatore risorse BigQuery (roles/bigquery.resourceViewer) - il progetto di amministrazione

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 lavorare con i dettagli dei job BigQuery e i dettagli a livello di sistema Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per lavorare con i dettagli dei job BigQuery e i dettagli a livello di sistema sono necessarie le seguenti autorizzazioni:

Per visualizzare i dati a livello di progetto: bigquery.jobs.listAll nel progetto
Per visualizzare i dati a livello di organizzazione: bigquery.jobs.listAll nell'organizzazione
Per filtrare in base alle prenotazioni nella tua organizzazione: bigquery.reservations.list nell'organizzazione

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

Visualizza i dettagli del job

Per visualizzare la pagina dei dettagli del job:

Vai alla pagina Spazio di esplorazione dei job.

Vai allo Spazio di esplorazione dei job
(Facoltativo) Filtra i job per restringere i job disponibili visualizzati.
Fai clic sull'ID del job che vuoi visualizzare. Per le query che non creano un job, viene visualizzato l'ID della query e il link è disattivato. Per tutte le altre query, se fai clic sull'ID del job viene visualizzata la pagina Dettagli job.

Per impostazione predefinita viene visualizzata la scheda Rendimento. Puoi passare alle altre schede per visualizzare ulteriori informazioni sul job.

Informazioni sulle query disponibili

L'elenco seguente descrive le informazioni e le metriche disponibili nella scheda Rendimento.

Query SQL: il testo della query SQL che ha creato il job.
Dettagli job: le informazioni sul job, inclusi l'ID del job, l'ora di creazione , i byte elaborati e altro ancora. Per saperne di più, consulta Visualizza i dettagli del job.
Varianza del rendimento: informazioni sul rendimento del job rispetto a un'esecuzione precedente della stessa query. BigQuery confronta il job corrente con un'esecuzione precedente con byte elaborati simili (+/- 5%) e la durata del job più breve, se esiste. Se non esiste un'esecuzione precedente di questo tipo, BigQuery confronta il job corrente con la media delle esecuzioni precedenti negli ultimi 30 giorni. Se non sono presenti esecuzioni precedenti, questa sezione indica che non è stato trovato alcun job simile per il confronto.
Cronologia di esecuzione: un elenco di altre esecuzioni di questa query per hash di query. Da questo riquadro puoi selezionare un job da confrontare con quello che stai visualizzando. Per saperne di più sul confronto dei job, consulta Confronta job.
Carico di sistema durante l'esecuzione: una descrizione delle risorse utilizzate da BigQuery per eseguire il job. Sono incluse informazioni sulle impostazioni di prenotazione utilizzate da questo job, se applicabili.
Grafico di esecuzione: il grafico di esecuzione di questo job. Per saperne di più, consulta Ottieni informazioni sul rendimento delle query.

Confronta job

Per richiedere feedback o assistenza per questa funzionalità, invia un'email all'indirizzo bq-performance-troubleshooting+feedback@google.com.

Il confronto del rendimento dei job ti consente di confrontare il job di base con i job di destinazione e l'analisi delle query evidenzia i dettagli dei job che differiscono in modo significativo tra i due job. In questo modo puoi risolvere potenziali problemi di rendimento tra due job di query.

I dettagli importanti da considerare per l'ottimizzazione delle query quando si confrontano due query includono la durata del job, il tempo slot e i byte elaborati.

Prima di iniziare

Visualizza i dettagli del job: Visualizzatore risorse BigQuery (roles/bigquery.resourceViewer) - il progetto in cui sono state eseguite le query
Visualizza i dettagli a livello di sistema: Visualizzatore risorse BigQuery (roles/bigquery.resourceViewer) - il progetto di amministrazione

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

Autorizzazioni obbligatorie

Per lavorare con i dettagli dei job BigQuery e i dettagli a livello di sistema sono necessarie le seguenti autorizzazioni:

Per visualizzare i dati a livello di progetto: bigquery.jobs.listAll nel progetto
Per visualizzare i dati a livello di organizzazione: bigquery.jobs.listAll nell'organizzazione
Per filtrare in base alle prenotazioni nella tua organizzazione: bigquery.reservations.list nell'organizzazione

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

Informazioni sul confronto del rendimento dei job

Le sezioni seguenti descrivono la pagina Confronto del rendimento dei job e le informazioni per la risoluzione dei problemi che fornisce.

Puoi attivare/disattivare l'opzione Mostra solo le differenze significative per visualizzare solo le differenze significative tra i due job per tutte le metriche incluse in questa pagina.

Le differenze significative sono evidenziate in verde, giallo e rosso:

Verde: la modifica va in una direzione positiva. Ad esempio, poiché una durata della query più breve è migliore, se il job di destinazione viene eseguito più velocemente del job di base, viene contrassegnato in verde.
Giallo: la modifica va in una direzione negativa, ma la differenza è inferiore al 20%.
Rosso: la modifica va in una direzione negativa e la differenza è superiore al 20%.

Analisi a livello di query

Il riquadro Analisi a livello di query descrive le differenze tra i due job a livello di query. Contiene tre schede: Metriche, Testo SQL e Grafico di esecuzione.

La scheda Metriche descrive le metriche delle query per i due job. Utilizza questa scheda per determinare se esistono discrepanze tra la durata del job, gli acceleratori inutilizzati e altre metriche.
La scheda Testo SQL mostra le due istruzioni SQL che hanno creato i job ed evidenzia le differenze tra loro. Utilizza questa scheda per determinare se le modifiche alle istruzioni SQL hanno influito sul rendimento del job.
La scheda Grafico di esecuzione confronta i grafici di esecuzione dei due job. Utilizza questa scheda per determinare se si sono verificate discrepanze in qualsiasi fase durante l'esecuzione dei job.

Analisi a livello di sistema

Il riquadro Analisi a livello di sistema descrive i fattori che potrebbero influire sui due job a livello di sistema. È composto da tre sezioni: la tabella Progetto , la tabella Prenotazione e la tabella Impostazioni.

Il riquadro Analisi a livello di sistema può suggerire aree di miglioramento in base alle differenze tra le due query.

Ad esempio, se un job ha ricevuto meno slot rispetto alle esecuzioni precedenti, potrebbe essere influenzato da vincoli di risorse nel sistema. Se viene indicato, controlla le metriche a livello di progetto per verificare se il progetto nel suo complesso ha ricevuto meno slot. Se il progetto non ha ricevuto meno slot, è probabile che si sia verificata una contesa a livello di progetto, ad esempio un aumento della concorrenza dei job. Se il progetto ha ricevuto meno slot, controlla il livello di prenotazione per identificare eventuali vincoli.

La tabella Progetto confronta i due job a livello di progetto. Utilizza questa tabella per determinare se è possibile eseguire un'ottimizzazione a livello di progetto.
La tabella Prenotazione confronta i due job a livello di prenotazione. Utilizza questa tabella per identificare le differenze nell'utilizzo delle prenotazioni tra le due query che potrebbero influire sul rendimento del job.
La tabella Impostazioni confronta le impostazioni di prenotazione tra i due job. Utilizza questa tabella per rilevare eventuali modifiche alle impostazioni di prenotazione che potrebbero aver causato un impatto sul rendimento.

Confronta due job

Per confrontare due job:

Vai alla pagina Spazio di esplorazione dei job.

Vai allo Spazio di esplorazione dei job
(Facoltativo) Filtra i job per restringere i job disponibili visualizzati.
Fai clic sull'ID del job iniziale che vuoi visualizzare e confrontare. Viene visualizzata la pagina Dettagli job.
Fai clic sulla scheda Rendimento.
Fai clic su Confronta job.
Nel campo Job uno (job di base), fai clic su Sfoglia. Viene visualizzato il riquadro Job simili paragonabili.
Identifica il job con cui vuoi confrontare il job di base e fai clic su Confronta. Viene visualizzato il confronto del rendimento dei job.
Per visualizzare solo le differenze significative tra i due job, attiva/disattiva l'opzione Mostra solo le differenze significative.

Modifica i job a confronto

Per modificare i job a confronto:

Vai alla pagina Confronto del rendimento dei job.
Nel campo Job uno (job di base), fai clic su Sfoglia.
Nel riquadro Job simili paragonabili, identifica il job che vuoi confrontare e fai clic su Confronta.

Prezzi

Lo Spazio di esplorazione dei job è disponibile senza costi aggiuntivi. Le query utilizzate per popolare questi grafici non vengono fatturate e non utilizzano gli slot nelle prenotazioni di proprietà dell'utente. Le query che elaborano troppi dati vanno in timeout.

Passaggi successivi

Scopri di più sulle prenotazioni.
Scopri di più sull'acquisto di slot.
Scopri come stimare i requisiti di capacità degli slot.
Scopri come visualizzare gli insight e i suggerimenti sugli slot.