Ansicht SESSIONS_BY_USER

Die Ansicht INFORMATION_SCHEMA.SESSIONS_BY_USER enthält Echtzeitmetadaten zu BigQuery-Sitzungen, die vom aktuellen Nutzer im aktuellen Projekt erstellt wurden.

Erforderliche Berechtigungen

Zum Abfragen der INFORMATION_SCHEMA.SESSIONS_BY_USER-Ansicht benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.jobs.list für das Projekt. Jede der folgenden vordefinierten IAM-Rollen enthält die erforderliche Berechtigung:

  • Projektbetrachter
  • BigQuery-Nutzer

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.
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.

Aus Stabilitätsgründen empfehlen wir, Spalten in Ihren Informationsschema-Abfragen explizit aufzulisten, anstatt ein Platzhalterzeichen (SELECT *) zu verwenden. So 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_USER Sitzungen, die vom aktuellen Nutzer im angegebenen Projekt erstellt wurden. 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_USER
 Beispiel: `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER.

Im folgenden Beispiel werden Sitzungen aufgelistet, die vom aktuellen Nutzer erstellt wurden.

SELECT
  session_id,
  creation_time
FROM
  `region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER
WHERE
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
ORDER BY
  creation_time DESC;

Die Ergebnisse sollten so aussehen:

+-------------------------------------------------------------------------+
| session_id                                        | creation_time       |
+-------------------------------------------------------------------------+
| CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm     | 2021-06-01 08:04:26 |
| CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-31 22:43:02 |
+-------------------------------------------------------------------------+