Microsoft Fabric 中的 Database Hub 幫助你在 API（NoSQL、MongoDB、Cassandra、Gremlin、Table）中發現 Azure Cosmos DB 帳號。
小提示
💡 資料庫中心代理設定
開始運用 Database Hub 代理技能，理解並互動 Fabric 中的 Database Hub：
- Use [Database Hub skills](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-fdh).
- Review [Database Hub in Fabric documentation](https://learn.microsoft.com/fabric/database/hub/)
and use the [Microsoft Learn MCP server](https://learn.microsoft.com/api/mcp) for official docs.
Important
這項功能目前處於預覽階段。
就地監控 Cosmos DB
你的 Cosmos DB 帳號在現有的訂閱、資源群組和區域中仍是 Azure 資源。 使用 Database Hub 進行發現與監控，不需要將資料移入 Fabric、設定鏡像，或導入 Cosmos DB 車隊分析。
資料庫樞紐的指標描述帳戶，除非有指標或過濾器參數明確指出較窄範圍，例如特定資料庫或容器。
- Database Hub 中的 Cosmos DB 監控使用現有的 Azure 監視器 平台指標，這些指標會自動為每個帳戶收集，且沒有明確設定。
- 你不需要啟用診斷（資源）日誌，也不需要在 Cosmos DB Fleet Analytics 上啟用。
- Azure 監視器 和 Fleet Analytics 是分開的、需選擇加入的工具，用於更深入的調查，且不需要它們來填入基線指標。
先決條件
在目前預覽版中，請 Fabric 管理員在 Fabric 管理入口網站中選擇您的租戶進入資料庫中心預覽體驗。 在租戶設定中啟用，使用者可存取資料庫中心（預覽）。
從你的工作或學校帳號登入免費體驗開始。 即使你之前沒用過Fabric，也可以從Azure入口或直接從Microsoft Fabric進入。 用一個 Microsoft Entra 身份驗證，該身份能存取你想使用的 Azure 訂閱和 Cosmos DB 資源。 僅靠 Azure 資源可見性並不能授權查詢資料庫。 Database Hub 使用你現有的 Microsoft Entra ID 和 Azure RBAC 權限，而非獨立的權限模型，因此你在這裡指派的存取權遵循標準的 Azure 角色指派步驟。
- 要發現並監控 Cosmos DB 帳號，請在每個包含你想監控的帳號的訂閱範圍內，指派 Reader 角色或擁有更高權限的角色。
- 若要從資料庫中心建立新的 Cosmos DB 帳號，請在帳號建立的資源群組範圍內指定 Cosmos DB 營運者角色，或擁有更高權限的角色。
- 管理或重新設定現有帳號，例如更改吞吐量、索引或網路設定，則可在資料庫中心外使用，使用 Azure 入口網站、Azure CLI、Azure PowerShell 或 Azure Resource Manager 範本。 同一身分需要在帳戶範圍內具備 Cosmos DB Operator 角色，或具備權限更高的角色，才能在該帳戶中進行這些變更。
若要查詢資料庫或容器中的資料，你的身份需要一個獨立的 Cosmos DB 資料平面角色指派（或允許時提供帳號金鑰），並且要有帳號的網路存取權限。 資源層級（管理層）存取權限不會授予此權限。 欲了解更多，請參閱使用 Microsoft Entra ID 和角色型存取控制連線至 Azure Cosmos DB。
Database Hub 會尊重您現有的存取權限。 資料庫中心不會授予額外存取權限。 你對資料庫的能見權限僅限於你目前身份被授權查看的資源。 分享檢視或傳送資源連結給別人，並不代表他們能存取底層伺服器。
查看您的 Cosmos DB 環境
小提示
Estate 中所代表的 Cosmos DB 資源是一個資料庫帳號，而非該帳號內的每個資料庫或容器。
利用資料庫中心來識別需要調查的資源。 繼續使用 Azure 入口網站或 Visual Studio Code 進行帳號設定、容器層級工作或查詢診斷。
- 請前往 Microsoft Fabric 的資料庫中樞。 在資料庫導覽中，選擇 「概覽」。
- 「 什麼需要關注？ 」部分指出資料庫資產中需要關注的部分。 在 需要注意的事項？ 中的每張卡片和每個連結都會連到 遺產。 在 Estate 檢視中，每個資源下方，問題 會以彩色標籤顯示，而 建議 會以帶有燈泡圖示的標籤顯示。
- 將清單篩選為 View: Azure Cosmos DB。 使用可用的篩選器選擇相關的訂閱或資源群組。
- 搜尋你需要的帳戶，或檢視篩選過的庫存。 選擇帳號以檢視其資源詳情。 把這個帳號當作 Azure 帳號資源，而不是單一的資料庫或容器。
資料庫中樞中的 Cosmos DB 監視計量
概覽 顯示可用性並標準化 RU 消耗摘要，涵蓋您的 Cosmos DB 帳戶資源。
對於資源配置充足且使用活躍的帳號來說，兩條線大部分時間都維持在或接近 100% 是很正常的。 高 RU 消耗表示該帳號已使用大部分或全部已配置的吞吐量。 是否可以接受，取決於同一視窗內的可用性。
- 同時高可用性代表請求仍然成功，帳號只是充分利用已配置的資源。
- 同時，可用性下降也表示請求確實遭到節流或失敗，因為 RU 消耗量持續達到上限，正是觸發速率限制的相同條件。
當可用性明顯低於100%時，請特別注意。 另外，也要留意 RU 消耗在一段長時間內持續偏低，這可能表示吞吐量配置過高。
效能 功能讓你更仔細地查看你明確選擇的特定帳號。 它不會自動包含所有帳號在 Eestate 裡，如果沒有套用篩選器， 效能 圖表會限制檢視範圍，只顯示前 100 個資源，以保持頁面的響應性。 在將 績效 表視為整個遺產之前，請確認目前被選中的帳戶，因為範圍範圍的選擇與您的完整遺產庫存可能會有所不同。
缺少遙測資料並不代表使用率為零，也不能證明帳戶狀況良好。 檢查帳號在所選區間是否產生資料，以及是否有指標適用於其 API 類型與設定。
解讀 Cosmos DB 效能訊號
| 訊號 | Azure 監視器 metric | 彙總 | Description |
|---|---|---|---|
| 標準化RU消耗（峰值標準RU %） | NormalizedRUConsumption |
極限 | 帳戶分割區鍵範圍的峰值 RU/s 利用率，範圍從 0 到 100%。 |
| 總請求單位（總 RU 消耗量） | TotalRequestUnits |
總計 (總和) | 總消耗的 RU 總數，為所選區間內的總和。 |
| 限速請求（429s） |
TotalRequests 篩選至狀態代碼429 |
Count | 超出預設吞吐量而被拒絕的請求原始數量。 |
| 429 比率 % |
TotalRequests 篩選為 StatusCode 429，並除以總請求數 TotalRequests |
計數（比率） | 超出配置吞吐量而被限速的請求百分比。 |
| 配置吞吐量（配置済み RU/s） | ProvisionedThroughput |
極限 | 帳戶在選定期間內已配置的 RU/s，這樣你可以比較已配置與消耗容量。 |
| 平均延遲（ms） | ServerSideLatencyDirect |
平均 | 直接連線模式下伺服器端請求的平均延遲（毫秒）。 不包含閘道模式延遲。 |
| 可用性 % | ServiceAvailability |
平均 | 在此期間內成功的請求所占百分比。 |
備註
效能中的可用性 % 使用平均彙總。 概覽頁面的可用性摘要改用最小聚合來標示異常值。
本頁的圖表以每小時為時間粒度：24 小時視圖會繪製 24 個資料點，並使用對應的彙總方式。 網格使用不同的時間粒度，將整個選取範圍簡化為每個帳號、每欄的單一值，而不是隨時間繪製點。 例如，網格的 峰值範數RU % 是該範圍內觀測到的最大值，而非每小時的細分。
如需詳細資訊，請參閱 監控 Azure Cosmos DB 和 Microsoft.DocumentDB/databaseAccounts 的支援計量。
解讀 Cosmos DB 的安全性與能力差異
資料庫中樞的 安全性 頁面會評估三種 Cosmos DB 訊號：
- Microsoft Entra ID 認證：帳號是否強制執行僅 Entra ID 認證，或仍允許本地（基於金鑰）的認證。
- 客戶管理金鑰（CMK）：是否啟用 CMK 加密，或帳號是否依賴服務管理金鑰。
- 公共網路存取：帳號是否啟用了。
如果某帳號允許本地驗證或沒有啟用 CMK，Database Hub 會將其列為 「建議」，這是方便時可選擇的改進。 已啟用公用網路存取的帳戶會列為 問題，因為這被視為時效性較高。
資料庫樞紐訊號反映的是它目前評估的內容，而不一定代表帳號底層安全設定的完整狀態。 例如，未啟用 CMK 的帳號預設仍透過 Microsoft 管理的金鑰保持靜態加密，因此這裡的標記表示「未啟用此功能」而非「未受保護」。在處理發現前，請先在 Azure 入口網站確認帳號目前的設定。 如需詳細資訊，請參閱 為 Azure Cosmos DB 設定客戶管理的金鑰 與 Azure Cosmos DB 中的待用資料加密。
這些安全訊號提供快速視角，幫助你進行分流。 若要進行完整的安全性評估與修復，請搭配 Database Hub 使用 適用於雲端的 Microsoft Defender 等服務，以及您帳戶的診斷記錄。
繼續在 Azure 入口網站進行調查
你可以使用 Azure 入口網站進一步調查問題，例如在 Database Hub 與 Azure 入口網站中，將同一帳號的指標並排比較。
小提示
用 Visual Studio Code Cosmos DB 擴充功能來處理資料平面工作，例如查詢和管理文件，但不要用來檢視效能指標。
- 在資料庫中心選擇預期的 Cosmos DB 帳號。 資料庫中樞中會開啟該項目的窗格。
- 選擇開啟 Azure 入口網站按鈕。
- 到 洞察 分頁設定時間範圍。 在適當的追蹤期間內比較相關指標。
在目前的預覽階段，Azure 入口網站的 Insights 索引標籤提供更廣泛的圖表和計量，因此對於 Database Hub 尚未顯示的訊號，請使用該索引標籤。
調查 Cosmos DB 的安全發現
請從安全性摘要中選取 Cosmos DB 的發現項目，或在可用時，於 Estate 中選取受影響的帳戶。
確認受影響的帳戶、評估名稱、評估地點及任何可用的觀察時間。 請核對建議是否符合你組織的政策。
請在 Azure 入口網站開啟帳號並確認其目前的設定。 關於 Microsoft Entra 認證、客戶管理金鑰或公共網路存取，請遵循相應的 Cosmos DB 服務文件。
評估申請的影響並在做出變更前取得所需批准。
授權變更完成後，請在 Azure 入口網站確認設定。 允許重新評估並更新資料庫中心;若發現持續，則將其證據與當前帳戶配置進行比較。
在資料庫中心中排除 Cosmos DB 資料的故障
- 如果 Cosmos DB 帳號沒有出現在 Estate，請檢查已登入的租戶、Azure 存取權限、資源類型、庫存篩選和授權。
- 如果 Azure 監視器 與資料庫中樞的效能指標缺失或不同：
- 選擇帳號正在積極處理請求的時間區間。 檢查該指標是否適用於帳號的 API 類型;例如，429 的映射在 NoSQL（狀態代碼 429）和 MongoDB API（錯誤代碼 16500）之間有所不同。
- 在 Azure 入口網站開啟同一個帳號，並在 Insights 標籤下檢查對應的 Azure 監視器 指標。盡可能將時區、開始與結束時間、聚合及細節相匹配。
- 如果兩處都沒有此指標，請檢查帳戶活動，並將處理延遲納入考量。
- 如果 Azure 監視器 有資料但 Database Hub 沒有，請重新整理 Database Hub 檢視，並只用該帳號重新嘗試。 如果差異持續，請聯絡客服。
Limitations
- Cosmos DB Fleet Analytics 目前不支援 Database Hub。
- 目前的預覽版僅支援 Azure Cosmos DB 帳號。 目前預覽版中，Fabric 中的 Cosmos DB 目前不被支援。
- 在目前的預覽中，Overview 和 Performance 呈現了 Azure 監視器 中精選的指標子集。
- 目前預覽版中，無法針對 Cosmos DB 指標發出 Activator 警示。