Vista SESSIONS_BY_USER

La vista INFORMATION_SCHEMA.SESSIONS_BY_USER contiene metadati in tempo reale sulle sessioni BigQuery create dall'utente corrente nel progetto corrente.

Autorizzazioni obbligatorie

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

  • Project Viewer
  • Utente 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_USER Sessioni create dall'utente corrente nel progetto specificato. 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_USER
Ad esempio, `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER.

L'esempio seguente elenca le sessioni create dall'utente corrente:

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;

I risultati dovrebbero essere simili ai seguenti:

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