Vista SESSIONS_BY_USER

A vista INFORMATION_SCHEMA.SESSIONS_BY_USER contém metadados em tempo real acerca das sessões do BigQuery criadas pelo utilizador atual no projeto atual.

Autorizações necessárias

Para consultar a vista INFORMATION_SCHEMA.SESSIONS_BY_USER, precisa da autorização de gestão de identidade e de acesso (IAM) bigquery.jobs.list para o projeto. Cada uma das seguintes funções de IAM predefinidas inclui a autorização necessária:

  • Visualizador de projetos
  • Utilizador do BigQuery

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Esquema

Quando consulta as vistas INFORMATION_SCHEMA.SESSIONS_BY_*, os resultados da consulta contêm uma linha para cada sessão do BigQuery.

A vista INFORMATION_SCHEMA.SESSIONS_BY_* tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
creation_time TIMESTAMP (Coluna de partição) Hora da criação desta sessão. A partição baseia-se na hora UTC desta data/hora.
expiration_time TIMESTAMP (Coluna de partição) Hora de expiração desta sessão. A partição baseia-se na hora UTC desta data/hora.
is_active BOOL A sessão ainda está ativa? TRUE se sim, caso contrário FALSE.
last_modified_time TIMESTAMP (Coluna de partição) Hora em que a sessão foi modificada pela última vez. A partição baseia-se na hora UTC desta data/hora.
project_id STRING (Coluna de agrupamento) ID do projeto.
project_number INTEGER Número do projeto.
session_id STRING ID da sessão. Por exemplo, bquxsession_1234.
user_email STRING (Coluna de agrupamento) Endereço de email ou conta de serviço do utilizador que executou a sessão.

Retenção de dados

Esta vista contém as sessões em execução e o histórico de sessões concluídas nos últimos 180 dias.

Âmbito e sintaxe

As consultas nesta vista têm de incluir um qualificador de região. Se não especificar um qualificador regional, os metadados são obtidos de todas as regiões. A tabela seguinte explica o âmbito da região para esta vista:

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SESSIONS_BY_USER Sessões criadas pelo utilizador atual no projeto especificado. REGION
Substitua o seguinte:
  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

Exemplo

Para executar a consulta num projeto que não seja o seu projeto predefinido, adicione o ID do projeto no seguinte formato: 

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

O exemplo seguinte apresenta uma lista de sessões criadas pelo utilizador atual:

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;

Os resultados devem ter o seguinte aspeto:

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