Afficher l'historique des requêtes dans les sessions

Ce document explique comment afficher l'historique d'une session dans BigQuery. Il est destiné aux utilisateurs qui ont déjà une compréhension générale des sessions BigQuery.

Avant de suivre cette procédure, assurez-vous de disposer des autorisations nécessaires pour afficher l'historique d'une session.

Afficher l'historique d'une session

Une session capture vos activités SQL dans un délai donné. Ces informations sont stockées dans l'historique de la session. L'historique de la session vous permet de suivre les modifications que vous avez apportées au cours de la session. Si une tâche échoue ou réussit, elle est enregistrée dans l'historique de la session afin que vous puissiez revenir ultérieurement pour voir ce que vous avez fait.

Console

Pour afficher l'historique d'une session dans la console Google Cloud, vous pouvez filtrer votre historique personnel ou votre historique de projet par ID de session pour afficher toutes les requêtes SQL exécutées lors d'une session spécifique. Pour savoir comment rechercher votre ID de session, consultez la page Rechercher des sessions.

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

Accéder à BigQuery
Sélectionnez le type d'historique des tâches à afficher :
- Pour afficher des informations sur vos tâches récentes, cliquez sur Historique personnel.
- Pour afficher les informations sur les tâches récentes de votre projet, cliquez sur Historique du projet.
Cliquez sur Filtrer, puis sélectionnez ID de session.
Dans le champ ID de session, recherchez l'ID de session :
```
Session ID: CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ
```

SQL

Pour afficher les données historiques d'une session spécifique, commencez par obtenir votre ID de session, puis procédez comme suit :

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

Accéder à BigQuery
Dans l'éditeur de requête, saisissez l'instruction suivante :
```
SELECT
  *
FROM
  region-us.INFORMATION_SCHEMA.VIEW
WHERE
  session_info.session_id = 'SESSION_ID';
```
Remplacez les éléments suivants :
- VIEW : vue INFORMATION_SCHEMA à utiliser
  
  Sélectionnez l'une des vues suivantes :
  - JOBS_BY_USER: ne renvoie que les sessions créées par l'utilisateur actuel dans le projet en cours.
  - SESSIONS_BY_USER: ne renvoie que les sessions créées par l'utilisateur actuel dans le projet en cours.
  - SESSIONS_BY_PROJECT: renvoie toutes les sessions du projet en cours.
- SESSION_ID : ID de la session pour laquelle vous souhaitez récupérer des données de l'historique.
Cliquez sur Exécuter.

Pour en savoir plus sur l'exécution des requêtes, consultez Exécuter une requête interactive.

Exemple

La requête suivante renvoie l'historique d'une session correspondant à l'ID CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0. Vous pouvez remplacer cet ID de session par le vôtre.

SELECT
  creation_time, query
FROM
  region-us.INFORMATION_SCHEMA.JOBS_BY_USER
WHERE
  session_info.session_id = 'CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0'
  AND creation_time > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 20 DAY);

Le résultat ressemble à ce qui suit :

+---------------------+------------------------------------------------------------------------------------------+
|    creation_time    |                                          query                                           |
+---------------------+------------------------------------------------------------------------------------------+
| 2021-06-01 23:04:26 | SELECT * FROM Purchases;                                                                 |
| 2021-06-01 23:02:51 | CREATE TEMP TABLE Purchases(total INT64) AS SELECT * FROM UNNEST([10,23,3,14,55]) AS a;  |
+---------------------+------------------------------------------------------------------------------------------+

Étape suivante

Rechercher des sessions