Vista SESSIONS_BY_PROJECT

A vista INFORMATION_SCHEMA.SESSIONS_BY_PROJECT contém metadados em tempo real sobre todas as sessões do BigQuery no projeto atual.

Autorizações necessárias

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

  • Proprietário do projeto
  • Administrador 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_PROJECT Nível do projeto 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_PROJECT
 Por exemplo, `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT. O exemplo seguinte lista todos os utilizadores ou contas de serviço que criaram sessões para um determinado projeto no último dia:

SELECT
  DISTINCT(user_email) AS user
FROM
  `region-us`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT
WHERE
  is_active = true
  AND creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY);

O resultado é semelhante ao seguinte:

+--------------+
| user         |
+--------------+
| abc@xyz.com  |
+--------------+
| def@xyz.com  |
+--------------+