Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Visualização de SESSIONS_BY_PROJECT
A visualização INFORMATION_SCHEMA.SESSIONS_BY_PROJECT contém metadados
em tempo real sobre todas as sessões do BigQuery no projeto atual.
Permissões necessárias
Para consultar a visualização INFORMATION_SCHEMA.SESSIONS_BY_PROJECT, é necessário ter a permissão bigquery.jobs.listAll 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:
Por exemplo, `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT.
O exemplo a seguir lista todos os usuários ou contas de serviço que criaram sessões
para um determinado projeto no último dia:
[[["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_PROJECT\u003c/code\u003e view provides real-time metadata for all BigQuery sessions within a project.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this view requires the \u003ccode\u003ebigquery.jobs.listAll\u003c/code\u003e IAM permission, which is included in the Project Owner and BigQuery Admin roles.\u003c/p\u003e\n"],["\u003cp\u003eEach row in the query results corresponds to a single BigQuery session, containing information like creation time, expiration time, and user details.\u003c/p\u003e\n"],["\u003cp\u003eThis view retains data for currently running sessions and those completed within the past 180 days.\u003c/p\u003e\n"],["\u003cp\u003eQueries against this view must include a region qualifier, specifying the dataset region, and the query execution location must match the region of the view.\u003c/p\u003e\n"]]],[],null,["# SESSIONS_BY_PROJECT view\n========================\n\nThe `INFORMATION_SCHEMA.SESSIONS_BY_PROJECT` view contains real-time\nmetadata about all BigQuery sessions in the current project.\n\nRequired permissions\n--------------------\n\nTo query the `INFORMATION_SCHEMA.SESSIONS_BY_PROJECT` view, you need\nthe `bigquery.jobs.listAll` Identity and Access Management (IAM) permission for the project.\nEach of the following predefined IAM roles includes the\nrequired permission:\n\n- Project Owner\n- BigQuery Admin\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_PROJECT\n```\nFor example, ```myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT``. The following example lists all users or service accounts that created sessions for a given project within the last day:\n\n\u003cbr /\u003e\n\n```googlesql\nSELECT\n DISTINCT(user_email) AS user\nFROM\n `region-us`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT\nWHERE\n is_active = true\n AND creation_time \u003e= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY);\n```\n| **Note:** `INFORMATION_SCHEMA` view names are case-sensitive.\n\nThe result is similar to the following: \n\n```\n+--------------+\n| user |\n+--------------+\n| abc@xyz.com |\n+--------------+\n| def@xyz.com |\n+--------------+\n```"]]
