Utilizzare lo strumento di esplorazione dei job amministrativi
In qualità di amministratore BigQuery, puoi utilizzare l'explorer dei job amministrativi per monitorare l'attività dei job nella tua organizzazione. L'esploratore dei job fornisce anche una serie di filtri e opzioni di ordinamento per risolvere i problemi e identificare i job problematici.
Esplora 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 la necessità di scrivere query INFORMATION_SCHEMA.
BigQuery fornisce dettagli e approfondimenti sui job tramite le seguenti viste INFORMATION_SCHEMA:
Per ottenere le autorizzazioni necessarie per utilizzare lo strumento 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 contiene
le autorizzazioni necessarie per utilizzare lo strumento di esplorazione dei job amministrativi. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per utilizzare Esplora job amministrativi sono necessarie le seguenti autorizzazioni:
Per visualizzare i dati a livello di progetto:
bigquery.jobs.listAll
sul progetto
Per visualizzare i dati a livello di organizzazione:
bigquery.jobs.listAll
sull'organizzazione
Per filtrare in base alle prenotazioni nella tua organizzazione:
bigquery.reservations.list
sull'organizzazione
Nell'elenco Sede, seleziona la sede per cui vuoi visualizzare i
lavori.
Applica i filtri facoltativi in base alle necessità:
Ambito del lavoro. come il progetto corrente, l'organizzazione e i tuoi job.
Stato. Ad esempio, completato, errore, attivo e in coda.
Priorità del lavoro. 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. Lavori che hanno richiesto più tempo di quello previsto.
Durata superiore a. Job che hanno richiesto più tempo della durata specificata.
Byte elaborati più di. Job che hanno elaborato più byte di quelli specificati.
Statistiche sulle query. Tipi di approfondimenti sulle query, ad esempio contesa degli slot,
capacità di shuffle della memoria superata e modifica della scala di input dei 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. coppie key:value che possono essere assegnate a un lavoro. Puoi filtrare utilizzando una combinazione di chiave, valore o key:value.
Categoria di lavoro. Il tipo di query, ad esempio Standard o Query continua.
Visualizzare i dettagli di esecuzione della query
Per visualizzare i dettagli di esecuzione delle query dei job:
Lo strumento di esplorazione dei job è disponibile senza costi aggiuntivi. Le query utilizzate per popolare questi grafici non vengono fatturate e non utilizzano slot nelle prenotazioni di proprietà dell'utente. Le query che elaborano troppi dati scadono.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-17 UTC."],[[["\u003cp\u003eThe administrative jobs explorer in BigQuery allows administrators to monitor job activity across their organization without needing to write complex \u003ccode\u003eINFORMATION_SCHEMA\u003c/code\u003e queries.\u003c/p\u003e\n"],["\u003cp\u003eUsers can filter jobs by various criteria, including job scope, status, priority, owner, project ID, reservation ID, slot time, duration, bytes processed, query insights, query hash, and labels.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize the administrative jobs explorer, users require the \u003ccode\u003eroles/bigquery.resourceViewer\u003c/code\u003e IAM role and specific permissions like \u003ccode\u003ebigquery.jobs.listAll\u003c/code\u003e and \u003ccode\u003ebigquery.reservations.list\u003c/code\u003e depending on the level of access needed.\u003c/p\u003e\n"],["\u003cp\u003eJobs explorer is offered at no additional cost, and the queries that populate the charts neither use slots in user-owned reservations nor incur billing charges.\u003c/p\u003e\n"],["\u003cp\u003eUsers can access detailed query execution information through the "Execution graph" tab after filtering and selecting a specific job within the Jobs explorer interface.\u003c/p\u003e\n"]]],[],null,["# Use administrative jobs explorer\n================================\n\nAs a BigQuery administrator, you can use the administrative jobs explorer to help you monitor jobs activity across your organization. Jobs explorer also provides an array of filters and sorting options to troubleshoot and identify problematic jobs.\nJobs explorer removes the need for you to have a deep understanding of `INFORMATION_SCHEMA`, and lets you quickly view job information such as owner, project, slot usage, duration, and more, without the need to write `INFORMATION_SCHEMA` queries.\n\nBigQuery provides job details and insights through the following `INFORMATION_SCHEMA` views:\n\n- [`INFORMATION_SCHEMA.JOBS_BY_PROJECT`](/bigquery/docs/information-schema-jobs)\n- [`INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION`](/bigquery/docs/information-schema-jobs-by-organization)\n- [`INFORMATION_SCHEMA.JOBS_BY_USER`](/bigquery/docs/information-schema-jobs-by-user)\n\n| **Note:** If you use organization restrictions, see [Enable access to Google-owned resources](/resource-manager/docs/organization-restrictions/additional-considerations#google-owned-resources).\n\n### Required roles\n\n\nTo get the permissions that\nyou need to use administrative jobs explorer,\n\nask your administrator to grant you the\n\n\n[BigQuery Resource Viewer](/iam/docs/roles-permissions/bigquery#bigquery.resourceViewer) (`roles/bigquery.resourceViewer`)\nIAM role on your organization or project.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nThis predefined role contains\n\nthe permissions required to use administrative jobs explorer. To see the exact permissions that are\nrequired, expand the **Required permissions** section:\n\n\n#### Required permissions\n\nThe following permissions are required to use administrative jobs explorer:\n\n- To see data at project level: ` bigquery.jobs.listAll` on the project\n- To see data at organization level: ` bigquery.jobs.listAll` on the organization\n- To filter by reservations in your organization: ` bigquery.reservations.list` on the organization\n\n\nYou might also be able to get\nthese permissions\nwith [custom roles](/iam/docs/creating-custom-roles) or\nother [predefined roles](/iam/docs/roles-overview#predefined).\n| **Note:** This organization view is only available if you have defined Google Cloud organizations.\n\n### Filter jobs\n\nTo filter jobs for queries that are contained in the\n`INFORMATION_SCHEMA.JOBS*` views, do the following:\n\n1. In the Google Cloud console, go to the **BigQuery** page.\n\n [Go to BigQuery](https://console.cloud.google.com/bigquery)\n2. In the navigation menu, click **Jobs explorer**.\n\n3. From the **Location** list, select the location for which you want to view the\n jobs.\n\n4. Apply optional **Filters** as needed:\n\n - **Job scope**. Such as the current project, organization, and your jobs.\n - **Status**. Such as completed, error, active, and queued.\n - **Job priority**. Such as interactive or batch jobs.\n - **Job ID**.\n - **Owner**. Email ID of the job's owner (only applicable when job scope is project or organization).\n - **Project ID**. (Only applicable when job scope is organization)\n - **Reservation ID**. (Only applicable when job scope is organization)\n - **Slot time more than**. Jobs that took more time than the specified slot time.\n - **Duration more than**. Jobs that took longer than the specified duration.\n - **Bytes processed more than**. Jobs that processed more bytes than the specified processed bytes.\n - **Query Insights**. Types of query insights, such as slot contention, memory shuffle capacity exceeded, and data input scale change.\n - **Query Hash** . Query hash contains the hashes of the query. It is a hexadecimal STRING hash that ignores comments, parameter values, UDFs, and literals. This field appears for successful [GoogleSQL](/bigquery/docs/reference/standard-sql/query-syntax) queries that are not cache hits.\n - **Labels** . `key:value` pairs that can be assigned to a job. You can filter using a key, value, or `key:value` combination.\n - **Job category** . The type of query, such as **Standard** or **Continuous query**.\n\n### View query execution details\n\nTo view query execution details of jobs, do the following:\n\n1. Go to the **Jobs explorer** page.\n\n [Go to Jobs explorer](https://console.cloud.google.com/bigquery/admin/jobs-explorer)\n2. To view jobs, click **Jobs explorer**.\n\n3. [Filter jobs](#filter-jobs) to view limited jobs.\n\n4. Click a job for which you want to view the query execution details.\n\n5. In the **Query results** pane, click the **Execution graph** tab to see the execution details of your job.\n\nFor information about how to interpret insights, see\n[Interpret query performance insights](/bigquery/docs/query-insights#interpret_query_performance_insights).\n\nPricing\n-------\n\nJobs explorer is available at no additional\ncost. Queries that are used to populate these charts aren't billed and don't use slots in\nuser-owned reservations. Queries that process too much data are timed out.\n\nWhat's next\n-----------\n\n- Learn about [reservations](/bigquery/docs/reservations-intro).\n- Learn about [purchasing slots](/bigquery/docs/reservations-commitments).\n- Learn how to [estimate slot capacity requirements](/bigquery/docs/slot-estimator).\n- Learn how to [view slot recommendations and insights](/bigquery/docs/slot-recommender)."]]