Vista SESSIONS_BY_USER

La vista INFORMATION_SCHEMA.SESSIONS_BY_USER contiene metadatos en tiempo real sobre las sesiones de BigQuery creadas por el usuario actual en el proyecto actual.

Permisos obligatorios

Para consultar la vista INFORMATION_SCHEMA.SESSIONS_BY_USER, necesita el permiso de gestión de identidades y accesos (IAM) bigquery.jobs.list del proyecto. Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye el permiso necesario:

  • Lector de proyectos
  • Usuario de BigQuery

Para obtener más información sobre los permisos de BigQuery, consulta Control de acceso con gestión de identidades y accesos.

Esquema

Cuando consultas las vistas INFORMATION_SCHEMA.SESSIONS_BY_*, los resultados de la consulta contienen una fila por cada sesión de BigQuery.

La vista INFORMATION_SCHEMA.SESSIONS_BY_* tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
creation_time TIMESTAMP (Columna de partición) Hora de creación de esta sesión. La partición se basa en la hora UTC de esta marca de tiempo.
expiration_time TIMESTAMP (Columna de partición) Hora de vencimiento de esta sesión. La partición se basa en la hora UTC de esta marca de tiempo.
is_active BOOL ¿La sesión sigue activa? TRUE si es así; de lo contrario, FALSE.
last_modified_time TIMESTAMP Columna de partición: hora en la que se modificó la sesión por última vez. La partición se basa en la hora UTC de esta marca de tiempo.
project_id STRING (Columna de clustering) ID del proyecto.
project_number INTEGER Número del proyecto.
session_id STRING ID de la sesión. Por ejemplo, bquxsession_1234.
user_email STRING Columna de clustering: dirección de correo o cuenta de servicio del usuario que ha ejecutado la sesión.

Conservación de datos

Esta vista contiene las sesiones que se están ejecutando y el historial de las sesiones que se han completado en los últimos 180 días.

Ámbito y sintaxis

Las consultas en esta vista deben incluir un calificador de región. Si no especifica un calificador regional, los metadatos se recuperan de todas las regiones. En la siguiente tabla se explica el ámbito de la región de esta vista:

Nombre de la vista Ámbito de los recursos Ámbito de la región
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SESSIONS_BY_USER Sesiones creadas por el usuario actual en el proyecto especificado. REGION
Sustituye lo siguiente:
  • Opcional: PROJECT_ID: el ID de tu Google Cloud proyecto. Si no se especifica, se usa el proyecto predeterminado.
  • REGION: cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.

Ejemplo

Para ejecutar la consulta en un proyecto que no sea el predeterminado, añade el ID del proyecto con el siguiente formato: 

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.SESSIONS_BY_USER
 Por ejemplo, `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER.

En el siguiente ejemplo se muestran las sesiones creadas por el usuario actual:

SELECT
  session_id,
  creation_time
FROM
  `region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER
WHERE
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
ORDER BY
  creation_time DESC;

Los resultados deberían tener este aspecto:

+-------------------------------------------------------------------------+
| session_id                                        | creation_time       |
+-------------------------------------------------------------------------+
| CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm     | 2021-06-01 08:04:26 |
| CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-31 22:43:02 |
+-------------------------------------------------------------------------+