Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ansicht SESSIONS_BY_PROJECT
Die Ansicht INFORMATION_SCHEMA.SESSIONS_BY_PROJECT enthält Echtzeit-Metadaten zu allen BigQuery-Sitzungen im aktuellen Projekt.
Erforderliche Berechtigungen
Zum Abfragen der INFORMATION_SCHEMA.SESSIONS_BY_PROJECT-Ansicht benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.jobs.listAll für das Projekt.
Jede der folgenden vordefinierten IAM-Rollen enthält die erforderliche Berechtigung:
Wenn Sie die Ansichten des Typs INFORMATION_SCHEMA.SESSIONS_BY_* abfragen, wird in den Abfrageergebnisse jede BigQuery-Sitzung in einer eigenen Zeile dargestellt.
Die Ansicht INFORMATION_SCHEMA.SESSIONS_BY_* hat das folgende Schema:
Spaltenname
Datentyp
Wert
creation_time
TIMESTAMP
(Partitionierungsspalte) Erstellungszeit dieser Sitzung.
Die Partitionierung basiert auf der UTC-Zeit dieses Zeitstempels.
expiration_time
TIMESTAMP
(Partitionierungsspalte) Ablaufzeit dieser Sitzung.
Die Partitionierung basiert auf der UTC-Zeit dieses Zeitstempels.
is_active
BOOL
Ist die Sitzung noch aktiv? TRUE wenn ja, andernfalls FALSE.
last_modified_time
TIMESTAMP
(Partitionierungsspalte) Zeit, zu der die Sitzung zuletzt geändert wurde.
Die Partitionierung basiert auf der UTC-Zeit dieses Zeitstempels.
project_id
STRING
(Clustering-Spalte) ID des Projekts.
project_number
INTEGER
Nummer des Projekts.
session_id
STRING
ID der Sitzung. Beispiel: bquxsession_1234.
user_email
STRING
(Clustering-Spalte) E-Mail-Adresse oder Dienstkonto des Nutzers, der die Sitzung ausgeführt hat.
Datenaufbewahrung
Diese Ansicht enthält derzeit ausgeführte Sitzungen und den Verlauf der Sitzungen, die in den letzten 180 Tagen abgeschlossen wurden.
Bereich und Syntax
Für Abfragen dieser Ansicht muss ein Regions-Qualifier verwendet werden.
Wenn Sie keinen regionalen Qualifier angeben, werden Metadaten aus allen Regionen abgerufen. In der folgenden Tabelle wird der Regionsbereich für diese Ansicht erläutert:
Beispiel: `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT.
Im folgenden Beispiel werden alle Nutzer oder Dienstkonten aufgelistet, die innerhalb des letzten Tages Sitzungen für ein bestimmtes Projekt erstellt haben:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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```"]]
