Freigeben über

Erstellen eines Containers in Azure Cosmos DB for NoSQL

  • Gilt für:: ✅ NoSQL

GILT FÜR: NoSQL

In diesem Artikel werden die verschiedenen Möglichkeiten zum Erstellen eines Containers in Azure Cosmos DB for NoSQL erklärt. Es zeigt, wie Sie einen Container mithilfe des Azure-Portals, der Azure CLI, PowerShell oder der unterstützten Softwareentwicklungskits (SOFTWARE Development Kits, SDKs) erstellen. In diesem Artikel erfahren Sie, wie Sie einen Container erstellen, den Partitionsschlüssel angeben und den Durchsatz bereitstellen.

In diesem Artikel werden die verschiedenen Möglichkeiten zum Erstellen eines Containers in Azure Cosmos DB for NoSQL erklärt. Wenn Sie eine andere API verwenden, lesen Sie API für MongoDB, API für Cassandra, API für Gremlin und API für Table, um den Container zu erstellen.

Hinweis

Stellen Sie beim Erstellen von Containern sicher, dass Sie nicht zwei Container mit demselben Namen, aber unterschiedlicher Groß-/Kleinschreibung erstellen. Das liegt daran, dass einige Teile der Azure-Plattform nicht case-sensitiv sind, was zu Verwirrung oder Konflikten bei der Telemetrie und den Aktionen für Container mit solchen Namen führen kann.

Hinweis

Vermeiden Sie beim Benennen von Azure Cosmos DB-Containern vertrauliche Informationen wie Zugriffstasten, geheime Schlüssel, Kundendaten oder interne IDs. Wenden Sie Microsoft Entra-ID-basierte Zugriffssteuerungen und das Prinzip des geringsten Privilegs für die tatsächliche Durchsetzung der Sicherheit an, wobei Containernamen neutral und nicht verräterisch sind.

Erstellen eines Containers über das Azure-Portal

  1. Melden Sie sich beim Azure-Portal an.

  2. Erstellen Sie ein neues Azure Cosmos DB-Konto, oder wählen Sie ein vorhandenes Konto aus.

  3. Öffnen Sie den Bereich Daten-Explorer, und wählen Sie Neuer Container aus. Geben Sie anschließend die folgenden Details an:

    • Geben Sie an, ob Sie eine neue Datenbank erstellen oder eine vorhandene Datenbank verwenden.
    • Geben Sie eine Container-ID ein.
    • Geben Sie einen Wert für den Partitionsschlüssel ein (z. B. /ItemID).
    • Wählen Sie Autoskalierung oder Manuell für den Durchsatz aus, und geben Sie den erforderlichen Containerdurchsatz ein (z. B. 1000 RU/s). Geben Sie den bereitzustellenden Durchsatz an (etwa 1.000 RUs).
    • Klicken Sie auf OK.

    Screenshot des Daten-Explorers mit hervorgehobener Option „Neue Sammlung“

Erstellen eines Containers über die Azure-Befehlszeilenschnittstelle

Erstellen Sie einen Container mithilfe der Azure CLI.

Erstellen eines Containers mithilfe von PowerShell

Erstellen Sie einen Container mithilfe von PowerShell.

Erstellen eines Containers mithilfe des .NET SDK

Tritt eine Timeout-Ausnahme beim Erstellen einer Sammlung auf, führen Sie einen Lesevorgang durch, um zu überprüfen, ob die Sammlung erfolgreich erstellt wurde. Der Lesevorgang löst eine Ausnahme aus, bis der Vorgang zum Erstellen der Sammlung erfolgreich ist. Eine Liste der von dem Erstellvorgang unterstützten Statuscodes finden Sie im Artikel HTTP-Statuscodes für Azure Cosmos DB.

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);

Nächste Schritte

  • Last updated on