Utilizza le sessioni
Le sessioni in BigQuery consentono di mantenere lo stato, ad esempio tabelle temporanee, funzioni temporanee e variabili, in più query SQL. Puoi creare, eseguire query, elencare e terminare le sessioni nella console Cloud de Confiance , nello strumento a riga di comando bq o nell'API BigQuery.
Prima di completare questi passaggi, assicurati di disporre delle autorizzazioni necessarie.
Crea una sessione
Se vuoi acquisire un gruppo di attività SQL, crea una sessione BigQuery. Dopo aver creato una sessione, puoi eseguire query interattive al suo interno fino alla sua terminazione. Tutte le query della sessione vengono eseguite (elaborate) nella località in cui è stata creata la sessione.
Console
Nella console Cloud de Confiance , ogni sessione viene assegnata a una scheda dell'editor.
Nella console Cloud de Confiance , vai alla pagina BigQuery.
Fai clic su Crea nuova query. Si apre una nuova scheda dell'editor.
Fai clic su Modifica > Impostazioni query. Viene visualizzato il riquadro Impostazioni query.
Nella sezione Gestione delle sessioni, fai clic su Usa la modalità sessione per attivare la modalità sessione.
In Impostazioni aggiuntive > Posizione dei dati, seleziona la posizione. Una volta creata la sessione, tutte le query al suo interno sono limitate a questa località e non possono essere modificate.
Fai clic su Salva.
Scrivi una query nella scheda dell'editor ed eseguila. La nuova sessione viene creata dopo l'esecuzione di questa prima query.
bq
Apri Cloud Shell e inserisci il seguente comando bq query:
bq query \ --nouse_legacy_sql \ --create_session [--location 'SESSION_LOCATION'] \ 'SQL_STATEMENT'
dove:
- SESSION_LOCATION: Associa la sessione a una posizione fisica. Limita tutte le query della sessione a questa località. Facoltativo.
- SQL_STATEMENT: la prima istruzione SQL della sessione.
L'ID sessione viene restituito con i risultati della query.
API
Chiama il metodo jobs.query con i seguenti parametri:
{ "query": "SQL_STATEMENT", "createSession": true, ["location": "SESSION_LOCATION"] }
dove:
- SQL_STATEMENT: la prima istruzione SQL della sessione.
- SESSION_LOCATION: Associa la sessione a una posizione fisica. Limita tutte le query della sessione a questa località. Facoltativo.
Il corpo della risposta è simile al seguente:
{
"jobReference": {
"projectId": "myProject",
"jobId": "job_123"
},
"statistics": {
"sessionInfo": {
"sessionId": "CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ"
}
}
}
Esegui una query in una sessione
Dopo aver creato una sessione, puoi eseguire query al suo interno:
Console
Nella console Cloud de Confiance , vai alla pagina BigQuery.
Fai clic sulla scheda dell'editor che contiene la sessione.
Aggiungi la query alla sessione e fai clic su Esegui.
bq
Apri Cloud Shell e inserisci il seguente comando bq query:
bq query \ --nouse_legacy_sql \ --session_id=SESSION_ID \ 'SQL_STATEMENT'
dove:
- SESSION_ID: sostituisci questo valore con l'ID della sessione con cui vuoi lavorare.
- SQL_STATEMENT: un'istruzione SQL da eseguire nella sessione.
I risultati della query sono seguiti dall'ID sessione.
Se intendi eseguire molte query con Cloud Shell, puoi aggiungere l'ID sessione a [query] in .bigqueryrc in modo da non dover copiare e incollare l'ID sessione in ogni comando.
Ecco un esempio di ID sessione in .bigqueryrc:
[query]
--session_id=CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ
Dopo aver aggiunto l'ID sessione a .bigqueryrc, puoi omettere il flag --session_id dal comando bq query. Se vuoi utilizzare una sessione diversa o se una sessione termina, devi aggiornare il file .bigqueryrc.
API
Chiama il metodo jobs.query con i seguenti parametri:
{ "query": "SQL_STATEMENT", "connectionProperties": [{ "key": "session_id", "value": "SESSION_ID" }] }
dove:
- SQL_STATEMENT: la prima istruzione SQL della sessione.
- SESSION_ID: l'ID della sessione.
Termina una sessione
Una sessione può essere terminata manualmente o automaticamente. La cronologia di una sessione terminata è disponibile per 20 giorni dopo la chiusura.
Termina automaticamente una sessione
Una sessione viene terminata automaticamente dopo 24 ore di inattività o dopo 7 giorni, a seconda di quale evento si verifica per primo.
Termina la sessione corrente
Puoi terminare la sessione corrente con un'istruzione SQL o nella consoleCloud de Confiance , se la sessione è stata creata lì.
Console
Nella console Cloud de Confiance , vai alla pagina BigQuery.
Trova la scheda dell'editor che contiene la tua sessione e chiudila. La sessione viene terminata.
SQL
Per terminare la sessione:
Nella console Cloud de Confiance , vai alla pagina BigQuery.
Nell'editor di query, inserisci la seguente istruzione:
CALL BQ.ABORT_SESSION();
Fai clic su Esegui.
Per saperne di più su come eseguire le query, consulta Esegui una query interattiva.
Termina una sessione per ID
Puoi terminare una sessione utilizzando il suo ID. Non è necessario partecipare alla sessione per terminarla in questo modo.
Recupera l'ID sessione, quindi esegui la seguente istruzione:
CALL BQ.ABORT_SESSION(SESSION_ID);
Sostituisci SESSION_ID con l'ID della sessione da terminare.
Recupera l'ID della sessione di attività attiva
In alcune situazioni, devi fare riferimento a una sessione per continuare a lavorare al suo interno. Ad esempio, se utilizzi Cloud Shell, devi includere l'ID sessione ogni volta che esegui un comando per quella sessione.
Console
Non è necessario fornire l'ID sessione per eseguire una nuova query all'interno di una sessione nella console Cloud de Confiance . Puoi semplicemente continuare a lavorare nella scheda dell'editor che contiene la sessione. Tuttavia, se vuoi fare riferimento alla tua sessione in Cloud Shell o in una chiamata API, devi conoscere l'ID della sessione che hai creato nella console.
Prima di completare questi passaggi, assicurati di aver eseguito almeno una query in una sessione attiva.
Nella console Cloud de Confiance , vai alla pagina BigQuery.
Fai clic sulla scheda dell'editor che contiene la sessione.
In Risultati delle query, fai clic su Informazioni job.
Nell'elenco Informazioni sul job, cerca l'ID sessione:
Session ID: CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ
bq
Per eseguire i comandi di query in una sessione all'interno di Cloud Shell, devi includere l'ID sessione nel comando. Puoi ottenere l'ID sessione quando crei una sessione o elencando le sessioni.
Quando crei una sessione con Cloud Shell, l'ID sessione restituito è simile al seguente:
In session: CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ
API
Per passare i comandi SQL in una sessione con una chiamata API, devi includere l'ID sessione nella chiamata API. Puoi ottenere l'ID sessione quando crei una sessione o elencando le sessioni.
Quando crei una sessione con una chiamata API, l'ID sessione nella risposta è simile al seguente:
sessionId: CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ
Elenca le sessioni attive e non attive
Per ottenere gli ID sessione delle sessioni attive e non attive, segui questi passaggi:
Console
Nella console Cloud de Confiance , vai alla pagina BigQuery.
Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

Se non vedi il riquadro a sinistra, fai clic su Espandi riquadro sinistro per aprirlo.
Nel riquadro Explorer, fai clic su Cronologia job.
Seleziona il tipo di cronologia dei job:
- Per visualizzare le informazioni sui tuoi job recenti, fai clic su Cronologia personale.
- Per visualizzare le informazioni sui job recenti nel progetto, fai clic su Cronologia progetto.
Nella colonna ID sessione puoi visualizzare gli ID sessione dei tuoi job.
SQL
Per ottenere un elenco delle tre sessioni più recenti, incluse quelle attive e terminate, esegui questa query nella scheda dell'editor:
Nella console Cloud de Confiance , vai alla pagina BigQuery.
Nell'editor di query, inserisci la seguente istruzione:
SELECT session_id, MAX(creation_time) AS last_modified_time FROM `region-REGION_NAME`.INFORMATION_SCHEMA.SESSIONS_BY_USER> WHERE session_id IS NOT NULL AND creation_time > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 20 DAY) GROUP BY session_id ORDER BY last_modified_time DESC;
Sostituisci REGION_NAME con il nome della regione in cui elencare le sessioni.
Fai clic su Esegui.
Per saperne di più su come eseguire le query, consulta Esegui una query interattiva.
Il risultato è simile al seguente:
+-------------------------------------------------------------------------+ | session_id | last_modified_time | +-------------------------------------------------------------------------+ | CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm | 2021-06-01 23:04:26 | | CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-30 22:43:02 | | CgwKCmZhbGl1LXRlc3QQY2MzLTg4ZDEtYzVhOWZiYmM5NzZk | 2021-04-07 22:31:21 | +-------------------------------------------------------------------------+
Visualizza la cronologia di una sessione
Una sessione acquisisce le tue attività SQL in un periodo di tempo. Queste informazioni vengono memorizzate nella cronologia della sessione. La cronologia delle sessioni ti consente di monitorare le modifiche che hai apportato nella sessione. Se un job non va a buon fine o viene eseguito correttamente, viene registrato nella cronologia della sessione, in modo che tu possa tornare indietro in un secondo momento e vedere cosa hai fatto.
Console
Per visualizzare la cronologia di una sessione nella console Cloud de Confiance , puoi filtrare la cronologia personale o la cronologia del progetto in base all'ID sessione per visualizzare tutte le query SQL eseguite in una sessione specifica.
Nella console Cloud de Confiance , vai alla pagina BigQuery.
Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

Nel riquadro Explorer, fai clic su Cronologia job.
Seleziona il tipo di cronologia dei job che vuoi visualizzare:
- Per visualizzare le informazioni sui job recenti, fai clic su Cronologia personale.
- Per visualizzare le informazioni sui job recenti nel progetto, fai clic su Cronologia progetto.
Fai clic su Filtro e poi seleziona ID sessione.
Nel campo ID sessione, cerca l'ID sessione:
Session ID: CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ
SQL
Per visualizzare i dati storici di una sessione specifica, innanzitutto recupera l'ID sessione, poi segui questi passaggi:
Nella console Cloud de Confiance , vai alla pagina BigQuery.
Nell'editor di query, inserisci la seguente istruzione:
SELECT * FROM `region-REGION_NAME`.INFORMATION_SCHEMA.SESSIONS_BY_USER WHERE session_info.session_id = 'SESSION_ID';
Sostituisci quanto segue:
- REGION_NAME: il nome della regione in cui visualizzare i dati della sessione
- SESSION_ID: l'ID della sessione per cui recuperare i dati storici
Fai clic su Esegui.
Per saperne di più su come eseguire le query, consulta Esegui una query interattiva.
Esempio
Il seguente comando restituisce la cronologia di una sessione con l'ID sessione
CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0. Puoi sostituire questo ID sessione con il tuo.
SELECT creation_time, query FROM `region-REGION_NAME`.INFORMATION_SCHEMA.JOBS_BY_USER WHERE session_info.session_id = 'CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0' AND creation_time > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 20 DAY);
Il risultato è simile al seguente:
+---------------------+------------------------------------------------------------------------------------------+
| creation_time | query |
+---------------------+------------------------------------------------------------------------------------------+
| 2021-06-01 23:04:26 | SELECT * FROM Purchases; |
| 2021-06-01 23:02:51 | CREATE TEMP TABLE Purchases(total INT64) AS SELECT * FROM UNNEST([10,23,3,14,55]) AS a; |
+---------------------+------------------------------------------------------------------------------------------+
Passaggi successivi
- Consulta l'Introduzione alle sessioni.
- Scopri di più sulla scrittura di query nelle sessioni.