En tant qu'administrateur BigQuery, vous pouvez utiliser l'explorateur de jobs d'administration pour surveiller l'activité des jobs dans votre organisation. L'explorateur de jobs fournit également un ensemble de filtres et d'options de tri permettant d'identifier les jobs problématiques et de résoudre les problèmes associés.
L'explorateur de jobs vous évite d'avoir à maîtriser INFORMATION_SCHEMA. Il vous permet d'afficher rapidement des informations sur les jobs telles que le propriétaire, le projet, l'utilisation des emplacements, la durée, etc… sans avoir à écrire des requêtes INFORMATION_SCHEMA.
BigQuery fournit des informations et des insights sur les jobs via les vues INFORMATION_SCHEMA suivantes :
Pour obtenir les autorisations nécessaires pour utiliser l'explorateur de jobs d'administration, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de ressources BigQuery (roles/bigquery.resourceViewer) au niveau de votre organisation ou de votre projet.
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Ce rôle prédéfini contient les autorisations requises pour utiliser l'explorateur de jobs d'administration. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Vous devez disposer des autorisations suivantes pour utiliser l'explorateur de jobs d'administration :
Pour afficher les données au niveau du projet : bigquery.jobs.listAll sur le projet
Pour afficher les données au niveau de l'organisation : bigquery.jobs.listAll sur l'organisation
Pour filtrer par réservation dans votre organisation : bigquery.reservations.list sur l'organisation
Dans le menu de navigation, cliquez sur Explorateur de jobs.
Dans la liste Emplacement, sélectionnez l'emplacement pour lequel vous souhaitez afficher les jobs.
Appliquez des filtres facultatifs si nécessaire :
Champ d'application du job. Le projet actuel, l'organisation et vos tâches, par exemple.
État. "completed" (terminé), "error" (erreur), "active" (actif) et "queued" (en file d'attente), par exemple.
Priorité du job. Jobs interactifs ou par lot, par exemple.
ID du job.
Propriétaire. ID d'adresse e-mail du propriétaire du job (applicable uniquement lorsque le champ d'application du job est défini sur le projet ou l'organisation).
ID du projet : (ne s'applique que lorsque le champ d'application du job est défini sur l'organisation)
ID de réservation. (ne s'applique que lorsque le champ d'application du job est défini sur l'organisation)
Durée d'utilisation des emplacements supérieure à. Jobs ayant pris plus de temps que la durée d'utilisation des emplacements spécifiée
Durée supérieure à. Jobs ayant pris plus de temps que la durée spécifiée.
Octets traités supérieurs à. Jobs ayant traité plus d'octets que le nombre d'octets traités spécifié
Insights sur les requêtes. Types d'insights sur les requêtes, tels que les conflits d'emplacements, le dépassement de la capacité de brassage de la mémoire et la modification de l'échelle de saisie des données
Hachage de requête. Hachage de la requête contenant les hachages de la requête. Il s'agit d'un hachage hexadécimal STRING qui ignore les commentaires, les valeurs de paramètre, les UDF et les littéraux.
Ce champ apparaît pour les requêtes GoogleSQL réussies qui ne sont pas des succès de cache (hit).
Étiquettes. Paires key:value pouvant être attribuées à un job. Vous pouvez filtrer à l'aide d'une clé, d'une valeur ou d'une combinaison key:value.
Catégorie de job. Type de requête, tel que Requête standard ou Requête continue.
Afficher les détails d'exécution d'une requête
Pour afficher les détails d'exécution des requêtes pour les jobs, procédez comme suit :
L'explorateur de jobs est disponible sans frais supplémentaires. Les requêtes utilisées pour remplir ces graphiques ne sont pas facturées et n'utilisent pas d'emplacements dans les réservations appartenant à l'utilisateur. Les requêtes qui traitent un trop grand volume de données expirent.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/16 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/16 (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)."]]
