Een container maken in Azure Cosmos DB for NoSQL

  • Artikel

VAN TOEPASSING OP: NoSQL

In dit artikel worden de verschillende manieren uitgelegd om een container te maken in Azure Cosmos DB for NoSQL. U ziet hoe u een container maakt met behulp van Azure Portal, Azure CLI, PowerShell of ondersteunde SDK's. In dit artikel ziet u hoe u een container maakt, de partitiesleutel opgeeft en doorvoer inricht.

In dit artikel worden de verschillende manieren uitgelegd om een container te maken in Azure Cosmos DB for NoSQL. Als u een andere API gebruikt, raadpleegt u API voor MongoDB, API voor Cassandra, API voor Gremlin en API voor Table-artikelen om de container te maken.

Notitie

Wanneer u containers maakt, moet u ervoor zorgen dat u niet twee containers met dezelfde naam maar met een andere behuizing maakt. Dat komt doordat sommige onderdelen van het Azure-platform niet hoofdlettergevoelig zijn en dit kan leiden tot verwarring/botsing van telemetrie en acties op containers met dergelijke namen.

Een container maken met behulp van de Azure-portal

  1. Meld u aan bij de Azure-portal.

  2. Maak een nieuw Azure Cosmos DB-account of selecteer een bestaand account.

  3. Open het deelvenster Data Explorer en selecteer Nieuwe container. Geef de volgende gegevens op:

    • Geef aan of u een nieuwe database maakt of een bestaande database gebruikt.
    • Voer een container-id in.
    • Voer een partitiesleutelwaarde in (bijvoorbeeld /ItemID).
    • Selecteer Automatisch schalen of Handmatige doorvoer en voer de vereiste containerdoorvoer in (bijvoorbeeld 1000 RU/s). Voer een doorvoer in die u wilt inrichten (bijvoorbeeld 1000 RU's).
    • Selecteer OK.

    Screenshot of Data Explorer, with New Collection highlighted

Een container maken met behulp van Azure CLI

Maak een container met Azure CLI. Zie Azure CLI-voorbeelden voor Azure Cosmos DB voor een overzicht van alle Azure CLI-voorbeelden in alle Azure Cosmos DB-API's.

Een container maken met Behulp van PowerShell

Maak een container met PowerShell. Zie PowerShell-voorbeelden voor een overzicht van alle PowerShell-voorbeelden in alle Azure Cosmos DB-API's

Een container maken met behulp van .NET SDK

Als er een time-outuitzondering optreedt bij het maken van een verzameling, voert u een leesbewerking uit om te controleren of de verzameling is gemaakt. De leesbewerking genereert een uitzondering totdat de bewerking voor het maken van verzamelingen is geslaagd. Zie het artikel HTTP-statuscodes voor Azure Cosmos DB voor de lijst met statuscodes die worden ondersteund door de bewerking maken.

// Create a container with a partition key and provision 400 RU/s manual throughput.
CosmosClient client = new CosmosClient(connectionString, clientOptions);
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);

Volgende stappen