Visualizzazione SESSIONS_BY_USER

La visualizzazione INFORMATION_SCHEMA.SESSIONS_BY_USER contiene dati in tempo reale metadati sulle sessioni BigQuery create dall'utente corrente in per il progetto attuale.

Autorizzazioni obbligatorie

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

  • Visualizzatore progetto
  • Utente BigQuery

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

Schema

Quando esegui 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 Partizionamento) Data/ora di creazione della sessione. Il partizionamento è basato sull'ora UTC di questo timestamp.
expiration_time TIMESTAMP (Colonna di partizione) Ora 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 partizione) 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 di clustering) Indirizzo email o account di servizio dell'utente che ha eseguito la sessione.

Conservazione dei dati

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

Ambito e sintassi

Le query relative a questa vista devono includere un qualificatore regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati da tutti 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 viene specificato, viene utilizzato il progetto predefinito.

Esempio

Per eseguire la query su un progetto diverso da quello predefinito, aggiungi 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 |
+-------------------------------------------------------------------------+