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 SQL estándar.

Puedes capturar tus actividades de SQL en una sesión de BigQuery. Se pueden usar variables y tablas temporales durante la sesión para compilar de forma interactiva una o más consultas. 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.

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.

Funciones y permisos

En esta sección, se describen los permisos de Identity and Access Management (IAM) y las funciones de IAM que necesitas para realizar acciones con sesiones.

Acciones Permisos necesarios Funciones predeterminadas
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_BY_PROJECT. bigquery.jobs.listAll bigquery.admin
Ve los metadatos de las sesiones que creó el usuario actual en el proyecto actual con INFORMATION_SCHEMA.SESSIONS_BY_USER. bigquery.jobs.list bigquery.user
bigquery.Jobuser
bigquery.admin
Ve los metadatos de todas las sesiones en el proyecto actual con INFORMATION_SCHEMA.SESSIONS_BY_PROJECT. bigquery.jobs.listAll bigquery.admin

¿Qué sigue?