Visualização de SESSIONS_BY_USER

A visualização INFORMATION_SCHEMA.SESSIONS_BY_USER contém metadados em tempo real sobre sessões do BigQuery criadas pelo usuário atual no projeto atual.

Permissões necessárias

Para consultar a visualização INFORMATION_SCHEMA.SESSIONS_BY_USER, é necessário ter a permissão bigquery.jobs.list Identity and Access Management (IAM) do projeto. Cada um dos seguintes papéis predefinidos do IAM inclui a permissão necessária:

  • Visualizador do projeto
  • Usuário do BigQuery

Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.

Schema

Quando você consulta as visualizações INFORMATION_SCHEMA.SESSIONS_BY_*, os resultados da consulta contêm uma linha para cada sessão do BigQuery.

A visualização INFORMATION_SCHEMA.SESSIONS_BY_* tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
creation_time TIMESTAMP (Coluna de particionamento) Horário da criação da sessão. O particionamento é baseado no horário UTC desse carimbo de data/hora.
expiration_time TIMESTAMP (Coluna de particionamento) Horário de expiração da sessão. O particionamento é baseado no horário UTC desse carimbo de data/hora.
is_active BOOL A sessão ainda está ativa? TRUE se sim, caso contrário, FALSE.
last_modified_time TIMESTAMP (Coluna de particionamento) Horário da última modificação da sessão. O particionamento é baseado no horário UTC desse carimbo de data/hora.
principal_subject STRING (Coluna de clustering) Identificador principal do usuário que executou o job.
project_id STRING (Coluna de clustering) 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 clustering) Endereço de e-mail ou conta de serviço do usuário que executou o sessão.

Retenção de dados

Essa visualização contém as sessões em execução no momento e o histórico de sessões concluídos nos últimos 180 dias.

Escopo e sintaxe

As consultas nessa visualização precisam incluir um qualificador de região. Se você não especificar um qualificador regional, os metadados serão recuperados de todas as regiões. A tabela a seguir explica o escopo da região dessa visualização:

Nome da visualização Escopo do recurso Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SESSIONS_BY_USER Sessões criadas pelo usuário atual no projeto especificado. REGION
Substitua:

  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud. Se não for especificado, o projeto padrão será usado.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, region-us.

Exemplo

Para executar a consulta em um projeto diferente do seu projeto padrão, inclua 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 a seguir lista as sessões que foram criadas pelo usuário 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 terão a seguinte aparência:

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