Database Agents 協助應用程式擁有者與資料庫管理員偵測、調查並回應 Azure SQL Database for PostgreSQL 及 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器中支援的效能問題。
使用資料庫代理程式來:
- 偵測支援的資料庫效能狀況。
- 檢視議題摘要、證據與指引。
- 追蹤調查進度、問題結案及再次發生情況。
您在預覽期間於何處使用資料庫代理程式取決於資料庫引擎:
- Azure SQL Database:可在 Fabric Database Hub 中使用。 Visual Studio Code 支援即將推出。
- 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器:以 Visual Studio Code 有限預覽形式提供。 Fabric Database Hub 的支援即將推出。
資料庫代理程式會使用您現有的身分識別、Azure 資源權限以及資料庫權限。 它不會授予額外存取權,也不會繞過您現有的核准與變更管理要求。
Important
資料庫代理程式目前處於預覽階段。 它會調查支援的議題並提供指引。 您無法直接從問題套用資料庫變更。 所有情境都需要透過您授權的資料庫工作流程進行人工回應。
Note
適用於 PostgreSQL 的 Azure 資料庫 靈活伺服器的資料庫代理程式目前以有限預覽形式在 Visual Studio Code 中提供。 存取受限且需經批准。 若要申請存取權,請填寫 資料庫代理程式有限預覽參與表單。
資料庫代理程式的運作方式
資料庫代理程式為選定的資料庫與伺服器建立導引式操作工作流程:
- 偵測受支援的資料庫狀況。
- 調查 狀況並蒐集證據。
- 根據問題類型引導或建議下一步回應。
- 追蹤 調查進度,並追蹤問題狀態直到結案或再次發生為止。
所有事件都為手動回應提供指引。 現有的資料庫權限與操作控制仍持續適用。
資料庫代理如何運用 AI
資料庫代理程式可在無大型語言模型(LLM)的情況下偵測並調查 Azure SQL Database 問題。 這項核心調查不會消耗 Copilot 的容量。
對於高 CPU 且長期執行的查詢問題,你可以選擇使用 情境式 AI 協助 來探索證據。 情境式 AI 使用由管理員指派的 LLM 和 Copilot 容量。
每一次 適用於 PostgreSQL 的 Azure 資料庫 調查都是 AI 輔助的。 Database Agents 使用大型語言模型(LLM)診斷此狀況並建議手動回應。 AI 模型處理在美國資料區(美國中南部及美國西部 3 區)運行,歐盟資料區則在瑞典中部執行。
在有限預覽期間,您不需要為 PostgreSQL 資料庫代理程式的調查付費。 將在正式上市前開始收費,Microsoft 會在開始收費前提前通知已登記的客戶。
開始
在啟用資料庫代理程式之前,請先確認下列必要條件。
Prerequisites
- 使用具有存取您想監控 Azure SQL 資料庫權限的身份登入 Fabric。
- 使用支援的 Azure SQL 資料庫。
- 如果資料庫是無伺服器的,請確認它已喚醒,以便資料庫代理程式評估它。
- 確認資料庫位於與 Fabric 租戶主區域相關聯的支援區域。
- 在 「啟用 Microsoft SQL 效能監控」 中完成適用的 Azure SQL Database 設定。
- 確認您擁有資料庫讀取權限以檢視問題。
- 確認您在儲存代理程式時,對每個選取的 Azure 資料庫都擁有 Azure 角色基礎存取控制(Azure RBAC)寫入權限。
Important
適用於 PostgreSQL 的 Azure 資料庫 的資料庫代理目前處於有限預覽階段。 在啟用此功能之前,您必須 透過參與表單申請存取 並獲得批准。
- 安裝 Visual Studio Code 及 Visual Studio Code 的 PostgreSQL 擴充功能(版本 1.32.0 或更新版本)。 Fabric Database Hub 中對 PostgreSQL 資料庫代理程式的支援即將推出。
- 在支援的有限預覽區域(南中美國、西美 3 或瑞典中部)使用 PostgreSQL 16 或更新版本的 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器。
- 以具備存取 Azure 伺服器資源權限的身分登入 Visual Studio Code(包括在設定代理程式時對伺服器資源的 Azure RBAC 寫入權限),以及 PostgreSQL 認證以連接伺服器。
完整設定說明請參閱《啟用及啟動資料庫代理程式》或《在 Visual Studio Code 中使用資料庫代理程式》。
開啟 Database Agents
- Open Database Hub。
- 選擇 「管理代理程式」。
- 選擇「 資料庫代理程式設定」。
在資料庫代理程式設定中,您可以選擇 Azure SQL 資料庫、檢視其代理程式原則,並儲存設定。 Visual Studio Code 中對 Azure SQL Database 的支援即將推出。
在有限預覽期間,您可以透過 Visual Studio Code 存取 PostgreSQL 的資料庫代理程式(Fabric Database Hub 的支援即將推出):
- 開啟 Visual Studio Code,並在活動列中選取 PostgreSQL 圖示以開啟連線。
- 在「伺服器」下,右鍵按一下您已連接的 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器。
- 選擇「Database Agent」以設定代理程式,或選擇「Dashboard」以檢視進行中的調查與問題。
如需完整的 Visual Studio Code 工作流程,請參閱〈在 Visual Studio Code 中使用資料庫代理程式〉。
1. 偵測受支援的問題
資料庫代理程式會根據所儲存的代理程式原則評估所選定的資料庫與伺服器。
支援的 Azure SQL Database 問題情境包括:
- 高 CPU。
- 高記憶體使用量。
- I/O 偏高。
- 長時間執行的查詢。
- 阻塞查詢。
- 缺少索引。
- 刪除未使用或重複的索引。
- 查詢計畫迴歸。
支援的 適用於 PostgreSQL 的 Azure 資料庫 問題情境包括:
| Scenario | Conditions 資料庫代理進行調查 |
|---|---|
| 連線耗盡 | 角色連線限制與會話囤積。 |
| 死元組膨脹 | 死元組累積、僅堆積元組(HOT)更新劣化,以及頻繁更新導致的索引膨脹。 |
| CPU 使用率過高 | 索引類型不符、過時統計資料及未索引查詢。 |
| 交易中閒置 | 由閒置於交易中的工作階段保留快照。 |
| 鎖定爭用 | 列鎖與資料表鎖。 |
| 查詢計畫迴歸 | 收集瓶頸、合併類型錯選、有損點陣圖重新檢查,以及已刪除的支援索引。 |
| 排序溢出與記憶體壓力 | 來自完整聚合、雜湊連接、大型排序及平行查詢的溢出。 |
啟用資料庫、伺服器或情境時,產生新問題大約需要 15 分鐘。 問題的建立可以更快完成。
另外,啟用效能監控可能需要約 15 分鐘才能傳達至資料庫清單與設定,之後才能註冊資料庫。 資料庫代理程式無法在資料庫註冊前偵測或產生相關問題。
2. 審查調查結果與證據
開啟問題單以了解偵測到的狀況並決定下一步該怎麼做。 根據問題類型及其當前狀態,資料庫代理程式可以提供:
- 狀況摘要。
- 擷取的證據。
- 推薦。
- 手動回應的指引。
- 目前的問題、狀態與歷史。
捕捉到的證據描述了偵測時的狀況。 在採取行動前,請先檢視目前的狀態與可用證據。
對於高 CPU 和長期查詢問題,情境式 AI 協助會運用額外技能來協助你探索證據。 建議動作中的提示按鈕會開啟 Copilot 窗格,並以問題作為上下文;「解釋為什麼」會以內嵌方式顯示說明;而「分析慢查詢」則會針對擷取的查詢提供內嵌建議。 此協助使用您的管理員指派的 Copilot 容量,且不套用資料庫變更。
關於這些可選的調查步驟,請參閱 「使用情境式 AI 進行調查」。
由於 PostgreSQL 調查是 AI 輔助的,摘要、分析、 建議行動 (包括 建議變更、 為何安全,以及 回滾 SQL)以及 預期結果 皆由 LLM 產生。 在 Visual Studio Code 的伺服器儀表板中,您也可以選擇「詢問 Copilot about this section」,以在 GitHub Copilot Chat 中探索某個問題。 在採取行動之前,請將診斷以及任何建議的 SQL 語句或伺服器參數變更與實際運作的伺服器對照進行驗證。
如需詳細檢視指引,請參閱 「檢視資料庫代理程式效能問題」。
3. 決定如何回應
建議的手動回應方式取決於問題情境。 資料庫代理程式不執行回應。
遵循指引並手動回應
所有問題都提供調查結果及手動修復的指引。
檢視證據與指引,重新檢查當前狀況,並透過您授權的資料庫工作流程完成適當的回應。 回應後確認目前狀態。 如果完成後問題仍為開啟狀態,請關閉它。
有關回應與驗證指引,請參閱 檢視資料庫代理程式效能問題。
4. 追蹤問題狀態
資料庫代理程式會在調查狀況或判斷該狀況不再需要關注時,更新問題狀態。
在 Database Hub 中,問題狀態如下:
- 作用中: 此狀況需要關注。
- 調查中:資料庫代理程式正在蒐集或分析證據。
- 調查完成: 可取得指引。 請手動執行應變。
- 失敗: 調查未能成功完成。
- 已關閉: 該議題已不再處於活動狀態,仍可查閱歷史紀錄。
在 Visual Studio Code 伺服器儀表板上,資料庫代理程式會在調查橫幅中顯示進行中的調查進度,並追蹤每個問題從偵測到診斷到解決——例如當您選擇「標記手動套用」完成變更後,或在不需要採取行動時選擇「關閉問題」。
調查失敗並不代表資料庫或伺服器變更失敗。 資料庫代理程式不會在未經您操作的情況下自動執行資料庫或伺服器變更。
對於可重試的錯誤,調查會自動重試最多三次。 當調查達到 失敗 或 調查完成時,重新整理或重新開啟問題不會重新生成遺失的細節。 確認資料庫或伺服器的讀取權限,若缺少調查細節,請聯絡 Microsoft 支援服務。
5. 檢視問題歷史與再次發生
問題可在您完成手動回應後關閉,或監控確認條件已清除後關閉。 無論哪種情況,最終狀態都是「已關閉」。 檢視問題歷史以及即時資料庫或伺服器狀況,以了解結果。 關閉事件本身並不代表工作負載已經恢復。
如果某個條件在問題關閉後再次出現,資料庫代理程式會建立一個新問題,並將該已關閉的問題保留在歷史中。
負責任地使用資料庫代理程式
Database Agent 的發現與建議需要進行操作員審查。
資料庫代理程式不會取代:
- 資料庫認證與授權。
- 現有的核准流程。
- 變更管理需求。
- 生產驗證。
- 對資料庫變更的人為責任。
支援的資料庫與伺服器
資料庫代理程式支援 Azure SQL 資料庫,包括無伺服器及超大規模資料庫。
目前,資料庫代理程式不支援:
- Azure SQL elastic pools.
- One-vCore 無伺服器資料庫。
- Azure SQL 受控執行個體.
- Azure 虛擬機器上的 SQL Server.
- SQL Server 由 Azure Arc 啟用。
資料庫代理程式支援執行 PostgreSQL 16 或更新版本的 適用於 PostgreSQL 的 Azure 資料庫 靈活伺服器,涵蓋彈性伺服器運算層級(包括 Burstable、General Purpose 及 Memory Optimized)及部署配置。 Azure HorizonDB 支援即將推出。
PostgreSQL 支援目前僅以有限預覽形式在 Visual Studio Code 中提供,而 Fabric Database Hub 的支援也即將推出。 存取受限且需經批准。 若要申請存取權,請填寫 資料庫代理程式有限預覽參與表單。
公開預覽的限制
- Surface 可用性:Fabric Database Hub 目前支援 Azure SQL Database;Visual Studio Code 支援即將推出。
- 區域可用性:資料庫必須位於與 Fabric 租戶主區域相關聯的支援區域。 不支援跨區域註冊。
- Surface 可用性:PostgreSQL 資料庫代理程式目前僅以有限預覽形式在 Visual Studio Code 中提供。 Fabric Database Hub 的支援即將推出。
- 有限的預覽區域與資料區域: PostgreSQL 支援最初支援 美國中南部、 美國西部 3 區及 瑞典中部的伺服器,美國 資料區 與 歐盟資料區則支援 AI 處理。
- 問題可用性: 新啟用的資料庫、伺服器或情境大約需要 15 分鐘才能產生新問題。
- 手動回應: 透過您授權的資料庫工作流程檢視建議並執行變更。
- 預覽行為: 在預覽期間,支援的問題、設定與區域可能會有所變動。
完整清單與復原步驟請參閱 資料庫代理程式限制與疑難排解。
Troubleshoot
資料庫或伺服器未出現
確認資料庫是否受支援、位於支援的區域,且對您的身分可見。 如果資料庫是無伺服器的,請確認它已喚醒。 確認 Microsoft SQL 的效能監控已啟用,並預留約 15 分鐘讓啟用功能傳遞至資料庫清單與設定。 如果資料庫仍未顯示,請聯絡 Microsoft 支援服務。
確認您已獲得有限預覽版的核准,已安裝 Visual Studio Code 的 PostgreSQL 擴充功能(版本 1.32.0 或更新),且彈性伺服器執行 PostgreSQL 16 或更新版本,正在執行(未停止),位於受支援的有限預覽區域(美國中南部、美國西部 3 或瑞典中部),且伺服器儀表板已載入 Azure 中繼資料(擷取中繼資料)。 請注意,PostgreSQL 資料庫代理程式尚未在 Fabric 資料庫中心中提供(即將推出)。 如果伺服器或代理程式仍未在 Visual Studio Code 中出現,請聯絡 Microsoft 支援服務。
代理程式設定無法儲存
儲存會驗證代理程式以及您對每個選取資料庫或伺服器的 Azure 資源寫入權限。 如果任一選取的資料庫或伺服器在權限檢查中失敗,整個儲存都會失敗。 從選取中移除您未取得權限的資源,並儲存剩餘的設定。 關於其他錯誤或持續失敗,請參閱「代理程式無法儲存或未變為使用中」。
沒有出現新問題
請至少等待 15 分鐘,確認來源條件仍然有效,確認對應的代理程式政策選項已啟用,然後重新整理問題清單。
無法載入資料庫或伺服器清單
確認您的識別身分能讀取已為租戶儲存的資源。 請使用能存取已設定資源的身份重新嘗試。
資料庫代理程式在區域服務中斷後不會恢復
您不需要重新設定或重新啟用資料庫代理程式。 服務恢復後,重新整理 Database Hub 或 Visual Studio Code 並重試此操作。 如果資料庫代理程式未恢復,請聯絡 Microsoft 支援服務。