Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
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.
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:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-17 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eINFORMATION_SCHEMA.SESSIONS_BY_USER\u003c/code\u003e view provides real-time metadata about BigQuery sessions created by the current user within the current project.\u003c/p\u003e\n"],["\u003cp\u003eTo access this view, users need the \u003ccode\u003ebigquery.jobs.list\u003c/code\u003e IAM permission, which is included in the Project Viewer and BigQuery User roles.\u003c/p\u003e\n"],["\u003cp\u003eThis view's data is partitioned by \u003ccode\u003ecreation_time\u003c/code\u003e, \u003ccode\u003eexpiration_time\u003c/code\u003e, and \u003ccode\u003elast_modified_time\u003c/code\u003e columns, and clustered by \u003ccode\u003eproject_id\u003c/code\u003e and \u003ccode\u003euser_email\u003c/code\u003e, displaying information for each session in a row.\u003c/p\u003e\n"],["\u003cp\u003eThe view retains information on active sessions and historical data for sessions completed within the last 180 days.\u003c/p\u003e\n"],["\u003cp\u003eQueries on this view require a region qualifier and must be executed from the same region specified in the query, and the view name is case-sensitive.\u003c/p\u003e\n"]]],[],null,["# SESSIONS_BY_USER view\n=====================\n\nThe `INFORMATION_SCHEMA.SESSIONS_BY_USER` view contains real-time\nmetadata about BigQuery sessions created by the current user in\nthe current project.\n\nRequired permissions\n--------------------\n\nTo query the `INFORMATION_SCHEMA.SESSIONS_BY_USER` view, you need\nthe `bigquery.jobs.list` Identity and Access Management (IAM) permission for the project.\nEach of the following predefined IAM roles includes the\nrequired permission:\n\n- Project Viewer\n- BigQuery User\n\nFor more information about BigQuery permissions, see\n[Access control with IAM](/bigquery/docs/access-control).\n\nSchema\n------\n\nWhen you query the `INFORMATION_SCHEMA.SESSIONS_BY_*` views, the query results\ncontain one row for each BigQuery session.\n\nThe `INFORMATION_SCHEMA.SESSIONS_BY_*` view has the following schema:\n| **Note:** The underlying data is partitioned by the `creation_time` column and clustered by `project_id` and `user_email`.\n\nData retention\n--------------\n\nThis view contains currently running sessions and the history of sessions\ncompleted in the past 180 days.\n\nScope and syntax\n----------------\n\nQueries against this view must include a [region qualifier](/bigquery/docs/information-schema-intro#syntax).\nIf you do not specify a regional qualifier, metadata is retrieved from all\nregions. The following table explains the region scope for this view:\n\nReplace the following:\n\n- Optional: \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project. If not specified, the default project is used.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: any [dataset region name](/bigquery/docs/locations). For example, ```region-us```.\n\n \u003cbr /\u003e\n\n \u003cbr /\u003e\n\n | **Note:** You must use [a region qualifier](/bigquery/docs/information-schema-intro#region_qualifier) to query `INFORMATION_SCHEMA` views. The location of the query execution must match the region of the `INFORMATION_SCHEMA` view.\n\n\u003cbr /\u003e\n\nExample\n-------\n\nTo run the query against a project other than your default project, add the\nproject ID in the following format: \n\n```bash\n`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.SESSIONS_BY_USER\n```\nFor example, ```myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER``.\n\n\u003cbr /\u003e\n\nThe following example lists sessions that were created by the current user: \n\n```googlesql\nSELECT\n session_id,\n creation_time\nFROM\n `region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER\nWHERE\n creation_time \u003e= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)\nORDER BY\n creation_time DESC;\n```\n| **Note:** `INFORMATION_SCHEMA` view names are case-sensitive.\n\nThe results should look like the following: \n\n```\n+-------------------------------------------------------------------------+\n| session_id | creation_time |\n+-------------------------------------------------------------------------+\n| CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm | 2021-06-01 08:04:26 |\n| CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-31 22:43:02 |\n+-------------------------------------------------------------------------+\n```"]]
