在 Visual Studio Code 中使用資料庫代理程式

Database Agents 可與 Visual Studio Code 整合,讓您能設定代理程式、檢視 AI 輔助的效能調查、檢視即時伺服器狀態,並在不離開編輯器的情況下執行手動回應。

Important

適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器的資料庫代理程式目前以有限預覽形式在 Visual Studio Code 中提供。 存取受限且需經批准。 若要申請存取權,請填寫 Database Agents 有限預覽參與表單。

在採取行動之前,先驗證 AI 生成的診斷、SQL 陳述式與參數變更,並遵循組織的核准與變更管理流程。

Note

  • 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器:現已於 Visual Studio Code 中以有限預覽形式提供。 Fabric Database Hub 中對 PostgreSQL 資料庫代理程式的支援即將推出。
  • Azure SQL Database:即將支援 Visual Studio Code。 今天,請使用 Database Hub 用於 Azure SQL Database。

Prerequisites

Important

適用於 PostgreSQL 的 Azure 資料庫 的資料庫代理目前處於有限預覽階段。 在啟用此功能之前,您必須 透過參與表單申請存取 並獲得批准。

  • 在支援的有限預覽區域(South Central US、West US 3 或 Sweden Central)使用執行中的 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器,版本為 PostgreSQL 16 或更新版本。
  • 安裝 Visual Studio Code(建議使用 1.102.0 或更新版本於模型上下文協定(MCP)代理工具)。
  • 安裝 Visual Studio Code 的 PostgreSQL 擴充功能(版本 1.32.0 或更新版本)。
  • 以具備存取 Azure 伺服器資源權限的 Microsoft Entra 身分登入(包括在設定資料庫代理程式時,需具有 Azure 伺服器資源的 Azure RBAC 寫入權限),並具備用於連線及執行查詢的 PostgreSQL 認證和網路存取權限。
  • (選用)在 Visual Studio Code 中安裝 GitHub Copilot,以便使用 詢問 Copilot 來了解本節及代理模式工具。

為您的伺服器開啟資料庫代理程式

將您的 適用於 PostgreSQL 的 Azure 資料庫 靈活伺服器連接至 PostgreSQL 擴充功能,以開啟資料庫代理程式或在伺服器儀表板上檢視結果。

  1. 在 Visual Studio Code 中,選取活動列中的 PostgreSQL 圖示以開啟連線。

  2. 在「伺服器」下,新增或連線您的 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器,並在系統提示時以您的 Azure 帳戶登入。

  3. 在連接的伺服器節點上按右鍵:

    • 選擇 「資料庫代理程式」 以設定並管理伺服器的資料庫代理程式。
    • 選擇 「儀表板」 以開啟伺服器儀表板並檢視進行中的調查與問題。

    Visual Studio Code 中 PostgreSQL 連線樹狀結構的螢幕螢幕,顯示包含儀表板與資料庫代理程式的伺服器右鍵選單。

  4. 如果儀表板工具列顯示 已偵測到 Azure Server,請選擇 擷取中繼資料,以便擴充功能解析伺服器的 Azure 資源識別。 如果出現「不完整的 Azure 元資料」,請在橫幅上選取「擷取元資料」以完成租用戶識別。

檢視問題

您可以直接在 Visual Studio Code 中伺服器的 Dashboard 標籤中檢視和管理 PostgreSQL 資料庫代理程式的問題。

  1. 為您的伺服器開啟 儀表板 。 當資料庫代理程式正在調查或偵測到伺服器上的問題時,儀表板頂端會出現「 調查 」橫幅,顯示問題數量——選擇「 檢視 N 個問題中的第一個」 即可直接跳至發現內容。

  2. 展開問題以檢視其嚴重性、狀態(例如 DETECTED 或 DIAGNOSED)、偵測時間戳記及 AI 生成的分析:

    • 建議動作 包括建議 變更(包含產生的 SQL 和 在編輯器中開啟 與 複製 控制項)、為何這樣做安全、回滾 SQL(同樣包含 在編輯器中開啟 與 複製 控制項)以及 檢視完整詳細資料。
    • 預期結果 總結預期工作負載改善,並提供可摺疊的 回滾計畫。
    • 問題底部的動作按鈕讓您可選擇「檢視行動」、「標記手動套用」或「駁回問題」。

    Visual Studio Code 伺服器儀表板上 PostgreSQL 資料庫代理程式問題的螢幕擷圖,顯示調查橫幅、建議行動、為何安全、回滾 SQL、預期結果及問題處理按鈕。

  3. 若要使用 AI 探索問題區段,請選取標題旁的閃光圖示(詢問 Copilot about this section),例如 RECOMMENDED ACTION 或 EXPECTED OUTCOME。 GitHub Copilot 聊天開頭已預先載入結構化的問題詳細資訊,方便您提出後續問題,並檢視即時伺服器指標、會話或執行計畫。

    截圖顯示,在 PostgreSQL 資料庫代理程式問題的建議行動旁選擇「詢問 詢問 Copilot 關於此區段」,並預先載入問題詳細資訊並開啟 GitHub Copilot Chat。

回應問題

擷取的證據反映問題被診斷時伺服器的狀態,而 AI 產生的結果可能不完整或錯誤。 在進行變更前,請先將每項建議與實際伺服器對照進行驗證。

  1. 使用伺服器 儀表板(查詢、等待與 工作階段 標籤)或開啟查詢編輯器,確認偵測到的情況是否仍在線上伺服器上作用中(例如,在呼叫 pg_terminate_backend() 前查詢 pg_stat_activity 和 pg_locks)。

  2. 對於 SQL 變更(例如建立索引或執行 ANALYZE),請在 RECOMMENDED ACTION 的 Recommended change SQL 區塊中,選擇 「在編輯器中開啟」 或 「複製」:

    • 在驗證查詢或索引變更時,請在 EXPLAIN 中檢查 輸出。
    • 檢視鎖定與資源影響(例如,保留 CREATE INDEX CONCURRENTLY 以避免阻塞對作用中資料表的寫入),並備妥 Rollback SQL。
    • 請透過您授權的資料庫工作流程手動執行核准的語句。
  3. 如需伺服器參數建議(例如調整 work_mem 或 autovacuum 設定),請在「連線>伺服器」下的伺服器上按一下滑鼠右鍵,然後選擇「伺服器管理>伺服器參數」。 如果靜態參數變更需要重新啟動,請在核准的維護時段使用 伺服器管理>重新啟動伺服器。

    Visual Studio Code 中 PostgreSQL 伺服器內容選單的螢幕截圖,標示伺服器管理與伺服器參數。

  4. 重新檢查即時伺服器指標與查詢計畫,以確認工作負載已恢復。

  5. 回到儀表板上的問題,選擇 「標記為已手動套用 」以記錄您已完成修復,或若不需更改,則選擇 「忽略問題 」。 你仍然可以查閱已駁回議題的駁回詳細資料。

依資料庫引擎分類的 Surface 可用性

在預覽期間,Visual Studio Code 和 Fabric Database Hub 中的資料庫代理程式支援會因引擎而異:

Engine Visual Studio Code Fabric 資料庫樞紐
適用於 PostgreSQL 的 Azure 資料庫 靈活伺服器 現已提供(有限預覽版),可透過 PostgreSQL 擴充功能(資料庫代理 與 儀表板)提供 即將推出資料庫代理程式(基準資產與計量監視功能可在 監視 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器中使用)
Azure SQL Database 即將推出 現已於資料庫中心提供預覽版