Vista SESSIONS_BY_PROJECT

La vista INFORMATION_SCHEMA.SESSIONS_BY_PROJECT contiene metadati in tempo reale su tutte le sessioni BigQuery nel progetto corrente.

Autorizzazioni obbligatorie

Per eseguire query sulla vista INFORMATION_SCHEMA.SESSIONS_BY_PROJECT, devi disporre dell'autorizzazione Identity and Access Management (IAM) bigquery.jobs.listAll per il progetto. Ciascuno dei seguenti ruoli IAM predefiniti include l'autorizzazione richiesta:

  • Proprietario progetto
  • Amministratore BigQuery

Per saperne di più sulle autorizzazioni di BigQuery, consulta Controllo dell'accesso con IAM.

Schema

Quando esegui una query sulle viste INFORMATION_SCHEMA.SESSIONS_BY_*, i risultati della query contengono una riga per ogni sessione BigQuery.

La vista INFORMATION_SCHEMA.SESSIONS_BY_* ha il seguente schema:

Nome colonna Tipo di dati Valore
creation_time TIMESTAMP (Colonna di partizionamento) Ora di creazione di questa sessione. Il partizionamento si basa sull'ora UTC di questo timestamp.
expiration_time TIMESTAMP (Colonna di partizionamento) Ora di scadenza di questa sessione. Il partizionamento si basa sull'ora UTC di questo timestamp.
folder_numbers ARRAY<INT64> ID delle cartelle nella gerarchia che contiene il progetto, ordinati dal più basso al più alto nella gerarchia.
is_active BOOL La sessione è ancora attiva? TRUE se sì, altrimenti FALSE.
last_modified_time TIMESTAMP (Colonna di partizionamento) Ora dell'ultima modifica della sessione. Il partizionamento si basa sull'ora UTC di questo timestamp.
principal_subject STRING Identificatore dell'entità che ha eseguito la sessione. Formattato come user:USER_EMAIL per gli utenti con Account Google, serviceAccount:SA_EMAIL per i service account o un identificatore di entità che inizia con principal:// per le entità della federazione delle identità per la forza lavoro e della federazione delle identità per i workload.
project_id STRING (Colonna di clustering) ID del progetto.
project_number INTEGER Numero del progetto.
session_id STRING ID della sessione. Ad esempio, bquxsession_1234.
user_email STRING (Colonna di clustering) Indirizzo email o account di servizio dell'utente che ha eseguito la sessione.

Per garantire la stabilità, ti consigliamo di elencare esplicitamente le colonne nelle query di Information Schema anziché utilizzare un carattere jolly (SELECT *). L'elenco esplicito delle colonne impedisce l'interruzione delle query se lo schema sottostante cambia.

Conservazione dei dati

Questa visualizzazione contiene le sessioni attualmente in esecuzione e la cronologia delle sessioni completate negli ultimi 180 giorni.

Ambito e sintassi

Le query su questa vista devono includere un qualificatore di regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati da tutte le regioni. La tabella seguente illustra l'ambito della regione per questa visualizzazione:

Nome vista Ambito risorsa Ambito della regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT Livello progetto REGION
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo progetto Google Cloud . Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Esempio

Per eseguire la query su un progetto diverso da quello predefinito, aggiungi l'ID progetto nel seguente formato:

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT
Ad esempio, `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT. L'esempio seguente elenca tutti gli utenti o i service account che hanno creato sessioni per un determinato progetto nell'ultimo giorno:

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

Il risultato è simile al seguente:

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