Vue JOBS_BY_FOLDER

La vue INFORMATION_SCHEMA.JOBS_BY_FOLDER contient les métadonnées en temps réel sur toutes les tâches envoyées dans le dossier parent du projet actuel, y compris les tâches des sous-dossiers qu'il contient.

Autorisations requises

Pour interroger la vue INFORMATION_SCHEMA.JOBS_BY_FOLDER, vous devez disposer de l'autorisation Identity and Access Management (IAM) bigquery.jobs.listAll pour le dossier parent. Chacun des rôles IAM prédéfinis suivants inclut l'autorisation requise:

  • Administrateur de dossier
  • Administrateur de ressources BigQuery

Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.

Schéma

Les données sous-jacentes sont partitionnées par la colonne creation_time et mises en cluster par project_id et user_email.

La vue INFORMATION_SCHEMA.JOBS_BY_FOLDER présente le schéma suivant :

Nom de la colonne Type de données Valeur
creation_time TIMESTAMP (Colonne de partitionnement) Heure de création de la tâche. Le partitionnement est basé sur l'heure UTC de l'horodatage.
project_id STRING (Colonne de mise en cluster) ID du projet.
project_number INTEGER Numéro du projet
folder_numbers REPEATED INTEGER ID de compte Google et d'administration d'ID (GAIA) des dossiers appartenant à l'ancêtre d'un projet, en commençant par le dossier le plus proche du projet. Cette colonne n'est renseignée que dans JOBS_BY_FOLDER.
user_email STRING (Colonne de mise en cluster) Adresse e-mail ou compte de service de l'utilisateur ayant exécuté la tâche.
job_id STRING ID de la tâche. Par exemple, bquxjob_1234.
job_type STRING Type de la tâche. Il peut s'agir de QUERY, LOAD, EXTRACT, COPY ou null. Le type de tâche null indique une tâche interne, telle que l'évaluation d'une instruction de tâche de script ou l'actualisation d'une vue matérialisée.
statement_type STRING Type d'instruction de requête, si celui-ci est valide. Par exemple, SELECT, INSERT, UPDATE, DELETE ou SCRIPT. Consultez la section QueryStatementType pour obtenir la liste des valeurs valides.
priority STRING Priorité de cette tâche. Les valeurs autorisées sont INTERACTIVE et BATCH.
start_time TIMESTAMP Heure de début de la tâche.
end_time TIMESTAMP Heure de fin de la tâche.
query STRING Texte de requête SQL. Remarque : Seule la vue JOBS_BY_PROJECT possède la colonne query.
state STRING État de fonctionnement de la tâche. Les états valides sont les suivants : PENDING, RUNNING et DONE.
reservation_id STRING Nom de la réservation principale attribuée à cette tâche, le cas échéant. Si votre tâche a été exécutée dans un projet attribué à une réservation, elle doit respecter le format suivant : RESERVATION_ADMIN_PROJECT:RESERVATION_LOCATION.RESERVATION_NAME.

Dans ce résultat :

  • RESERVATION_ADMIN_PROJECT : nom du projet Google Cloud qui gère la réservation
  • RESERVATION_LOCATION : emplacement de la réservation.
  • RESERVATION_NAME : nom de la réservation.
total_bytes_processed INTEGER Nombre total d'octets traités par la tâche.
total_slot_ms INTEGER Emplacements de millisecondes pour la tâche sur toute sa durée.
error_result RECORD Détails de l'erreur (le cas échéant) sous forme de ErrorProto.
cache_hit BOOLEAN Indique si les résultats de requête de cette tâche ont été mis en cache.
destination_table RECORD Table de destination des résultats (le cas échéant).
referenced_tables RECORD Tableau de tables référencées par la tâche Rempli uniquement pour les tâches de requête.
labels RECORD Tableau de libellés appliqués à la tâche sous la forme de chaînes key et value.
timeline RECORD Chronologie de la requête de la tâche. Contient des instantanés de l'exécution des requêtes.
job_stages RECORD Étapes de la requête pour la tâche.
total_bytes_billed INTEGER Si le projet est configuré pour utiliser la tarification à la demande, ce champ contient le nombre total d'octets facturés pour la tâche. Si le projet est configuré pour utiliser la tarification forfaitaire, le nombre d'octets ne vous est pas facturé, et ce champ est fourni à titre d'information seulement.
parent_job_id STRING ID de la tâche parente (le cas échéant).
transaction_id STRING ID de la transaction dans laquelle cette tâche a été exécutée, le cas échéant. (Aperçu)
session_info RECORD Les détails de la session dans laquelle cette tâche a été exécutée, le cas échéant. (Aperçu)
bi_engine_statistics RECORD Si le projet est configuré pour utiliser l'interface SQL de BI Engine, ce champ contient BiEngineStatistics. Sinon, il est défini sur NULL.
total_modified_partitions INTEGER Nombre total de partitions modifiées par la tâche Ce champ est renseigné pour les tâches LOAD et QUERY.

Conservation des données

Cette vue contient les tâches en cours d'exécution et l'historique des tâches des 180 derniers jours.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région. Si vous ne spécifiez pas de qualificatif de région, les métadonnées sont extraites de toutes les régions. Le tableau suivant explique le champ d'application de la région pour cette vue:

Nom de la vue Champ d'application de la ressource Champ d'application de la région
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.JOBS_BY_FOLDER Dossier contenant le projet spécifié REGION
Remplacez les éléments suivants :

Lorsque vous interrogez INFORMATION_SCHEMA.JOBS_BY_FOLDER pour rechercher un coût récapitulatif des tâches de requête, excluez le type d'instruction SCRIPT, sinon certaines valeurs seront comptabilisées deux fois. La ligne SCRIPT inclut des valeurs récapitulatives pour toutes les tâches enfants exécutées dans le cadre de cette tâche.