資料庫代理程式的限制與疑難排解

本文是給需要判斷為何某個資料庫或伺服器無法啟用、不會出現或不會產生預期問題的資料庫管理員。

Important

Database Agents 目前處於預覽階段。 支援的配置、區域可用性及問題行為可能在正式推出前有所變更。

支援的資料庫範圍

資料庫代理程式支援 Azure SQL 資料庫,包括無伺服器及超大規模資料庫。 無伺服器資料庫必須處於喚醒狀態,資料庫代理程式才能評估它。

目前,Database Agents 不支援:

  • 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),且初期支援 美國中南部、美國西部 3 和 瑞典中部。 存取受限且需經批准。 若要申請存取權,請填寫 資料庫代理程式有限預覽參與表單。

每項 PostgreSQL 調查皆由 AI 輔助,AI 模型處理分別在 美國資料區(美國中南部 與 美國西部 3)及 歐盟資料區(瑞典中部)。 在有限預覽期間,你不需要為調查付費。 會在正式上市前開始收費,Microsoft 會事先通知已登記的客戶。 AI 產生的結果可能不完整或錯誤,因此在採取行動前,務必先與實際伺服器核對。

資料庫或伺服器未出現

  1. 確認資料庫位於支援範圍內。
  2. 確認您已能存取資料庫。
  3. 確認您已在「啟用 Microsoft SQL 效能監控」中完成適用的訂閱與資料庫設定。
  4. 如果資料庫是無伺服器的,請確認它已喚醒。
  5. 確認資料庫位於與 Fabric 租戶主區相關聯的支援區域。
  6. 請允許約 15 分鐘,讓啟用效能監控反映到資料庫清單與設定。 資料庫在尚未取得該資訊之前無法註冊,因此代理程式無法在註冊前偵測或產生相關問題。

如果資料庫仍未顯示,請聯絡 Microsoft 支援服務。

PostgreSQL 資料庫代理程式尚未在 Fabric 資料庫中心提供(即將推出)。 請改以 Visual Studio Code 檢查您的設定:

  1. 確認您已透過 資料庫代理有限預覽參與表單 申請存取權限並獲得批准。
  2. 確認您已安裝 Visual Studio Code 的 PostgreSQL 擴充功能(版本 1.32.0 或更新版本)。
  3. 確認該彈性伺服器執行 PostgreSQL 16 或更新版本,正在執行(未停止),且處於支援的有限預覽區域(美國中南部、 美國西部 3 或瑞典 中部)。
  4. 確認您已使用具有伺服器存取權限的 Azure 帳戶登入,若出現「已偵測到 Azure 伺服器」或「Azure 中繼資料不完整」,請在伺服器儀表板上選取「擷取中繼資料」。

如果 Visual Studio Code 中伺服器仍無法使用 Database Agent,請聯絡 Microsoft 支援服務。

代理程式無法被儲存或未變成作用中

  1. 檢查錯誤以判斷儲存失敗是因為代理程式層級檢查還是資料庫權限檢查所致。
  2. 確認您對每個選取的資料庫在 Azure 資源上擁有 Azure 角色基礎存取控制(Azure RBAC)寫入權限。 執行 SQL 變更的權限不能取代此 Azure 資源權限。
  3. 如果任何選取的資料庫在寫入權限檢查中失敗,整個儲存作業都會失敗。 從選取中移除您未取得權限的資料庫,然後儲存剩餘的設定。
  4. 確認每個所選資料庫均受支援,且位於與 Fabric 租戶主區域相關聯的支援區域。
  5. 如果所選資料庫為無伺服器,請確認其已喚醒。
  6. 儲存成功後,請在資料庫代理程式設定中尋找「資料庫代理程式目前為啟用」訊息。 訊息顯示的是代理程式層級的狀態,而非每個資料庫的獨立啟用狀態。

如果您仍無法儲存或啟用代理程式,請聯絡 Microsoft 支援服務。

  1. 確認您已透過 資料庫代理有限預覽參與表單 申請存取權限並獲得批准。
  2. 確認您對 Azure 伺服器資源擁有 Azure 角色基礎存取控制(Azure RBAC)寫入權限。 執行 SQL 變更的權限不能取代此 Azure 資源權限。
  3. 確認該彈性伺服器執行 PostgreSQL 16 或更新版本,正在執行(未停止),且處於支援的有限預覽區域(美國中南部、 美國西部 3 或瑞典 中部)。
  4. 在 Visual Studio Code 的伺服器 Dashboard 中,如果出現 Azure Server Detected 或 Incomplete Azure Metadata,請選取 Fetch Metadata,然後重新嘗試設定 Database Agent。

如果您仍無法儲存或啟用代理程式,請聯絡 Microsoft 支援服務。

沒有出現新問題

當您啟用新的資料庫、伺服器或情境時,大約需要 15 分鐘才會出現新的問題。

  1. 至少等十五分鐘。
  2. 確認來源條件仍然有效。
  3. 重新整理問題清單。
  4. 確認已為資料庫或伺服器啟用對應的代理程式原則選項。

如果預期的問題仍未出現,請聯絡 Microsoft 支援服務。

議題細節不完整

資料庫代理程式會驗證資料庫或伺服器的讀取權限,並自動重試調查,最多可重試三次以尋找可重現的錯誤。

當調查達到 失敗 或 調查完成時,其資料不會自動重新生成。 等待、重新整理或重新開啟問題,都無法找回遺失的詳細資料。 確認您對資料庫或伺服器擁有讀取權限,若缺少詳細資訊,請聯絡 Microsoft 支援服務。

無法開啟問題

確認您對資料庫或伺服器具有讀取權限。 如果您仍無法開啟此問題,請聯絡 Microsoft 支援服務。 重新整理或重新開啟不會重執行失敗或已完成的調查,也不會重新產生遺失的細節。

調查失敗

失敗 代表調查未能成功完成。 這並不表示資料庫代理程式嘗試變更資料庫或伺服器。 自動重試僅適用於可重試的錯誤,且最多可重試三次。 一旦調查狀態為 失敗,重新整理或重新開啟也不會重新啟動調查。 檢視可用的問題資訊,確認資料庫或伺服器的讀取權限,若需要協助,請聯絡 Microsoft 支援服務。

無法套用問題中的建議

Database Agents 僅提供調查與指導。 所有情境都需要透過經授權的資料庫工作流程進行人工回應。 在 代理程式政策 中啟用選項不會執行資料庫或伺服器變更。

關於回應與驗證步驟,請參閱 手動回應並驗證條件。

情境式 AI 的範疇與需求

情境式 AI 協助僅適用於高 CPU 及長期執行的查詢問題。 管理員指派的 Copilot 容量已足夠,且已足夠應付現有的資料庫代理程式設定與存取需求。

這些功能提供說明與建議,而非自動修復。 產生的分析依賴現有證據,且可能不完整。 在選擇手動回應前,請先檢視證據及任何明確的限制。

關於問題情境型 Copilot 提示詞、內嵌說明原因與查詢層級分析慢查詢之間的差異,請參閱「使用情境式 AI 調查」。

情境式 AI 控制項無法使用或失效

如果「建議動作」、「說明原因」或「分析慢查詢」中的提示按鈕無法使用或無法運作,請聯絡您的管理員。

無法載入資料庫或伺服器清單

當您的身分無法存取已為租戶儲存的一或多個資源時,載入資源清單可能會失敗。

確認您的 Azure 讀取權限,或使用能存取已設定資源的身份重試。 如果清單仍無法載入,請聯絡 Microsoft 支援服務。

資料庫或伺服器位於另一個區域

資料庫代理程式要求所有 Azure SQL 資料庫都位於與 Fabric 租戶主區域相同的區域。 不支援跨區域註冊。

在有限預覽期間,PostgreSQL 支援僅適用於 美國中南部、 美國西部 3 區及 瑞典中部 的彈性伺服器。 AI 模型處理會在 美國資料區 執行,適用於 美國中南部 和 美國西部 3;而 瑞典中部 則會在 歐盟資料區 執行。

在支援的區域中使用符合資格的資料庫或伺服器。

下一步