本文適用於需要啟用 Database Agents,並為選取的 Azure SQL 資料庫或 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器加以啟用的資料庫管理員。
Important
資料庫代理程式目前處於預覽階段。 使用支援的資料庫與伺服器範圍,並在啟用其用於生產工作負載前,先檢視貴組織的營運需求。
Note
適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器的資料庫代理程式目前僅以有限預覽形式在 Visual Studio Code 中提供。 存取受限且需經批准。 若要申請存取權,請填寫 資料庫代理程式有限預覽參與表單。 Fabric Database Hub 中對 PostgreSQL 資料庫代理程式的支援即將推出。
Prerequisites
- 使用支援的 Azure SQL 資料庫,包括支援的無伺服器或超大規模資料庫。 不支援 One-vCore 無伺服器資料庫。
- 使用具備資料庫存取權限的身份登入 Fabric。
- 確認資料庫位於與 Fabric 租戶主區相關聯的支援區域。
- 在「啟用 Microsoft SQL 效能監控」中完成相關設定。 請依照 Azure SQL Database 的說明操作。 如果資料庫是無伺服器,請確認其處於喚醒狀態。
- 儲存代理程式時,對於您所選取的每個資料庫,您都必須對 Azure 資源具有 Azure 角色型存取控制 (Azure RBAC) 寫入權限。 此權限與執行 SQL 變更的權限不同。
Important
適用於 PostgreSQL 的 Azure 資料庫 的資料庫代理目前處於有限預覽階段。 在啟用此功能之前,您必須 透過參與表單申請存取 並獲得批准。
- 安裝 Visual Studio Code 及 Visual Studio Code 的 PostgreSQL 擴充功能(版本 1.32.0 或更新版本)。
- 在支援的有限預覽區域(南中美國、西美國 3 或瑞典中部)使用 PostgreSQL 16 或更新版本(包括 Burstable、一般用途或記憶體優化計算層級)上執行的 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器。
- 以具備存取 Azure 伺服器資源權限的身分登入 Visual Studio Code(包括在設定代理程式時對伺服器資源具有 Azure RBAC 寫入權限),並具備用於連線至伺服器的 PostgreSQL 認證。
Note
每項 PostgreSQL 調查皆由 AI 輔助,AI 模型處理分別在 美國資料區(美國中南部和 美國西部 3)及 歐盟資料區(瑞典中部)。 在有限預覽期間,你不需要為調查付費。 將在正式推出前開始收費,Microsoft 會在開始收費前提前通知已登記的客戶。
啟用並啟動資料庫代理程式
首先,在 Fabric Database Hub 中啟用資料庫代理程式:
- 開啟 Fabric 資料庫中心。
- 在左上角選擇 「管理代理程式」。
- 選擇「 資料庫代理程式設定」。
- 將 啟用 設為開啟。
- 選取 [儲存]。
此步驟啟用資料庫代理程式,但不會為任何資料庫啟用資料庫代理程式。
啟用效能監控後,請等待約 15 分鐘,等待資料庫清單與設定更新。 在這些資訊尚未取得之前,您無法加入資料庫。 問題偵測不會在登錄前開始。
選擇一個或多個您希望資料庫代理監控的資料庫。
開啟所選資料庫的代理程式原則。
在 「啟用」下,選擇資料庫代理程式提供調查與指引的動作類別或個別動作:
動作類別 行動 阻塞與死結 終止封鎖會話(識別阻塞會話) 查詢性能 標記長期執行的查詢; 強制執行最後已知的良好計畫 索引優化 建立遺失的索引; 刪除未使用的索引; 刪除重複索引 資源壓力與爭奪 CPU 高頻旗標;記憶體高頻標示;I/O 頻段高頻 選取套用。
選擇 「儲存 」以儲存資料庫設定。
儲存會驗證代理程式以及您對每個選取資料庫的 Azure 資源寫入權限。 如果任何一個選取的資料庫未通過該權限檢查,整個儲存作業都會失敗。 從選取中移除您未取得權限的資料庫,然後儲存剩餘的設定。 關於其他儲存失敗,請參閱「代理程式無法儲存或未變為使用中」。
代理程式政策中的動作名稱為 UI 標籤。 啟用動作不會授權或執行指定的資料庫變更。 針對每個情境,請檢視問題處理指引,並透過授權的資料庫工作流程手動執行任何回應。
在有限預覽期間,您可以直接在 Visual Studio Code 中設定並開啟 PostgreSQL 資料庫代理程式(Fabric Database Hub 支援即將推出):
- 在 Visual Studio Code 中,選取活動列中的 PostgreSQL 圖示以開啟連線。
- 在「伺服器」下,新增或連線您的 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器,並在系統提示時以您的 Azure 帳戶登入。
- 在連接的伺服器節點上按右鍵,選擇「 資料庫代理程式 」以設定並啟用該伺服器的資料庫代理程式。
- 如果您開啟儀表板並看到「偵測到 Azure 伺服器」(或「Azure 中繼資料不完整」),請選擇「擷取中繼資料」,以便擴充功能解析伺服器的 Azure 資源身分。
如需完整的 Visual Studio Code 工作流程及螢幕截圖,請參閱《在 Visual Studio Code 中使用資料庫代理程式》。
驗證結果
- 開啟 資料庫代理程式設定 並確認綠色「資料庫代理程式已啟用」訊息顯示。 此訊息顯示的是代理程式層級的狀態,而非每個資料庫的獨立啟用狀態。 在檢查問題之前,請確認儲存設定已完成且無錯誤。
- 儲存設定後,請等待約 15 分鐘,等待新問題出現,然後在資料庫中樞開啟問題清單。 只有在 Database Agents 偵測到已註冊資料庫中的狀況時,才會出現問題。 這個 15 分鐘的問題建立週期,與啟用 SQL 效能監控後的初始傳播延遲是分開計算的。
當您檢視高 CPU 或長時間執行的查詢問題時,可以選擇 選擇性地使用情境式 AI 進行調查,再決定是否手動回應。
- 在 Visual Studio Code 的「連線」>「伺服器」下的伺服器上按一下滑鼠右鍵,選擇「儀表板」。
- 確認伺服器的 Azure 元資料已載入,並監控儀表板頂端的調查橫幅。 啟用伺服器後,偵測到作用中的條件並顯示問題可能需要長達 15 分鐘。
限制和已知問題
- 目前,Azure SQL Database 的資料庫代理程式可在 Fabric 資料庫中心取得(Visual Studio Code 支援即將推出)。
- 目前,資料庫代理程式不支援Azure SQL彈性池、單一 vCore 無伺服器資料庫、Azure SQL 受控執行個體、Azure 虛擬機器上的 SQL Server,或由 Azure Arc 啟用的SQL Server。
- 資料庫必須位於與 Fabric 租戶主區域相關聯的支援區域。
- 目前,PostgreSQL 的資料庫代理程式僅在 Visual Studio Code 中提供;Fabric Database Hub 的支援即將推出。
- 目前,Database Agents 僅支援 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器(PostgreSQL 16 及更新版本)。 Azure HorizonDB 支援即將推出。
- PostgreSQL 支援目前僅以 有限預覽 形式提供,適用於 美國南中部、 美國西部 3 區及 瑞典中部 的伺服器(美國資料 區 與 歐盟資料區則支援 AI 處理)。 存取權限有限,需透過 資料庫代理有限預覽參與表單獲得核准。
- 新啟用的資料庫、伺服器或情境可能需要約 15 分鐘才能產生問題。
- 檢視建議,並透過您授權的工作流程套用任何資料庫或伺服器變更。
Troubleshoot
有關目前的設定與問題發現檢查,請參閱〈 資料庫代理程式的限制與疑難排解〉。