Utiliser l'explorateur de jobs d'administration

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 :

Rôles requis

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

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Filtrer les jobs

Pour filtrer les jobs des requêtes figurant dans les vues INFORMATION_SCHEMA.JOBS*, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le panneau de navigation, sélectionnez Administration > Explorateur de jobs.

  3. Dans la liste Emplacement, sélectionnez l'emplacement pour lequel vous souhaitez afficher les jobs.

  4. 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.

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 :

  1. Accédez à la page Explorateur de jobs.

    Accéder à l'explorateur de jobs

  2. Pour afficher les jobs, cliquez sur Explorateur de jobs.

  3. Filtrez les jobs pour en afficher un nombre restreint.

  4. Cliquez sur le job pour lequel vous souhaitez afficher les détails d'exécution des requêtes.

  5. Dans le volet Résultats de la requête, cliquez sur l'onglet Graphique d'exécution pour afficher les détails d'exécution de votre job.

    Graphique d'exécution des jobs.

Pour en savoir plus sur l'interprétation des insights, consultez la section Interpréter les insights sur les performances des requêtes.

Tarifs

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.

Étapes suivantes