Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Introducción a las sesiones
En esta guía, se describe cómo habilitar, crear y hacer un seguimiento de los cambios en una sesión de BigQuery. Está dirigido a usuarios familiarizados con BigQuery y GoogleSQL.
Puedes capturar tus actividades de SQL en una sesión de BigQuery.
Las tablas temporales, las funciones temporales y las variables se pueden usar en toda la sesión para compilar una o más consultas de forma interactiva. Puede haber varias sesiones activas al mismo tiempo y se guarda el historial de cada sesión. Puedes ver el historial de una sesión hasta 20 días después de que esta haya terminado.
Entre los usos típicos de una sesión, se incluyen los siguientes:
Mantener los datos de sesión transitorios. Define variables y tablas temporales una vez y úsalas en toda la sesión.
Buscar el historial de consultas por sesión. Si deseas realizar un seguimiento de un comportamiento que ocurrió en un momento determinado durante la sesión, puedes ver el historial de los cambios que se realizaron durante la sesión.
Crea transacciones de varias declaraciones en varias consultas. Dentro de una sesión, puedes comenzar una transacción, realizar cambios y ver el resultado temporal antes de decidir confirmar o revertir. Puedes hacerlo mediante varias consultas en la sesión. Si no usas una sesión, una transacción de varias declaraciones debe completarse en una sola consulta.
Precios
No hay costos adicionales por usar sesiones.
En los proyectos que usan precios según demanda, las consultas en INFORMATION_SCHEMA generan cargos. Para obtener más información, consulta Precios de INFORMATION_SCHEMA.
Se te cobrará por las tablas temporales que crees en las sesiones. Los cargos por almacenamiento se basan en la cantidad de datos almacenados en las tablas. Para obtener información sobre los precios de almacenamiento, consulta Precios de almacenamiento.
Limitaciones
Cada consulta en una sesión se ejecuta en la ubicación en la que se creó la sesión.
Actualmente, una sesión se cierra automáticamente después de 24 horas de inactividad.
Por el momento, una sesión se finaliza automáticamente 7 días después de su creación.
El tamaño máximo de una variable es de 1 MB, y el tamaño máximo de todas las variables utilizadas en una sesión es de 10 MB.
No se permiten consultas simultáneas en la misma sesión.
Crea una sesión nueva.
Trabaja con una sesión existente que hayas creado.
bigquery.jobs.create
bigquery.user bigquery.Jobuser bigquery.admin
Finaliza una sesión que creaste.
bigquery.jobs.create
bigquery.user bigquery.Jobuser bigquery.admin
Finaliza una sesión que creó otro usuario.
bigquery.jobs.create bigquery.jobs.update
bigquery.admin
Ve una lista de tus sesiones en un proyecto.
En esta lista, se incluyen los ID de las sesiones que creaste en un proyecto con INFORMATION_SCHEMA.JOBS_BY_USER.
bigquery.jobs.list
bigquery.user bigquery.Jobuser bigquery.admin
Ve todas las sesiones de todos los usuarios de un proyecto.
Esta lista incluye los ID de todas las sesiones creadas en el proyecto con INFORMATION_SCHEMA.JOBS.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-25 (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."]]
