Vue JOBS_TIMELINE_BY_USER

La vue INFORMATION_SCHEMA.JOBS_TIMELINE_BY_USER contient les métadonnées BigQuery en temps quasi-réel par tranche horaire des jobs envoyés par l'utilisateur actuel dans le projet en cours. Cette vue contient les tâches en cours et terminées.

Autorisations requises

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

• Lecteur de projets
• BigQuery User

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

Schéma

Lorsque vous lancez une requête sur les vues INFORMATION_SCHEMA.JOBS_TIMELINE_BY_*, les résultats de la requête contiennent une ligne pour chaque seconde d'exécution de chaque tâche BigQuery. Chaque période commence à un intervalle d'une seconde et dure exactement une seconde.

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

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

Nom de la colonne	Type de données	Valeur
period_start	TIMESTAMP	Heure de début de la période.
period_slot_ms	INTEGER	Emplacements de millisecondes consommés au cours de la période.
project_id	STRING	(Colonne de mise en cluster) ID du projet.
project_number	INTEGER	Numéro du projet.
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 ou DELETE.
priority	STRING	Priorité de cette tâche. Les valeurs autorisées sont INTERACTIVE et BATCH.
parent_job_id	STRING	ID de la tâche parente (le cas échéant).
job_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.
job_start_time	TIMESTAMP	Heure de début de la tâche.
job_end_time	TIMESTAMP	Heure de fin de la tâche.
state	STRING	État d'exécution de la tâche à la fin de la période. Les états valides sont les suivants : PENDING, RUNNING et DONE.
reservation_id	STRING	Nom de la réservation principale attribuée à la tâche à la fin de la période, le cas échéant.
edition	STRING	Édition associée à la réservation attribuée à ce job. Pour en savoir plus sur les éditions, consultez la page Présentation des éditions BigQuery.
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 le job. 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.
total_bytes_processed	INTEGER	Nombre total d'octets traités par la tâche.
error_result	RECORD	Détails de l'erreur (le cas échéant) en tant que ErrorProto. .
cache_hit	BOOLEAN	Indique si les résultats de requête de cette tâche ont été mis en cache.
period_shuffle_ram_usage_ratio	FLOAT	Taux d'utilisation du brassage au cours de la période sélectionnée.
period_estimated_runnable_units	INTEGER	Unités de travail pouvant être planifiées immédiatement dans cette période. Des emplacements supplémentaires pour ces unités de travail accélèrent votre requête, à condition qu'aucune autre requête de la réservation n'ait besoin d'emplacements supplémentaires.
transaction_id	STRING	ID de la transaction dans laquelle ce job a été exécuté, le cas échéant. (Aperçu)

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 la portée des régions et des ressources 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_TIMELINE_BY_USER	Tâches envoyées par l'utilisateur actuel dans le projet spécifié.	REGION

Remplacez les éléments suivants :

Facultatif : PROJECT_ID : ID de votre projet Google Cloud. Si non spécifié, le projet par défaut est utilisé.

REGION : tout nom de région d'ensemble de données. Par exemple, `region-us`.

Remarque : Vous devez utiliser un qualificatif de région pour interroger les vues INFORMATION_SCHEMA. L'emplacement d'exécution de la requête doit correspondre à la région de la vue INFORMATION_SCHEMA.

Exemple

La requête suivante affiche le nombre total de millisecondes d'emplacements consommées par seconde par les tâches envoyées par l'utilisateur actuel dans le projet désigné :

SELECT
  period_start,
  SUM(period_slot_ms) AS total_period_slot_ms
FROM
  `region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_USER
GROUP BY
  period_start
ORDER BY
  period_start DESC;

Remarque : Les noms des vues INFORMATION_SCHEMA sont sensibles à la casse.

Le résultat ressemble à ce qui suit :

+---------------------------+---------------------------------+
|  period_start             |  total_period_slot_ms           |
+---------------------------+---------------------------------+
|  2019-10-10 00:00:04 UTC  |  118639                         |
|  2019-10-10 00:00:03 UTC  |  251353                         |
|  2019-10-10 00:00:02 UTC  |  1074064                        |
|  2019-10-10 00:00:01 UTC  |  1124868                        |
|  2019-10-10 00:00:00 UTC  |  1113961                        |
+---------------------------+---------------------------------+