Approvisionner le débit des conteneurs et des bases de données et la mise à l’échelle automatique sur des ressources d’Azure Cosmos DB for MongoDB

S’APPLIQUE À : MongoDB

Cet article explique comment approvisionner le débit dans Azure Cosmos DB for MongoDB. Vous pouvez approvisionner un débit standard (manuel) ou avec mise à l’échelle automatique sur un conteneur ou sur une base de données et le partager entre les conteneurs de la base de données. Vous pouvez provisionner le débit à 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 NoSQL, API pour Cassandra, API pour Gremlin pour approvisionner le débit.

Portail Azure

  1. Connectez-vous au portail Azure.

  2. Créez un compte Azure Cosmos DB ou sélectionnez un compte Azure Cosmos DB existant.

  3. Ouvrez le volet Explorateur de données, puis sélectionnez Nouvelle collection. 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. Sélectionnez l’option Approvisionner le débit d’une base de données si vous souhaitez approvisionner le débit au niveau de la base de données.
    • Entrez un ID de collection.
    • Entrez une valeur de clé de partition (par exemple ItemID).
    • Entrez un débit que vous voulez provisionner (par exemple, 1 000 unités de requête).
    • Sélectionnez OK.

    Capture d’écran d’Explorateur de données, lors de la création d’une nouvelle collection avec un débit au niveau de la base de données

Notes

Si vous approvisionnez le débit sur un conteneur dans un compte Azure Cosmos DB configuré avec Azure Cosmos DB for MongoDB, utilisez myShardKey pour le chemin de clé de partition.

Kit de développement logiciel (SDK) .NET

// refer to MongoDB .NET Driver
// https://docs.mongodb.com/drivers/csharp

// Create a new Client
String mongoConnectionString = "mongodb://DB AccountName:Password@DB AccountName.documents.azure.com:10255/?ssl=true&replicaSet=globaldb";
mongoUrl = new MongoUrl(mongoConnectionString);
mongoClientSettings = MongoClientSettings.FromUrl(mongoUrl);
mongoClient = new MongoClient(mongoClientSettings);

// Change the database name
mongoDatabase = mongoClient.GetDatabase("testdb");

// Change the collection name, throughput value then update via MongoDB extension commands
// https://video2.skills-academy.com/azure/cosmos-db/mongodb-custom-commands#update-collection

var result = mongoDatabase.RunCommand<BsonDocument>(@"{customAction: ""UpdateCollection"", collection: ""testcollection"", offerThroughput: 400}");

Azure Resource Manager

Les modèles Azure Resource Manager peuvent être utilisés pour provisionner le débit de mise à l’échelle automatique sur des ressources de base de données ou de niveau conteneur pour toutes les API Azure Cosmos DB. Consultez Modèles Azure Resource Manager pour Azure Cosmos DB afin de voir des exemples.

Azure CLI

L’interface Azure CLI peut être utilisée pour provisionner le débit de mise à l’échelle automatique sur des ressources de base de données ou de niveau conteneur pour toutes les API Azure Cosmos DB. Pour voir des exemples, consultez Exemples Azure CLI pour Azure Cosmos DB.

Azure PowerShell

Azure PowerShell peut être utilisé pour provisionner le débit de mise à l’échelle automatique sur des ressources de base de données ou de niveau conteneur pour toutes les API Azure Cosmos DB. Pour obtenir des exemples, consultez Exemples Azure PowerShell pour Azure Cosmos DB.

Étapes suivantes

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