Vue JOBS_TIMELINE
La vue INFORMATION_SCHEMA.JOBS_TIMELINE
contient les métadonnées BigQuery en temps quasi réel par tranche horaire pour tous les jobs envoyés 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
, vous devez disposer de l'autorisation IAM (Identity and Access Management) bigquery.jobs.listAll
pour le projet.
Chacun des rôles IAM prédéfinis suivants inclut l'autorisation requise :
- Propriétaire du projet
- BigQuery Admin
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 :
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. |
period_shuffle_ram_usage_ratio |
FLOAT |
Taux d'utilisation du brassage au cours de la période sélectionnée. |
project_id |
STRING |
(Colonne de clustering) ID du projet. |
project_number |
INTEGER |
Numéro du projet |
folder_numbers |
REPEATED INTEGER |
ID numériques des dossiers contenant le projet, en commençant par le dossier qui contient immédiatement le projet, suivi du dossier contenant le dossier enfant, et ainsi de suite. Par exemple, si `folder_numbers` est `[1, 2, 3]`, le dossier `1` contient immédiatement le projet, le dossier `2` contient le `1` et le dossier `3` contient `2`. |
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 . |
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. |
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_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. |
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_TIMELINE[_BY_PROJECT] |
Niveau Projet | REGION |
- 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. Exemple :region-us
.
Examples
Pour exécuter la requête sur un projet autre que celui par défaut, ajoutez l'ID du projet en respectant le format suivant :
`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.VIEWExemple :
`myproject`.`region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE
.
L'exemple suivant calcule l'utilisation des emplacements pour chaque seconde au cours du dernier jour.
SELECT period_start, SUM(period_slot_ms) AS total_slot_ms, FROM `reservation-admin-project.region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE WHERE period_start BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY) AND CURRENT_TIMESTAMP() 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_slot_ms | +---------------------+---------------+ | 2020-07-29 03:52:14 | 122415176 | | 2020-07-29 03:52:15 | 141107048 | | 2020-07-29 03:52:16 | 173335142 | | 2020-07-28 03:52:17 | 131107048 | +---------------------+---------------+
Vous pouvez vérifier l'utilisation d'une réservation spécifique à l'aide de WHERE reservation_id = "…"
. Pour les tâches de script, la tâche parente indique également l'utilisation totale des emplacements par ses tâches enfants. Pour éviter de comptabiliser deux fois, utilisez WHERE statement_type != "SCRIPT"
pour exclure la tâche parente.
Exemple : Nombre de tâches RUNNING
et PENDING
au fil du temps
Pour exécuter la requête sur un projet autre que celui par défaut, ajoutez l'ID du projet en respectant le format suivant :
`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.VIEWExemple :
`myproject`.`region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE
.
L'exemple suivant calcule le nombre de tâches RUNNING
et PENDING
à chaque seconde au cours du dernier jour.
SELECT period_start, SUM(IF(state = "PENDING", 1, 0)) as PENDING, SUM(IF(state = "RUNNING", 1, 0)) as RUNNING FROM `reservation-admin-project.region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE WHERE period_start BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY) AND CURRENT_TIMESTAMP() GROUP BY period_start;
Le résultat ressemble à ce qui suit :
+---------------------+---------+---------+ | period_start | PENDING | RUNNING | +---------------------+---------+---------+ | 2020-07-29 03:52:14 | 7 | 27 | | 2020-07-29 03:52:15 | 1 | 21 | | 2020-07-29 03:52:16 | 5 | 21 | | 2020-07-29 03:52:17 | 4 | 22 | +---------------------+---------+---------+
Exemple : Utilisation des ressources par tâches à un moment précis
Pour exécuter la requête sur un projet autre que celui par défaut, ajoutez l'ID du projet en respectant le format suivant :
`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.VIEWExemple :
`myproject`.`region-us`.INFORMATION_SCHEMA.JOBS
.
L'exemple suivant renvoie l'ID (job_id
) de toutes les tâches exécutées à un moment spécifique, ainsi que leur utilisation des ressources au cours de cette période d'une seconde :
SELECT job_id, period_slot_ms FROM `reservation-admin-project.region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_PROJECT WHERE period_start = '2020-07-29 03:52:14' AND statement_type != 'SCRIPT';
Le résultat ressemble à ce qui suit :
+------------------+ | job_id | slot_ms | +------------------+ | job_1 | 2415176 | | job_2 | 4417245 | | job_3 | 427416 | | job_4 | 1458122 | +------------------+