Vista SESSIONS

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

Autorizzazioni obbligatorie

Per eseguire query sulla vista INFORMATION_SCHEMA.SESSIONS, devi disporre dell'autorizzazione IAM bigquery.jobs.listAll per il progetto. Ciascuno dei seguenti ruoli IAM predefiniti include l'autorizzazione richiesta:

  • Proprietario progetto
  • Amministratore BigQuery

Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

Quando esegui una query sulle viste INFORMATION_SCHEMA.SESSIONS_BY_*, i risultati delle 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 è basato sull'ora UTC di questo timestamp.
expiration_time TIMESTAMP (Colonna partizionamento) Data di scadenza della sessione. Il partizionamento è basato sull'ora UTC di questo timestamp.
is_active BOOL La sessione è ancora attiva? TRUE se sì, altrimenti FALSE.
last_modified_time TIMESTAMP (Colonna partizionamento) Ora dell'ultima modifica della sessione. Il partizionamento è basato sull'ora UTC di questo timestamp.
project_id STRING (Colonna di clustering) dell'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 rispetto a questa visualizzazione devono includere un qualificatore per area geografica. Se non specifichi un qualificatore regionale, i metadati vengono recuperati da tutte le aree geografiche. La tabella seguente illustra l'ambito della regione per questa visualizzazione:

Nome visualizzazione Ambito delle risorse Ambito per area geografica
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SESSIONS[_BY_PROJECT] A livello di progetto REGION
Sostituisci quanto segue:

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
Ad esempio, `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS. L'esempio seguente elenca tutti gli utenti o gli account di servizio 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  |
+--------------+