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 擴充功能,以開啟資料庫代理程式或在伺服器儀表板上檢視結果。
在 Visual Studio Code 中,選取活動列中的 PostgreSQL 圖示以開啟連線。
在「伺服器」下,新增或連線您的 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器,並在系統提示時以您的 Azure 帳戶登入。
在連接的伺服器節點上按右鍵:
- 選擇 「資料庫代理程式」 以設定並管理伺服器的資料庫代理程式。
- 選擇 「儀表板」 以開啟伺服器儀表板並檢視進行中的調查與問題。
如果儀表板工具列顯示 已偵測到 Azure Server,請選擇 擷取中繼資料,以便擴充功能解析伺服器的 Azure 資源識別。 如果出現「不完整的 Azure 元資料」,請在橫幅上選取「擷取元資料」以完成租用戶識別。
檢視問題
您可以直接在 Visual Studio Code 中伺服器的 Dashboard 標籤中檢視和管理 PostgreSQL 資料庫代理程式的問題。
為您的伺服器開啟 儀表板 。 當資料庫代理程式正在調查或偵測到伺服器上的問題時,儀表板頂端會出現「 調查 」橫幅,顯示問題數量——選擇「 檢視 N 個問題中的第一個」 即可直接跳至發現內容。
展開問題以檢視其嚴重性、狀態(例如 DETECTED 或 DIAGNOSED)、偵測時間戳記及 AI 生成的分析:
- 建議動作 包括建議 變更(包含產生的 SQL 和 在編輯器中開啟 與 複製 控制項)、為何這樣做安全、回滾 SQL(同樣包含 在編輯器中開啟 與 複製 控制項)以及 檢視完整詳細資料。
- 預期結果 總結預期工作負載改善,並提供可摺疊的 回滾計畫。
- 問題底部的動作按鈕讓您可選擇「檢視行動」、「標記手動套用」或「駁回問題」。
若要使用 AI 探索問題區段,請選取標題旁的閃光圖示(詢問 Copilot about this section),例如 RECOMMENDED ACTION 或 EXPECTED OUTCOME。 GitHub Copilot 聊天開頭已預先載入結構化的問題詳細資訊,方便您提出後續問題,並檢視即時伺服器指標、會話或執行計畫。
回應問題
擷取的證據反映問題被診斷時伺服器的狀態,而 AI 產生的結果可能不完整或錯誤。 在進行變更前,請先將每項建議與實際伺服器對照進行驗證。
使用伺服器 儀表板(查詢、等待與 工作階段 標籤)或開啟查詢編輯器,確認偵測到的情況是否仍在線上伺服器上作用中(例如,在呼叫
pg_terminate_backend()前查詢pg_stat_activity和pg_locks)。對於 SQL 變更(例如建立索引或執行
ANALYZE),請在 RECOMMENDED ACTION 的 Recommended change SQL 區塊中,選擇 「在編輯器中開啟」 或 「複製」:- 在驗證查詢或索引變更時,請在
EXPLAIN中檢查 輸出。 - 檢視鎖定與資源影響(例如,保留
CREATE INDEX CONCURRENTLY以避免阻塞對作用中資料表的寫入),並備妥 Rollback SQL。 - 請透過您授權的資料庫工作流程手動執行核准的語句。
- 在驗證查詢或索引變更時,請在
如需伺服器參數建議(例如調整
work_mem或 autovacuum 設定),請在「連線>伺服器」下的伺服器上按一下滑鼠右鍵,然後選擇「伺服器管理>伺服器參數」。 如果靜態參數變更需要重新啟動,請在核准的維護時段使用 伺服器管理>重新啟動伺服器。重新檢查即時伺服器指標與查詢計畫,以確認工作負載已恢復。
回到儀表板上的問題,選擇 「標記為已手動套用 」以記錄您已完成修復,或若不需更改,則選擇 「忽略問題 」。 你仍然可以查閱已駁回議題的駁回詳細資料。
依資料庫引擎分類的 Surface 可用性
在預覽期間,Visual Studio Code 和 Fabric Database Hub 中的資料庫代理程式支援會因引擎而異:
| Engine | Visual Studio Code | Fabric 資料庫樞紐 |
|---|---|---|
| 適用於 PostgreSQL 的 Azure 資料庫 靈活伺服器 | 現已提供(有限預覽版),可透過 PostgreSQL 擴充功能(資料庫代理 與 儀表板)提供 | 即將推出資料庫代理程式(基準資產與計量監視功能可在 監視 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器中使用) |
| Azure SQL Database | 即將推出 | 現已於資料庫中心提供預覽版 |