使用 Azure Cosmos DB 總管來管理資料

適用於：NoSQL MongoDB Cassandra Gremlin Table

Azure Cosmos DB 總管是一個獨立的 Web 介面，可讓您檢視和管理 Azure Cosmos DB 中儲存的資料。 Azure Cosmos DB 總管相當於現有的 [資料總管] 區段，可在適用於 Azure Cosmos DB 帳戶的 Azure 入口網站中使用。

與資料總管相較之下，Azure Cosmos DB 總管有幾個主要優點，包括：

• 可瀏覽資料、執行查詢以及觀察查詢結果的全螢幕實際使用面積
• 可以將容器中資料的讀取或讀寫功能提供給使用者，而不需要存取 Azure 入口網站或 Azure 訂用帳戶
• 可以與沒有 Azure 訂用帳戶或 Azure 入口網站存取權的使用者共用查詢結果

必要條件

• 現有的 Azure Cosmos DB 帳戶。
  • 如果您沒有 Azure 訂用帳戶，則請免費試用 Azure Cosmos DB。

使用 Azure 訂用帳戶直接存取總管

您可以直接存取總管，並使用現有的認證快速開始使用工具。

1. 瀏覽至 https://cosmos.azure.com。

2. 選取 [登入]。 使用具有 Azure Cosmos DB 帳戶存取權的現有認證進行登入。

3. 接下來，從 [選取資料庫帳戶] 功能表中，選取 Azure 訂用帳戶和目標帳戶。

   

使用 Azure 訂用帳戶以從 Azure 入口網站存取總管

如果您已經熟悉 Azure 入口網站，則可以從入口網站中資料總管直接導覽至獨立總管。

1. 登入 Azure 入口網站。

2. 導覽至現有的 Azure Cosmos DB 帳戶。

3. 在 [資源] 功能表中，選取 [資料總管]。

4. 接下來，選取 [開啟全螢幕] 功能表選項。

   

5. 在 [開啟全螢幕] 對話方塊中，選取 [開啟]。

使用連接字串將總管存取權授與其他人

使用「讀寫」或「唯讀」金鑰，以將您的 Azure Cosmos DB 帳戶存取權提供給另一個使用者。 即使使用者沒有 Azure 訂用帳戶或 Azure 入口網站的存取權，此方法仍然可以運作。

1. 登入 Azure 入口網站。

2. 導覽至現有的 Azure Cosmos DB 帳戶。

3. 在 [資源] 功能表中，選取 [金鑰]。

4. 在 [金鑰] 頁面上，選取 [讀寫金鑰] 或 [唯讀金鑰] 選項。 然後，複製 [主要連接字串] 欄位的值。 在稍後的步驟中您將需要此值。

   	描述
   讀寫金鑰	提供存取權以檢視和修改資料庫、容器、查詢，以及與該特定帳戶相關聯的其他資源
   唯讀金鑰	提供存取權以檢視資料庫、容器、查詢，以及與該特定帳戶相關聯的其他資源

   提示

   如果您想要與沒有 Azure 訂用帳戶或 Azure 入口網站存取權的小組成員共用查詢結果，則可以將唯讀提供給他們。

5. 現在，讓其他使用者導覽至 https://cosmos.azure.com。

6. 選取 [使用連接字串連線至帳戶]。 然後，讓使用者輸入您稍早所複製的連接字串，然後選取 [連線]。

設定要求單位閾值

在 [總管] 中，您可以設定查詢所使用的每秒要求單位 (RU/秒) 限制。 使用此功能來控制查詢要求單位 (RU) 的成本和效能。 此功能也可以自動取消高成本查詢。

1. 在目標 Azure Cosmos DB 帳戶的總管開始。

2. 選取 [設定] 功能表選項。

   

3. 在 [設定] 對話方塊中，設定您是否想要 [啟用 RU 閾值] 和實際 [RU 閾值] 值。

   

   提示

   會使用預設值 5,000 個 RU 來自動啟用 RU 閾值。

已知問題

以下是一些目前已知的問題：

• 資料總管中不支援瀏覽包含 UUID 的項目。 此限制不會影響載入容器，只能檢視個別項目或是包括這些項目的查詢。 若要檢視和管理這些項目，使用者應該繼續使用原先用來建立這些項目的相同工具/SDK。

• HTTP 401 錯誤發生的原因可能是 Microsoft Entra ID 帳戶的角色型存取控制權限不足。 特別是帳戶具有自訂角色時，此條件可能成立。 任何自訂角色都必須包括 Microsoft.DocumentDB/databaseAccounts/listKeys/* 動作，才能使用總管。

後續步驟

開始使用查詢