共用方式為

在 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 建立容器。 如需所有 Azure Cosmos DB API 的所有 Azure CLI 範例清單，請參閱 Azure Cosmos DB 的 Azure CLI 範例。

使用 PowerShell 建立容器

使用 PowerShell 建立容器。 如需所有 Azure Cosmos DB API 的所有 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);

下一步