Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Les tables temporaires que vous créez dans les sessions vous sont facturées. Les frais de stockage sont basés sur la quantité de données stockées dans les tables. Pour en savoir plus sur la tarification du stockage, consultez la section Tarifs de stockage.
Limites
Chaque requête d'une session est exécutée dans l'emplacement où la session a été créée.
Une session est automatiquement arrêtée après 24 heures d'inactivité.
Une session est automatiquement arrêtée sept 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.
Les requêtes simultanées ne sont pas autorisées dans une même session.
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.
Découvrez comment utiliser les sessions, y compris comment les créer, les utiliser, les arrêter et les lister.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eBigQuery sessions allow users to capture SQL activities, utilize temporary tables and functions, and maintain variables throughout the session.\u003c/p\u003e\n"],["\u003cp\u003eSessions provide the ability to view query history and track changes within a specific timeframe, up to 20 days after termination.\u003c/p\u003e\n"],["\u003cp\u003eMulti-statement transactions can be executed over multiple queries within a session, which is not possible without sessions.\u003c/p\u003e\n"],["\u003cp\u003eWhile there are no additional costs for using sessions, charges apply for queries against \u003ccode\u003eINFORMATION_SCHEMA\u003c/code\u003e and for temporary table storage.\u003c/p\u003e\n"],["\u003cp\u003eSessions have limitations, including a 24-hour automatic termination after inactivity, a 7-day termination after creation, and constraints on variable sizes, as well as no concurrent queries allowed in the same session.\u003c/p\u003e\n"]]],[],null,["# Introduction to sessions\n========================\n\nThis guide describes how to enable, create, and track changes in a\nBigQuery session. It is intended for users who are familiar with\n[BigQuery](/bigquery/docs) and\n[GoogleSQL](/bigquery/docs/reference/standard-sql/query-syntax).\n\nYou can capture your SQL activities in a BigQuery session.\nTemporary tables, temporary functions, and variables can be used throughout the session to\ninteractively build one or more queries. Multiple sessions can be active at the\nsame time and the history for each session is saved. You can view the history\nof a session for up to 20 days after the session is terminated.\n\nTypical uses for a session include the following:\n\n- **Maintain transient session data.** Define variables and temporary tables\n once and use them throughout the session.\n\n- **Look up query history by session.** If you want to keep track of a behavior\n that happened at a particular time during the session, you can view the\n history of changes that were made during the\n session.\n\n- **Create multi-statement transactions over multiple queries.** Within a\n session, you can begin a transaction, make changes, and view the temporary\n result before deciding to commit or rollback. You can do this over several\n queries in the session. If you do not use a session, a\n multi-statement transaction needs to be completed in a single query.\n\nPricing\n-------\n\n- There are no additional costs for using sessions.\n\n- For projects that use on-demand pricing, queries against `INFORMATION_SCHEMA`\n incur charges. For more information, see\n [`INFORMATION_SCHEMA` pricing](/bigquery/docs/information-schema-intro#pricing).\n\n- You are charged for temporary tables that you create in sessions. Storage\n charges are based on how much data is stored in the tables. For information\n about storage pricing, see [Storage pricing](/bigquery/pricing#storage).\n\nLimitations\n-----------\n\n- Every query in a session is run in the location where the session was\n created.\n\n- A session is automatically terminated after 24 hours of inactivity.\n\n- A session is automatically terminated 7 days after its creation.\n\n- The maximum size of a session variable is 1 MB, and the maximum size of all\n variables used in a session is 10 MB.\n\n- Concurrent queries aren't allowed within a session.\n\nRoles and permissions\n---------------------\n\nThis section describes the\n[Identity and Access Management (IAM) permissions](/bigquery/docs/access-control#bq-permissions)\nand the [IAM roles](/bigquery/docs/access-control#bigquery)\nthat you need to perform actions with sessions.\n\nWhat's next\n-----------\n\n- Learn more about how to [write queries in sessions](/bigquery/docs/sessions-write-queries).\n- Learn more about how to [work with sessions](/bigquery/docs/sessions), including how to create, use, terminate, and list your sessions."]]
