Visualizzazione SESSIONS_BY_USER

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

Autorizzazioni obbligatorie

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

  • Visualizzatore progetto
  • Utente BigQuery

Per maggiori informazioni sulle autorizzazioni 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) Data/ora di creazione di questa sessione. Il partizionamento si basa sull'ora UTC di questo timestamp.
expiration_time TIMESTAMP (Colonna di partizionamento) Data di scadenza di questa sessione. Il partizionamento si basa sull'ora UTC di questo timestamp.
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 (Colonna di clustering) Identificatore entità dell'utente che ha eseguito il job.
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.

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 in questa vista devono includere un qualificatore regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati da tutte le regioni. La tabella seguente spiega l'ambito della regione per questa visualizzazione:

Nome vista Ambito risorsa Ambito 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.

Nell'esempio seguente sono elencate 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 |
+-------------------------------------------------------------------------+