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:

  • Project Owner
  • BigQuery-Administrator

Weitere Informationen zu BigQuery-Berechtigungen finden Sie unter Zugriffssteuerung mit IAM.

Schema

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.
folder_numbers ARRAY<INT64> IDs der Ordner in der Hierarchie, die das Projekt enthalten, sortiert von der niedrigsten zur höchsten Ebene in der Hierarchie.
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.
principal_subject STRING Kennung für das Hauptkonto, das die Sitzung ausgeführt hat. Formatiert als user:USER_EMAIL für Google-Kontonutzer, serviceAccount:SA_EMAIL für Dienstkonten oder eine Hauptkonto-ID, die mit principal:// für Hauptkonten der Mitarbeiteridentitätsföderation und der Workload Identity-Föderation beginnt.
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.

Aus Gründen der Stabilität empfehlen wir, Spalten in Ihren Informationsschemaabfragen explizit aufzulisten, anstatt einen Platzhalter (SELECT *) zu verwenden. Durch das explizite Auflisten von Spalten wird verhindert, dass Abfragen fehlschlagen, wenn sich das zugrunde liegende Schema ändert.

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:

Ansichtsname Ressourcenbereich Regionsbereich
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT Projektebene REGION
Dabei gilt:
  • Optional: PROJECT_ID: die ID Ihres Google Cloud -Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.
  • REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: `region-us`

Beispiel

Wenn Sie die Abfrage für ein anderes Projekt als Ihr Standardprojekt ausführen möchten, fügen Sie die Projekt-ID im folgenden Format hinzu:

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT
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:

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);

Das Ergebnis sieht etwa so aus:

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