共用方式為


使用查詢活動監視執行中的和已完成的 T-SQL 查詢

適用於:✅ Microsoft Fabric 中的 SQL 分析端點和倉儲

監視 SQL 查詢對於監視 Fabric 倉儲的效能並進行疑難排解,以及維護倉儲效率而言至關重要。 使用查詢活動時,您不需要執行任何 T-SQL 程式碼,就能獲得所有執行中的和歷程記錄 T-SQL 查詢,以及長時間執行和經常執行之查詢清單的一站式檢視。 您可以使用查詢活動,確保查詢所花費的時間不會超過預期的執行時間,而且查詢正在順利完成。

必要條件

  • 您必須是工作區中的系統管理員,才能存取查詢活動。 成員、參與者、檢視人員沒有存取此檢視的權限。

開始使用

有兩種方式可以啟動查詢活動體驗。

  • 選取您要在工作區檢視內監視的倉儲旁的 [更多選項 (...)],然後選取 [查詢活動]

    螢幕擷取畫面:工作區特色選單中的 [查詢活動] 進入點。

  • 在您要監視的倉儲的查詢編輯器中,選取功能區中的 [查詢活動]。

    螢幕擷取畫面:功能區中的 [查詢活動] 進入點。

查詢執行

在 [查詢執行] 頁面上,您最多可以看到過去 30 天內正在執行、成功、取消和失敗的查詢清單。

  • 使用下拉式清單以篩選狀態、提交者或提交時間。
  • 使用搜尋列以篩選查詢文字或其他資料行中的特定關鍵字。

針對每個查詢,會提供下列詳細資料:

資料行名稱 描述
分散式陳述式 Id 每個查詢的唯一 ID
查詢文字 所執行的查詢的文字(最多 8,000 個字元)
提交時間 (UTC) 要求送達時的時間戳
期間 執行查詢所花費的時間
狀態 查詢狀態(執行中、成功、失敗或已取消)
[傳送者] 傳送查詢的使用者或系統的名稱
工作階段識別碼 將查詢連結至特定使用者工作階段的 ID
執行來源 起始工作階段的用戶端程式的名稱

當您想要重新載入頁面上顯示的查詢時,請選取功能區中的 [重新整理] 按鈕。 如果您看到一個正在執行的查詢並且想要立即停止執行,請使用核取方塊選取該查詢,然後選取 [取消] 按鈕。 在取消查詢之前,系統會透過一個對話方塊提示您確認取消。 您選取之相同 SQL 工作階段的任何未選取查詢也會被取消。

螢幕擷取畫面:[查詢執行取消] 對話方塊。

您也可以使用動態管理檢視找到關於執行查詢的相同資訊。

查詢深入解析

在 [查詢深入解析] 頁面上,您可以看到長時間執行和經常執行之查詢的清單,以協助判斷倉儲查詢內的任何趨勢。

針對 [長時間執行的查詢] 深入解析中的每個查詢,會提供下列詳細資料:

資料行名稱 描述
查詢文字 所執行的查詢的文字(最多 8,000 個字元)
執行期間中位值 跨執行的查詢執行時間中位值(毫秒)
執行計數 查詢被執行的總次數
上次執行期間 上次執行所花費的時間(毫秒)
上次執行的分散式陳述式 ID 上次查詢執行的唯一 ID
上次執行的工作階段 ID 上次執行的工作階段 ID

針對 [經常執行的查詢] 深入解析中的每個查詢,會提供下列詳細資料:

資料行名稱 描述
查詢文字 所執行的查詢的文字(最多 8,000 個字元)
平均執行期間 跨執行的查詢執行時間平均值(毫秒)
持續時間上限 最長的查詢執行時間(毫秒)
持續時間下限 最短的查詢執行時間(毫秒)
上次執行的分散式陳述式 ID 上次查詢執行的唯一 ID
執行計數 查詢被執行的總次數
成功執行的計數 成功的查詢執行數量
失敗的執行計數 失敗的查詢執行數量
已取消的執行計數 已取消的查詢執行數量

也可以在 Fabric 資料倉儲中的查詢深入解析中找到有關查詢執行中已完成、失敗和已取消查詢的相同資訊,以及彙總的深入解析。

限制

  • 根據執行的並行工作負載而定,歷程記錄查詢最多可能需要 15 分鐘才會出現在查詢活動中。
  • 對於指定的篩選選取範圍,只有前 10,000 個資料列可以顯示在 [查詢執行] 和 [查詢深入解析] 索引標籤中。
  • 如果建立新的倉儲之後立即開啟查詢活動,由於基礎系統檢視尚未產生,可能會發生「無效的物件名稱 queryinsights.exec_requests_history」錯誤。 因應措施是等候兩分鐘,然後重新整理頁面。