查詢歷程記錄
注意
如果您的工作區已啟用無伺服器計算,您的查詢歷程記錄也會包含筆記本和作業在無伺服器計算上執行的所有 SQL 和 Python 查詢。 請參閱連線至無伺服器計算。
如果您的工作區已啟用 DLT 的查詢歷程記錄和設定檔(公開預覽),您的查詢歷程記錄會顯示 CREATE
和 REFRESH
語句在 SQL 倉儲上或透過 Delta Live Tables 管線執行。
您可以使用此畫面中可用的信息,協助您偵錯查詢的問題。
本節說明如何使用 UI 來處理查詢歷程記錄。 若要使用 API 處理查詢歷程記錄,請參閱 查詢記錄。
檢視查詢歷程記錄
若要檢視查詢的先前執行:
- 按兩下提要欄位中的 [查詢記錄]。
- 或者,使用頁面頂端附近的篩選,依使用者、日期範圍、計算、持續時間、查詢狀態、語句類型和語句標識符來篩選清單。
針對 Databricks SQL 查詢,沒有至少 CAN MONITOR 許可權的非系統管理員使用者只能在查詢歷程記錄中檢視自己的查詢。
注意
具有 CAN RUN 許可權之使用者與另一位具有 CAN RUN 許可權的用戶共用的 Databricks SQL 查詢會出現在執行查詢的使用者查詢歷程記錄中,而不是共用查詢的使用者。
檢視查詢詳細數據
若要檢視查詢的詳細數據,例如完整的查詢語句、查詢來源、持續時間、傳回的數據列數目,以及 I/O 效能,或 執行詳細數據。
檢視 查詢記錄。
按一下查詢的名稱。
- 語句標識碼:這是與指定查詢對象相關聯的通用唯一標識碼 (UUID)。
- 查詢狀態:查詢已標記其目前狀態:已排入佇列、執行中、已完成、失敗或已取消。
- 計算類型:此欄位會顯示用於查詢的計算類型。
- 查詢語句:本節包含完整的查詢語句。 如果查詢太長而無法顯示在預覽中,請按兩下展開查詢圖示以查看全文檢索。
- 查詢來源:此欄位會顯示查詢的來源。 查詢可能來自各種來源,包括 AI/BI 儀錶板、查詢物件、Databricks SQL 編輯器、筆記本和 Delta Live Tables 管線(公開預覽)。
- 時鐘持續時間:顯示排程開始與查詢執行結束之間經過的時鐘時間。 總計會自動顯示為排程時間和運行時間的總和。 若要深入瞭解,每個欄位都可以展開為子類別。
- 摘要詳細數據:面板底部包含查詢效能的摘要詳細數據,包括匯總的工作時間、讀取和傳回的數據列、檔案和分割區,以及可能發生的任何溢出。
如需查詢效能的詳細資訊,包括其執行計劃,請按下頁面底部附近的 [ 檢視查詢配置檔 ]。 如需詳細資訊,請參閱 查詢配置檔。
終止執行中查詢
若要終止由您或其他使用者啟動的長時間執行的查詢:
檢視 查詢記錄。
按一下查詢的名稱。
按兩下 [ 狀態] 旁的 [ 取消]。
注意
只有在查詢執行時才會顯示取消 。
查詢已終止,且其狀態會變更為 Canceled。
注意
使用 Delta Live Tables 計算的語句只能從 Pipelines UI 取消。
存取查詢記錄系統數據表
Azure Databricks 系統數據表包含查詢記錄數據表 (system.query.history
),其中特殊許可權使用者可以檢視您帳戶中的表格式查詢記錄。 根據預設,只有系統管理員可以存取您帳戶的系統數據表。 如需啟用和存取查詢記錄系統數據表的資訊,請參閱 查詢記錄系統數據表參考。