在 Azure Cosmos DB for MongoDB 中建立集合
適用於: MongoDB
此文章描述在 Azure Cosmos DB for MongoDB 中建立集合的各種方式。 其中說明如何使用 Azure 入口網站、Azure CLI、PowerShell 或支援的 SDK 來建立集合。 本文將示範如何建立集合、指定分割區索引鍵,以及佈建輸送量。
注意
[容器] 和 [集合] 類似於關聯式資料庫中的資料表。 我們在 Azure Cosmos DB for NoSQL 以及整個 Azure 入口網站中都會使用容器一詞,但是會在 Azure Cosmos DB for MongoDB 的內容中使用集合一詞,以符合 MongoDB 中所使用的術語。
此文章描述在 Azure Cosmos DB for MongoDB 中建立集合的各種方式。 如果您使用不同的 API,請參閱 API for NoSQL、API for Cassandra、API for Gremlin 和 API for Table 等文章來建立集合。
注意
建立集合時,請確定您不會建立兩個名稱相同但大小寫不同的集合。 這是因為 Azure 平台的某些部分不會區分大小寫,而這可能導致在具有這類名稱的集合上發生遙測和動作的混淆/衝突。
使用 Azure 入口網站建立
登入 Azure 入口網站。
建立新的 Azure Cosmos DB 帳戶,或選取現有的帳戶。
開啟 [資料總管] 窗格,然後選取 [新增容器]。 接下來,提供下列詳細資料:
- 指出您正在建立新的資料庫,還是使用現有的帳戶。
- 輸入容器識別碼。
- 輸入分區索引鍵。
- 輸入要佈建的輸送量 (例如 1000 RU)。
- 選取 [確定]。
使用 .NET SDK 建立
var bson = new BsonDocument
{
{ "customAction", "CreateCollection" },
{ "collection", "<CollectionName>" },//update CollectionName
{ "shardKey", "<ShardKeyName>" }, //update ShardKey
{ "offerThroughput", 400} //update Throughput
};
var shellCommand = new BsonDocumentCommand<BsonDocument>(bson);
// Create a collection with a partition key by using Mongo Driver:
db.RunCommand(shellCommand);
如果您在建立集合時遇到逾時例外狀況,請執行讀取作業來驗證是否已成功建立集合。 除非集合建立作業成功,否則讀取作業會擲回例外狀況。 如需有關建立作業支援的狀態碼清單,請參閱 Azure Cosmos DB 的 HTTP 狀態碼一文。
使用 Azure CLI 建立
使用 Azure CLI 建立適用於 API for MongoDB 的 Azure Cosmos DB 集合。 如需所有 Azure Cosmos DB API 的所有 Azure CLI 範例清單,請參閱 Azure Cosmos DB 的 Azure CLI 範例。
使用 PowerShell 建立
使用 PowerShell 建立適用於 API for MongoDB 的 Azure Cosmos DB 集合。 如需所有 Azure Cosmos DB API 的所有 PowerShell 範例清單,請參閱 PowerShell 範例
使用 Azure Resource Manager 範本建立集合
使用 Resource Manager 範本建立適用於 API for MongoDB 的 Azure Cosmos DB 集合。
下一步
- Azure Cosmos DB 中的資料分割
- Azure Cosmos DB 中的要求單位
- 在容器和資料庫中佈建輸送量
- 使用 Azure Cosmos DB 帳戶
- 正在嘗試為遷移至 Azure Cosmos DB 進行容量規劃嗎? 您可以使用現有資料庫叢集的相關資訊進行容量規劃。
- 如果您知道現有資料庫叢集中的虛擬核心和伺服器數目,請參閱使用虛擬核心或 vCPU 來估計要求單位
- 如果您知道目前資料庫工作負載的一般要求率,請參閱使用 Azure Cosmos DB 容量規劃工具來估計要求單位