Présentation des sessions

Ce guide explique comment activer, créer et suivre des modifications dans une session BigQuery. Il est destiné aux utilisateurs qui connaissent déjà BigQuery et GoogleSQL.

Vous pouvez capturer vos activités SQL dans une session BigQuery. Des tables temporaires, des fonctions temporaires et des variables peuvent être utilisées tout au long de la session pour créer de manière interactive une ou plusieurs requêtes. Plusieurs sessions peuvent être actives en même temps et l'historique de chaque session est enregistré. Vous pouvez afficher l'historique d'une session pendant 20 jours maximum après l'arrêt de la session.

Les utilisations courantes d'une session sont les suivantes:

  • Conserver les données de session temporaires Définissez des variables et des tables temporaires une seule fois, et utilisez-les tout au long de la session.

  • Rechercher l'historique des requêtes par session Si vous souhaitez suivre un comportement survenu à un moment donné de la session, vous pouvez afficher l'historique des modifications apportées au cours de la session.

  • Créez des transactions multi-instructions sur plusieurs requêtes. Dans une session, vous pouvez commencer une transaction, apporter des modifications et afficher le résultat temporaire avant de décider de valider ou de revenir en arrière. Vous pouvez effectuer cette opération sur plusieurs requêtes de la session. Si vous n'utilisez pas de session, une transaction à plusieurs instructions doit être effectuée en une seule requête.

Tarifs

  • L'utilisation de sessions n'entraîne aucun coût supplémentaire.

  • Pour les projets appliquant la tarification à la demande, les requêtes INFORMATION_SCHEMA sont facturées. Pour en savoir plus, reportez-vous à la page Tarifs INFORMATION_SCHEMA.

Limites

  • Chaque requête d'une session est exécutée dans l'emplacement où la session a été créée.

  • Une session est actuellement automatiquement arrêtée après 24 heures d'inactivité.

  • Une session est actuellement automatiquement arrêtée 7 jours après sa création.

  • La taille maximale d'une variable de session est de 1 Mo, et la taille maximale de toutes les variables utilisées dans une session est de 10 Mo.

  • Aucune requête simultanée n'est autorisée dans la même session.

Rôles et autorisations

Cette section décrit les autorisations IAM (gestion de l'authentification et des accès) et les rôles IAM dont vous avez besoin pour effectuer des actions avec les sessions.

Actions Autorisations requises Rôles par défaut
Créer une session Utiliser une session existante que vous avez créée. bigquery.jobs.create bigquery.user
bigquery.Jobuser
bigquery.admin
Terminer une session que vous avez créée. bigquery.jobs.create bigquery.user
bigquery.Jobuser
bigquery.admin
Terminer une session créée par un autre utilisateur. bigquery.jobs.create
bigquery.jobs.update
 bigquery.admin
Afficher la liste de vos sessions dans un projet. Cette liste comprend les ID des sessions que vous avez créées dans un projet avec INFORMATION_SCHEMA.JOBS_BY_USER. bigquery.jobs.list bigquery.user
bigquery.Jobuser
bigquery.admin
Afficher toutes les sessions de tous les utilisateurs d'un projet. Cette liste inclut les ID de toutes les sessions créées dans le projet avec INFORMATION_SCHEMA.JOBS. bigquery.jobs.listAll bigquery.admin
Afficher les métadonnées des sessions créées par l'utilisateur actuel dans le projet en cours avec INFORMATION_SCHEMA.SESSIONS_BY_USER. bigquery.jobs.list bigquery.user
bigquery.Jobuser
bigquery.admin
Afficher les métadonnées de toutes les sessions du projet en cours avec INFORMATION_SCHEMA.SESSIONS_BY_PROJECT. bigquery.jobs.listAll bigquery.admin

Étape suivante