Approvisionner le débit standard (manuel) sur un conteneur Azure Cosmos DB - API pour NoSQL

Article
08/15/2024

S’APPLIQUE À : NoSQL

Cet article explique comment approvisionner le débit standard (manuel) sur un conteneur dans Azure Cosmos DB for NoSQL. Vous pouvez provisionner le débit sur un seul conteneur, ou provisionner le débit sur une base de données et le partager entre les conteneurs de la base de données. Vous pouvez provisionner le débit sur un conteneur à l’aide du portail Azure, d’Azure CLI ou des SDK Azure Cosmos DB.

Si vous utilisez une autre API, consultez les articles API pour MongoDB, API pour Cassandra, API pour Gremlin pour approvisionner le débit.

Portail Azure

Connectez-vous au portail Azure.
Créez un compte Azure Cosmos DB ou sélectionnez un compte Azure Cosmos DB existant.
Ouvrez le volet Explorateur de données, puis sélectionnez Nouveau conteneur. Fournissez ensuite les détails suivants :
- Indiquez si vous créez une base de données ou si vous utilisez une base de données existante.
- Entrez un ID de conteneur.
- Entrez une valeur de clé de partition (par exemple /ItemID).
- Sélectionnez le débit Mise à l’échelle automatique ou Manuel, puis entrez le Débit de conteneur requis (par exemple, 1000 RU/s). Entrez un débit que vous voulez provisionner (par exemple, 1 000 unités de requête).
- Sélectionnez OK.

Azure CLI ou PowerShell

Pour créer un conteneur avec un débit dédié, voir

Kit de développement logiciel (SDK) .NET

Notes

Utilisez les SDK Azure Cosmos DB pour l’API pour NoSQL afin de provisionner le débit de toutes les API Azure Cosmos DB, à l’exception de Cassandra et de l’API pour MongoDB.

Kit de développement logiciel (SDK) .NET V2
Kit de développement logiciel (SDK) .NET V3

// Create a container with a partition key and provision throughput of 400 RU/s
DocumentCollection myCollection = new DocumentCollection();
myCollection.Id = "myContainerName";
myCollection.PartitionKey.Paths.Add("/myPartitionKey");

await client.CreateDocumentCollectionAsync(
    UriFactory.CreateDatabaseUri("myDatabaseName"),
    myCollection,
    new RequestOptions { OfferThroughput = 400 });

// Create a container with a partition key and provision throughput of 1000 RU/s
string containerName = "myContainerName";
string partitionKeyPath = "/myPartitionKey";

await this.cosmosClient.GetDatabase("myDatabase").CreateContainerAsync(
    id: containerName,
    partitionKeyPath: partitionKeyPath,
    throughput: 1000);

Kit de développement logiciel (SDK) JavaScript

// Create a new Client
const client = new CosmosClient({ endpoint, key });

// Create a database
const { database } = await client.databases.createIfNotExists({ id: "databaseId" });

// Create a container with the specified throughput
const { resource } = await database.containers.createIfNotExists({
id: "containerId",
throughput: 1000
});

// To update an existing container or databases throughput, you need to user the offers API
// Get all the offers
const { resources: offers } = await client.offers.readAll().fetchAll();

// Find the offer associated with your container or the database
const offer = offers.find((_offer) => _offer.offerResourceId === resource._rid);

// Change the throughput value
offer.content.offerThroughput = 2000;

// Replace the offer.
await client.offer(offer.id).replace(offer);

Étapes suivantes

Consultez les articles suivants pour en savoir plus sur le provisionnement du débit dans Azure Cosmos DB :

Partage via