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 l'area di lavoro dispone di Cronologia query e profilo per DLT abilitato (anteprima pubblica), la cronologia delle query mostra CREATE e REFRESH le istruzioni vengono eseguite in un data warehouse 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 usare la cronologia delle query usando l'API, vedere [Cronologia query](https://docs.databricks.com/api/azure/workspace/query cronologia).
Visualizzare la cronologia delle query
Per visualizzare le esecuzioni precedenti per una query:
- Fare clic su
Cronologia query nella barra laterale. - Facoltativamente, usare i filtri nella parte superiore della pagina per filtrare l'elenco in base all'utente, all'intervallo di date, al calcolo, alla durata, allo stato della query, al tipo di istruzione e all'ID 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.
Visualizzare la cronologia delle query.
Fare clic sul nome di una query.
- ID istruzione: identificatore univoco universale (UUID) associato all'oggetto query specificato.
- 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
Espandi query per visualizzare il testo completo. - Origine query: questo campo mostra dove è stata originata la query. Le query possono provenire da un'ampia gamma di origini, tra cui dashboard di intelligenza artificiale/BI, oggetti di query, editor SQL di Databricks, notebook e pipeline di tabelle live Delta (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.
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:
Visualizzare la cronologia delle query.
Fare clic sul nome di una query.
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 query
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 tabulari dall'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 query, vedere Informazioni di riferimento sulla tabella di sistema della cronologia delle query.