監視 T-SQL 查詢(預覽)

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

Important

這項功能目前處於預覽階段。

使用監視器查看倉庫正在執行及歷史上的 T-SQL 查詢、長期查詢,以及經常執行查詢而無需執行 T-SQL 程式碼。 整合進 Fabric 入口網站後,你可以使用 Monitor 確認查詢是否成功完成、分析執行模式,並詳細調查較慢的查詢執行。

Monitor 先前名為「查詢活動」。

先決條件

  • 你必須是工作區的管理員才能存取監視器。 會員、貢獻者及觀看者均無權限存取此檢視。

開始

從工作區、查詢編輯器或 Microsoft Fabric 容量指標應用程式啟動監控體驗。

  • 在工作區檢視中選擇你想監控的倉庫旁的 「更多選項」(...), 然後選擇 「監控」。

    工作區上下文選單中監控進入點的截圖。

  • 在你想監控的倉庫查詢編輯器中,選擇功能區中的 「監控 」。

    從功能區截圖顯示的監視器入口點。

從容量指標應用程式開啟監視器

在 Microsoft Fabric 容量指標應用程式中使用 倉庫中的 Monitor 來調查與容量使用相關的查詢活動。 監視器會根據所選操作或項目細節內容,以時間範圍開啟相關項目。

你需要存取容量指標應用程式,以及所選項目工作區的 Admin 角色。 僅僅存取 Capacity Metrics 應用程式並不代表能存取 Monitor。

  1. 打開針對你想調查的容量使用情況的時間點頁面。
  2. 在背景操作表中,選擇支援的查詢操作。 倉庫中的監視器 按鈕會啟用。
  3. 選取倉庫中的監控以開啟相關商品的監控。
  4. 檢視所選的時間範圍並調查查詢活動。 使用查詢文字、狀態、提交者、執行方式和時長來縮小調查範圍。

如果你從 時間點項目詳細頁面開始,不需要先選擇紀錄。 若要進行支援的查詢操作,請選擇 Monitor in warehouse,以相關時間範圍開啟相關項目。 如果你想縮小範圍到該操作,先選擇一個紀錄。

支援下列作業:

  • 資料倉儲查詢 - 資料倉儲中的 T-SQL 語句。
  • 倉庫查詢(加速) - 已啟用工作區查詢加速的倉庫中的 T-SQL 語句。
  • SQL 端點查詢 - 湖屋 SQL 分析端點中的 T-SQL 語句。
  • SQL 端點查詢(加速版) - 在已啟用工作區查詢加速的湖屋 SQL 分析端點中執行的 T-SQL 陳述式。
  • 倉庫快照查詢 - 倉庫快照上的 T-SQL 語句。

有關操作定義,請參見 Data Warehouse 作業。

Important

導覽提供項目與時間上下文,而非直接查詢單一 SQL 陳述式。 容量指標 營運識別碼 與查詢洞察 distributed_statement_id 是不同的識別碼。 將項目與重疊的執行時間建立關聯,然後檢查候選查詢。

某個時間點的容量使用率可包含先前作業的平滑化消耗。 所選容量時間點與操作執行間隔不一定相同。 請使用傳送給 Monitor 的操作上下文,而非假設每個貢獻查詢都在顯示的容量時間點內執行。

從容量指標疑難排解導覽

徵兆 Action
這個按鈕在時間點頁面上看不到 確認所選時間點的背景作業是否包含倉庫物品。 請查看 timepoint 頁面指引中支援的操作。
時間點頁面上的按鈕是被禁用的 在背景操作表中選擇支援的查詢操作。
這個按鈕在 Timepoint 項目詳細資料頁面上看不到 確認你已經執行了支援的查詢操作的向下鑽研。
監視器無法開啟是因為存取被拒絕 請請工作區管理員確認你是否擁有所選項目的工作區管理員角色。
預期的查詢是看不到的 請確認商品及時間範圍。 檢視 Monitor 的限制,如果歷史查詢紀錄還沒出現,請重新整理。

查詢歷程記錄

在 查詢歷史 頁面,您可以檢視最近的查詢執行,並識別倉庫活動的模式。 此視圖結合請求數量圖表與詳細結果網格,讓您能從高層趨勢轉向特定查詢執行。

  • 利用請求數量表來發現選定時間段內活動的高峰。
  • 使用篩選選單,依提交時間(UTC)、狀態、提交者、執行來源、陳述類型及標籤來細化檢視。
  • 使用搜尋欄找到查詢文字或其他欄位中的特定關鍵字。
  • 使用時間篩選器快速切換過去 24 小時、過去 7 天、過去 30 天,或自訂時間範圍。
  • 檢視活性過濾器,作為圖表上方可移除的藥丸。 當你套用或移除篩選器時,Monitor 會更新圖表和查詢網格,使其與目前的篩選器組相符。
  • 選擇 重新整理 以重新載入目前的結果。 如果你看到想要停止的查詢,請透過勾選方塊選取該查詢,然後選擇 取消。 在查詢被取消前,系統會提示你確認。 任何未被選取且屬於你所選相同 SQL 會話的查詢也會被取消。

Note

目前,監控體驗中套用的濾波器可能無法在圖表與資料網格間同步。 要查看一致的結果,請使用刷新選項重新載入資料。

查詢歷史取消對話框的截圖。

  • 當你選擇一個或多個具有相同查詢雜湊值的查詢執行程序時,檢視相似執行 變可用。 使用此選項比較相同查詢模式的執行情況,了解不同執行期間、失敗或資源使用是否有所變化。

查詢歷史截圖,查看類似的運行。

圖表會更新以反映當前篩選條件,方便回答以下問題:

  • 查詢量何時增加?
  • 哪個提交者或運行來源與活動激增相關?
  • 失敗或取消的查詢是否集中在特定時間段內?

你也可以從欄位選單自訂表格的配置:

  • 選擇出現在資料網格中的欄位。
  • 在欄位選單中拖曳項目以重新排序。
  • 選擇 套用 以更新網格以匹配所選欄位順序。

對於每個查詢,以下細節可在 查詢歷史 網格中取得。 有些欄位預設是隱藏的,可以透過 欄位選項新增。

欄位名稱 Description
分散式陳述式 Id 每個查詢的唯一 ID
查詢文字 執行查詢的文字
查詢雜湊 查詢形狀的哈希值,幫助你識別不同執行次數中相似的查詢邏輯。
現況 查詢狀態:成功、失敗或取消
提交者 傳送查詢的使用者或系統的名稱
提交時間 (UTC) 接收到要求時的時間戳
期間 完成查詢所需的總時間
執行原始碼 起始工作階段的用戶端程式的名稱
CPU 時間 為查詢執行所分配的總 CPU 時間
遠端掃描資料 OneLake 從遠端儲存讀取的資料量
磁碟掃描資料 從本地磁碟讀取的資料量
快取中掃描的資料 從本地記憶體快取讀取的資料量
工作階段識別碼 將查詢連結至特定使用者會話的 ID
標籤 查詢時可選標籤,當標籤被提供時
陳述式類型 執行的 SQL 陳述式類型,例如 SELECT、INSERT、UPDATE 或 DELETE
行數 查詢結果返回的行數
批次識別碼 ID 用於一組群組查詢(如適用)
連線識別碼 查詢所使用的連線識別碼
資料庫名稱 執行時連接的倉庫名稱或 SQL 分析端點名稱
結束時間 查詢完成執行的時間戳記
分布式 表示查詢是否以分散式操作方式執行:1 表示是,0 表示 NO
結果快取命中 查詢的結果集快取狀態:2 代表快取命中,1 代表快取已建立,0 代表未套用結果集快取
根批次識別碼 當查詢屬於巢狀批次時,頂層批次的識別碼
SQL 集區名稱 用於執行請求的 SQL 池名稱
錯誤碼 當查詢執行失敗時回傳錯誤代碼

關於執行查詢的相同資訊,也可以透過 動態管理檢視 與 查詢洞察檢視(Query insights views)找到,例如 queryinsights.exec_requests_history。

查詢見解

其他 Monitor 分頁幫助你從歷史進入摘要分析:

  • 長時間執行的查詢 能幫助你辨識執行時間持續較高的查詢。
  • 頻繁執行的查詢 能幫助你找出重複出現的查詢模式,這些模式可能從調整中受益。

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

欄位名稱 Description
查詢文字 執行查詢的文字
執行期間中位值 跨執行的查詢執行時間中位值(毫秒)
執行計數 查詢被執行的總次數
上次執行期間 上次執行所花費的時間(毫秒)
上次執行的分散式陳述式 ID 上次查詢執行的唯一 ID
上次執行的工作階段 ID 上次執行的工作階段 ID

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

欄位名稱 Description
查詢文字 執行查詢的文字
平均執行期間 跨執行的查詢執行時間平均值(毫秒)
持續時間上限 最長的查詢執行時間(毫秒)
持續時間下限 最短的查詢執行時間(毫秒)
上次執行的分散式陳述式 ID 上次查詢執行的唯一 ID
執行計數 查詢被執行的總次數
成功的運行次數 成功的查詢執行數量
失敗次數 失敗的查詢執行數量
已取消的執行次數 已取消的查詢執行數量

為了最大化這些觀點的價值:

  • 從 查詢歷史 開始,找出你想調查的時間範圍、提交者或執行來源。
  • 使用 檢視類似的執行結果來比較具有相同查詢雜湊值的執行結果。
  • 切換至長時間運行的查詢,以識別中位數時間較高的查詢模式。
  • 檢視 經常執行查詢,找出適合優化的高頻查詢模式。

查詢歷史中關於已完成、失敗及取消查詢的相同資訊,以及彙整的洞察,也可以在 Fabric Data Warehouse 的查詢洞察中找到。

Limitations

  • 根據同時工作負載,歷史查詢可能需 15 分鐘才能在 Monitor 中顯示。
  • 監視器只顯示目前篩選器選擇的前 10,000 列。 要減少結果集,可以縮小時間範圍或增加濾波器。
  • 如果你在建立新倉庫後立刻開啟 Monitor,可能會看到錯誤 Invalid object name queryinsights.exec_requests_history 。 此錯誤發生是因為底層系統視圖尚未產生。 作為一個變通方法,等兩分鐘,然後重新整理頁面。