查詢效能儀表板(預覽版)

Visual Studio Code MSSQL 擴充套件中的查詢效能儀表板,可協助您在不離開編輯器的情況下調查查詢效能。 它使用 查詢存放區 的資料來識別資源密集型查詢、探索執行歷史與等待統計、比較長期效能,並檢視執行計畫。

查詢存放區 可擷取資料庫的查詢文字、執行計畫及執行時統計資料。 儀表板會呈現這些歷史資料,讓您能從整個資料庫的概覽切換到個別查詢及其計畫。 可用的歷史紀錄取決於 查詢存放區 擷取並保留的資料。

Note

查詢效能儀表板目前處於公開預覽階段。

Prerequisites

  • 連接到資料庫,該資料庫支援 查詢存放區。
  • 在資料庫中啟用 查詢存放區,並允許其擷取工作負載資料。 有關設定說明,請參閱啟用 查詢存放區。
  • 使用具有讀取目標資料庫 查詢存放區 資料權限的帳戶。

如果 查詢存放區 關閉,請先啟用它,再檢查查詢效能。 如果 查詢存放區 是唯讀,您可以檢視現有資料,但不會擷取新的活動。 空白的時間範圍也可能表示 查詢存放區 在該期間內未擷取或保留資料。

打開儀表板

  1. 在 「連線 」檢視中,展開您的連線,並對您想要調查的資料庫按右鍵。
  2. 選擇 「開啟查詢效能儀表板(預覽)」。

資料庫內容選單的螢幕截圖,並標示「開啟查詢效能儀表板(預覽)」。

儀表板會開啟所選資料庫。 使用儀表板頂端的資料庫選擇器切換資料庫。

探索查詢概覽

概述列出所選資料庫及時間範圍的查詢。 選擇一個類別,以聚焦於工作負載的不同面向。

查詢概覽的螢幕截圖,選取「高 CPU」、「依 Rank by 」設為「總計」,以及過去 24 小時內依 CPU 時間排序的查詢。

分類 用它來尋找
高 CPU 佔用最多 CPU 時間的查詢。
高記憶體 記憶體授與最大的查詢。
Duration 執行時間最長的查詢。
最常見 執行次數最高的查詢。
高讀取次數 具有最多邏輯讀取次數的查詢。

對於資源與持續時間類別,請使用「依據排序」選擇「總計」、「平均」、「最大」、「最小」或「標準差」。 例如,依 總 排名以識別整體 CPU 消耗量最大的查詢,或依 平均 排名以尋找每次執行 CPU 成本較高的查詢。 最常見 依照執行次數來排序查詢,且不使用這個選擇器。

使用右上角的時間框架選擇器,選擇過去一小時、12 小時、24 小時、七天或 30 天,或設定自訂範圍。 預設為 過去 24 小時。 選擇 「重新整理」 以重新載入資料。 排名與執行次數會反映所選期間,且在總覽與查詢詳細資料之間切換時,時間範圍會持續被選取。

若要進一步聚焦清單,請在 搜尋查詢中輸入文字。 選取查詢旁的星號以將其標記為最愛,並啟用「僅最愛」以顯示您的最愛。

選擇一個 查詢 ID ,以開啟該查詢的詳細資訊。

調查查詢

查詢詳細頁面整合了查詢文字、摘要統計資料,以及四個分頁: 執行歷史、 等待、 比較與 計畫。 利用這些檢視來調查查詢何時變得昂貴、等待了什麼,以及是否與變更同時出現了不同的執行計畫。

查詢詳細資料的螢幕截圖,顯示執行次數、CPU 統計資料、執行歷史圖表與區間表,以及查詢文字面板。

摘要顯示所選指標的執行次數、平均值、最小值與最大值,以及最後執行時間。 查詢文字仍保留在標籤旁。 選擇「 在查詢編輯器中開啟 」以在編輯器中開啟 SQL,或選擇 「複製 SQL 」以複製它。

檢視執行歷史

使用 執行歷史 來探索查詢在所選時間範圍內的表現。

  1. 選擇 指標,例如持續時間、CPU 時間、邏輯讀取次數或記憶體授與。
  2. 使用「檢視依據」選擇「總計」、「平均」、「最大值」或「最小值」。
  3. 檢視圖表上的變化或高峰,並利用計畫指標查看在這些區間內執行了哪些計畫。
  4. 檢視間隔表中的執行次數、計畫 ID、持續時間、CPU 時間及邏輯讀取次數。

例如,將 CPU 總時間切換為平均 CPU 時間,以區分執行頻率的增加與每次執行的 CPU 成本增加。

檢視等待事件

選取 Waits 以了解查詢在哪些地方花時間等待。 檢視圖顯示所選期間的等待時間,並依等待類別細分,包含總等待時間及每次執行的平均等待時間。

將此檢視與執行歷史並用,以檢視延遲是否涉及資源消耗或等待,例如等待鎖定或輸入輸出。 只有當資料庫支援 查詢存放區 等待統計且啟用 wait-statistics 擷取時,等待統計資料才可用。

比較近期與基準表現

使用「比較」標籤來比較所選期間與較早基準之間的 CPU 時間或記憶體授與。 例如,比較過去 24 小時與前 30 天,以調查查詢典型資源使用的變化。

  1. 將儀表板時間範圍設為 過去 24 小時,或選擇其他期間進行調查。
  2. 開啟查詢並選擇「比較」。
  3. 選擇 CPU 或 記憶體。
  4. 使用 「檢視方式 」選擇 「每次執行平均」 或「 每日總計」。 第一項比較每次執行的成本;第二項比較不同長度期間的每日資源使用情況。
  5. 選擇基準線:相同長度的前一段時間、前 7 天或前 30 天。 基線結束於所選近期期間的起點,因此兩個期間不會重疊。
  6. 檢視最近的數值、基準值及百分比變化。 使用按方案分類的表格,查看個別方案如何影響差異。

比較取決於兩個期間是否都有可用的 查詢存放區 資料。 記憶體 指的是查詢記憶體授與,而非資料庫或伺服器的總記憶體使用量。

檢視並比較查詢計畫

選取「計畫」以檢視在 查詢存放區 中擷取的查詢執行計畫。 清單包含計畫 ID、執行次數、平均持續時間與 CPU 時間、最後執行時間,以及計畫強制狀態。 執行時統計資料反映所選時間範圍。

選擇一個計畫 ID 以開啟該執行計畫。 針對同一查詢比較不同方案:

  1. 勾選清單中兩個方案旁的核取方塊。
  2. 選擇 「比較計畫」 以開啟計畫比較檢視。
  3. 檢視計畫以調查查詢執行方式的差異。

你可以同時比較兩個執行計畫。 結合執行歷史與效能比較,以及計畫比較,來檢視計畫變更是否與較高的 CPU 時間、記憶體授權或持續時間相符。

在 Chat 中繼續調查

使用 Chat 繼續調查 GitHub Copilot Chat 中的查詢。 你可以在兩個地方找到它:

  • 在概覽中,開啟查詢列右側的動作選單(...),然後選擇 Chat。
  • 在查詢詳細資料頁面上,選擇右上角、查詢文字上方的 Chat。 當您在執行 歷史、等待、比較與 計畫之間切換時,此按鈕仍可使用。

查詢列動作選單的螢幕截圖,包含「複製」與「聊天」選項。

選擇「聊天」會以代理模式開啟 GitHub Copilot Chat,並傳送包含伺服器、資料庫、已儲存連線設定檔、查詢 ID 及所選時間範圍的提示。 提示明確引用 #mssql_query_store_analyze_query,該工具會擷取查詢統計、執行歷史、等待時間,以及主要計畫的摘要,以進行簡短的效能評估。 接著它會詢問你接下來想調查什麼,並要求在套用變更前獲得確認。

查詢存放區 診斷讀取不會要求確認或修改您的資料庫。 將執行計畫設為強制或取消強制是另一項需要檢閱及確認的作業。 例如提示詞與完整工作流程,請參閱使用 GitHub Copilot 調查 查詢存放區 效能。 若要設定 Copilot,請參閱 GitHub Copilot 的 MSSQL 擴充功能。

意見反應與支援

如果您有想法、反饋或想與社區互動,請加入討論 https://aka.ms/vscode-mssql-discussions。 若要回報錯誤,請造訪 https://aka.ms/vscode-mssql-bug。 若要要求新功能,請移至 https://aka.ms/vscode-mssql-feature-request。