適用於：✅ Microsoft Fabric 中的 SQL 分析端點與資料倉儲
Important
這項功能目前處於預覽階段。
使用監視器查看倉庫正在執行及歷史上的 T-SQL 查詢、長期查詢，以及經常執行查詢而無需執行 T-SQL 程式碼。 整合進 Fabric 入口網站後，你可以使用 Monitor 確認查詢是否成功完成、分析執行模式，並詳細調查較慢的查詢執行。
Monitor 先前名為「查詢活動」。
先決條件
- 你必須是工作區的管理員才能存取監視器。 會員、貢獻者及觀看者均無權限存取此檢視。
開始
你可以用兩種方式啟動 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。 此錯誤發生是因為底層系統視圖尚未產生。 作為一個變通方法，等兩分鐘，然後重新整理頁面。