Cronologia delle query

Nota

Se l'area di lavoro è abilitata per il calcolo serverless, la cronologia delle query contiene anche tutte le query SQL e Python eseguite nel calcolo serverless per notebook e processi. Vedere Connettersi al calcolo serverless.

Se lo spazio di lavoro ha cronologia query & profilo per DLT abilitata (anteprima pubblica), la cronologia delle query mostra CREATE e REFRESH istruzioni eseguite su un magazzino dati SQL o tramite una pipeline di tabelle live Delta.

È possibile usare le informazioni disponibili tramite questa schermata per facilitare il debug dei problemi relativi alle query.

Questa sezione descrive come usare la cronologia delle query usando l'interfaccia utente. Per gestire la cronologia delle query tramite l'API, vedere Cronologia query.

Visualizzare la cronologia delle query

Per visualizzare le esecuzioni precedenti per una query:

1. Fare clic su Cronologia query nella barra laterale.
2. Opzionalmente, usare i filtri nella parte superiore della pagina per filtrare l'elenco in base all'utente, all'intervallo di date, all'elaborazione, alla durata, allo stato della query, al tipo di istruzione e all'ID dell'istruzione.

Per le query SQL di Databricks, gli utenti non amministratori senza almeno le autorizzazioni CAN MONITOR possono visualizzare solo le proprie query nella cronologia query.

Nota

Le query SQL di Databricks condivise da un utente con autorizzazioni Run as Owner per un altro utente con autorizzazioni CAN RUN vengono visualizzate nella cronologia delle query dell'utente che esegue la query e non l'utente che ha condiviso la query.

Visualizzare i dettagli della query

Per visualizzare i dettagli relativi a una query, ad esempio l'istruzione di query completa, l'origine query, la durata, il numero di righe restituite e le prestazioni di I/O o i dettagli di esecuzione.

1. Visualizzare la cronologia delle query.

2. Fare clic sul nome di una query.

   

   • ID dell'istruzione: l'identificatore univoco universale (UUID) associato all'oggetto della query specificata.
   • Stato della query: la query viene contrassegnata con lo stato corrente: In coda, In esecuzione, Completato, Non riuscito o Annullato.
   • Tipo di calcolo: questo campo mostra il tipo di calcolo usato per la query.
   • Istruzione query: questa sezione include l'istruzione di query completa. Se la query è troppo lunga da visualizzare nell'anteprima, fare clic sull'icona Expand query Espandi query per visualizzare il testo completo.
   • Fonte della query: Questo campo mostra dove è nata la query. Le query possono provenire da un'ampia gamma di origini, tra cui dashboard di AI/Business Intelligence, oggetti di query, editor SQL di Databricks, notebook e pipeline di Delta Live Tables (anteprima pubblica).
   • Durata dell'orologio a muro: mostra il tempo trascorso tra l'inizio della pianificazione e la fine dell'esecuzione della query. Il totale viene visualizzato automaticamente come somma del tempo di pianificazione e del tempo di esecuzione. Per altre informazioni, ognuno di questi campi può essere espanso in sottocategorie.
   • Dettagli di riepilogo: nella parte inferiore del pannello sono inclusi i dettagli di riepilogo sulle prestazioni della query, tra cui il tempo di attività aggregato, le righe lette e restituite, i file e le partizioni e le eventuali perdite che potrebbero verificarsi.

3. Per informazioni più dettagliate sulle prestazioni della query, incluso il relativo piano di esecuzione, fare clic su Visualizza profilo query nella parte inferiore della pagina. Per altri dettagli, vedere Profilo di query.

Terminare una query in esecuzione

Per terminare una query con esecuzione prolungata avviata dall'utente o da un altro utente:

1. Visualizzare la cronologia delle query.

2. Fare clic sul nome di una query.

3. Accanto a Stato fare clic su Annulla.

   Nota

   L'annullamento viene visualizzato solo quando una query è in esecuzione.

La query viene terminata e il relativo stato viene modificato in Annullato.

Nota

Le istruzioni che usano il calcolo di tabelle live Delta possono essere annullate solo dall'interfaccia utente delle pipeline.

Accedere alla tabella di sistema della cronologia delle interrogazioni

Le tabelle di sistema di Azure Databricks includono una tabella di cronologia query (system.query.history) in cui gli utenti con privilegi possono visualizzare i record della cronologia delle query tabellare nell'intero account. Per impostazione predefinita, solo gli amministratori hanno accesso alle tabelle di sistema dell'account. Per informazioni sull'abilitazione e l'accesso alla tabella di sistema della cronologia delle query, consultare il riferimento alla tabella di sistema della cronologia delle query .