共用方式為

在 Azure Cosmos DB for NoSQL 中建立容器

適用於： NoSQL

本文說明在 Azure Cosmos DB for NoSQL 中建立容器的各種方式。 它示範如何使用 Azure 入口網站、Azure CLI、PowerShell 或支援的軟體開發工具包 （SDK） 來建立容器。 本文將示範如何建立容器、指定分割區索引鍵，以及佈建輸送量。

本文說明在 Azure Cosmos DB for NoSQL 中建立容器的各種方式。 如果您使用不同的 API，請參閱 API for MongoDB、API for Cassandra、API for Gremlin 和 API for Table 等文章來建立容器。

附註

建立容器時，請確定您不會建立兩個名稱相同但大小寫不同的容器。 這是因為 Azure 平臺的某些部分不會區分大小寫，這可能會導致具有這類名稱的容器上的遙測和動作混淆/衝突。

使用 Azure 入口網站建立容器

  1. 登入 Azure 入口網站。

  2. 建立新的 Azure Cosmos DB 帳戶，或選取現有的帳戶。

  3. 開啟 [資料總管] 窗格，然後選取 [新增容器]。 接下來，提供下列詳細資料：

    • 指出您要建立新的資料庫或使用現有的資料庫。
    • 輸入 [容器識別碼]。
    • 輸入 [分割區索引鍵] 值 (例如 /ItemID)。
    • 選取 [自動調整] 或 [手動] 輸送量，然後輸入所需的 [容器輸送量] (例如，1000 RU/秒)。 輸入您要佈建的輸送量 (例如 1000 RU)。
    • 選擇 [確定]。

    [數據總管] 的螢幕快照，其中已醒目提示 [新增集合]

使用 Azure CLI 建立容器

使用 Azure CLI 建立容器。

使用 PowerShell 建立容器

使用 PowerShell 建立容器。

使用 .NET SDK 建立容器

如果您在建立集合時遇到逾時例外狀況，請執行讀取作業來驗證是否已成功建立集合。 除非集合建立作業成功，否則讀取作業會擲回例外狀況。 如需有關建立作業支援的狀態碼清單，請參閱 Azure Cosmos DB 的 HTTP 狀態碼一文。

TokenCredential credential = new DefaultAzureCredential();

CosmosClient client = new (
    accountEndpoint: "<nosql-account-endpoint>",
    tokenCredential: credential
);

// Create a container with a partition key and provision 400 RU/s manual throughput.
Database database = await client.CreateDatabaseIfNotExistsAsync(databaseId);

ContainerProperties containerProperties = new ContainerProperties()
{
    Id = containerId,
    PartitionKeyPath = "/myPartitionKey"
};

var throughput = ThroughputProperties.CreateManualThroughput(400);
Container container = await database.CreateContainerIfNotExistsAsync(containerProperties, throughput);

下一步

  • Last updated on