Visualizzazione SESSIONS_BY_PROJECT

La visualizzazione INFORMATION_SCHEMA.SESSIONS_BY_PROJECT contiene i metadati in tempo reale di tutte le sessioni BigQuery nel progetto corrente.

Autorizzazioni obbligatorie

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.SESSIONS_BY_PROJECT, devi avere l'autorizzazione bigquery.jobs.listAll Identity and Access Management (IAM) 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 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 partizione) Ora di creazione di questa sessione. Il partizionamento è basato sull'ora UTC di questo timestamp.
expiration_time TIMESTAMP (Colonna di partizione) Ora di scadenza di questa 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 di partizionamento) Data e ora dell'ultima modifica della sessione. Il partizionamento si basa sull'ora UTC di questo timestamp.
project_id STRING (Colonna di clustering) del progetto.
project_number INTEGER Numero del progetto.
session_id STRING ID della sessione. Ad esempio, bquxsession_1234.
user_email STRING (Colonna clustering) Indirizzo email o account di servizio di l'utente che ha eseguito la sessione.

Conservazione dei dati

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

Ambito e sintassi

Le query su questa visualizzazione devono includere un qualificatore 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 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.

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