Stay organized with collections Save and categorize content based on your preferences.
Introduction to sessionsThis guide describes how to enable, create, and track changes in a BigQuery session. It is intended for users who are familiar with BigQuery and GoogleSQL.
You can capture your SQL activities in a BigQuery session. Temporary tables, temporary functions, and variables can be used throughout the session to interactively build one or more queries. Multiple sessions can be active at the same time and the history for each session is saved. You can view the history of a session for up to 20 days after the session is terminated.
Typical uses for a session include the following:
Maintain transient session data. Define variables and temporary tables once and use them throughout the session.
Look up query history by session. If you want to keep track of a behavior that happened at a particular time during the session, you can view the history of changes that were made during the session.
Create multi-statement transactions over multiple queries. Within a session, you can begin a transaction, make changes, and view the temporary result before deciding to commit or rollback. You can do this over several queries in the session. If you do not use a session, a multi-statement transaction needs to be completed in a single query.
There are no additional costs for using sessions.
For projects that use on-demand pricing, queries against INFORMATION_SCHEMA
incur charges. For more information, see INFORMATION_SCHEMA
pricing.
You are charged for temporary tables that you create in sessions. Storage charges are based on how much data is stored in the tables. For information about storage pricing, see Storage pricing.
Every query in a session is run in the location where the session was created.
A session is automatically terminated after 24 hours of inactivity.
A session is automatically terminated 7 days after its creation.
The maximum size of a session variable is 1 MB, and the maximum size of all variables used in a session is 10 MB.
Concurrent queries aren't allowed within a session.
This section describes the Identity and Access Management (IAM) permissions and the IAM roles that you need to perform actions with sessions.
Actions Required permissions Default roles Create a new session. Work with an existing session that you created.bigquery.jobs.create
bigquery.user
bigquery.Jobuser
bigquery.admin
bigquery.jobs.create
bigquery.user
bigquery.Jobuser
bigquery.admin
bigquery.jobs.create
bigquery.jobs.update
bigquery.admin
INFORMATION_SCHEMA.JOBS_BY_USER
. bigquery.jobs.list
bigquery.user
bigquery.Jobuser
bigquery.admin
INFORMATION_SCHEMA.JOBS
. bigquery.jobs.listAll
bigquery.admin
View metadata for sessions created by the current user in the current project with INFORMATION_SCHEMA.SESSIONS_BY_USER
. bigquery.jobs.list
bigquery.user
bigquery.Jobuser
bigquery.admin
INFORMATION_SCHEMA.SESSIONS_BY_PROJECT
. bigquery.jobs.listAll
bigquery.admin
What's next
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-13 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-13 UTC."],[[["BigQuery sessions allow users to capture SQL activities, utilize temporary tables and functions, and maintain variables throughout the session."],["Sessions provide the ability to view query history and track changes within a specific timeframe, up to 20 days after termination."],["Multi-statement transactions can be executed over multiple queries within a session, which is not possible without sessions."],["While there are no additional costs for using sessions, charges apply for queries against `INFORMATION_SCHEMA` and for temporary table storage."],["Sessions 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."]]],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4