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 |
-
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
`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 | +--------------+