Vue SESSIONS_BY_USER

La vue INFORMATION_SCHEMA.SESSIONS_BY_USER contient des métadonnées en temps réel sur les sessions BigQuery créées par l'utilisateur actuel dans le projet en cours.

Autorisations requises

Pour interroger la vue INFORMATION_SCHEMA.SESSIONS_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 interrogez les vues INFORMATION_SCHEMA.SESSIONS_BY_*, les résultats de requête contiennent une ligne pour chaque session BigQuery.

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

Nom de la colonne Type de données Value
creation_time TIMESTAMP (Colonne de partitionnement) Heure de création de la session. Le partitionnement est basé sur l'heure UTC de l'horodatage.
expiration_time TIMESTAMP (Colonne de partitionnement) Date d'expiration de la session Le partitionnement est basé sur l'heure UTC de l'horodatage.
is_active BOOL La session est-elle toujours active ? TRUE si oui, FALSE dans le cas contraire.
last_modified_time TIMESTAMP (Colonne de partitionnement) Heure de la dernière modification de la session. Le partitionnement est basé sur l'heure UTC de l'horodatage.
principal_subject STRING (Colonne de clustering) Identifiant principal de l'utilisateur qui a exécuté la tâche.
project_id STRING (Colonne de clustering) ID du projet.
project_number INTEGER Numéro du projet
session_id STRING ID de la session. Par exemple, bquxsession_1234.
user_email STRING (Colonne de mise en cluster) Adresse e-mail ou compte de service de l'utilisateur ayant exécuté la session.

Conservation des données

Cette vue contient les sessions en cours d'exécution et l'historique des sessions terminées au cours 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.SESSIONS_BY_USER Sessions créé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. Exemple : region-us.

Exemple

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.SESSIONS_BY_USER
Par exemple, `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER.

L'exemple suivant répertorie les sessions créées par l'utilisateur actuel.

SELECT
  session_id,
  creation_time
FROM
  `region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER
WHERE
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
ORDER BY
  creation_time DESC;

Les résultats doivent se présenter sous la forme suivante :

+-------------------------------------------------------------------------+
| session_id                                        | creation_time       |
+-------------------------------------------------------------------------+
| CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm     | 2021-06-01 08:04:26 |
| CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-31 22:43:02 |
+-------------------------------------------------------------------------+