Créer une collection dans Azure Cosmos DB for MongoDB

S’APPLIQUE À : MongoDB

Cet article explique les différentes façons de créer une collection dans Azure Cosmos DB for MongoDB. Il montre comment créer une collection à l’aide du portail Azure, d’Azure CLI, de PowerShell ou des kits de développement logiciel (SDK) pris en charge. Cet article montre comment créer une collection, spécifier la clé de partition et provisionner le débit.

Remarque

Les conteneurs et les collections sont similaires à une table dans une base de données relationnelle. Nous parlons de conteneurs dans Azure Cosmos DB for NoSQL et dans le portail Azure, tandis que nous utilisons le terme collections dans le contexte d’Azure Cosmos DB for MongoDB pour correspondre à la terminologie utilisée dans Mongo DB.

Cet article explique les différentes façons de créer une collection dans Azure Cosmos DB for MongoDB. Si vous utilisez une autre API, consultez l’API pour NoSQL, l’API pour Cassandra, l’API pour Gremlin et l’API pour les articles Table pour créer la collection.

Remarque

Lorsque vous créez des collections, veillez à ne pas créer deux collections dont les noms ne se distinguent que par la casse. C’est parce que certaines parties de la plateforme Azure ne sont pas sensibles à la casse, ce qui peut entraîner une confusion/collision de la télémétrie et des actions sur les collections portant de tels noms.

Créer en utilisant le portail Azure

1. Connectez-vous au portail Azure.

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

3. 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 utilisez une base de données existante.
   • Entrez un ID de conteneur.
   • Entrez une clé de partition.
   • Entrez un débit à provisionner (par exemple, 1000 URs).
   • Sélectionnez OK.

   

Créer à l’aide du SDK .NET

var bson = new BsonDocument
{
    { "customAction", "CreateCollection" },
    { "collection", "<CollectionName>" },//update CollectionName
    { "shardKey", "<ShardKeyName>" }, //update ShardKey
    { "offerThroughput", 400} //update Throughput
};
var shellCommand = new BsonDocumentCommand<BsonDocument>(bson);
// Create a collection with a partition key by using Mongo Driver:
db.RunCommand(shellCommand);

Si vous rencontrez une exception de délai d’expiration lors de la création d’une collection, effectuez une opération de lecture pour valider si la collection a été créée avec succès. L’opération de lecture lève une exception jusqu’à ce que l’opération de création de la collection aboutisse. Pour obtenir la liste des codes d’état pris en charge par l’opération de création, consultez l’article Codes d’état HTTP pour Azure Cosmos DB.

Créer une collection à l’aide de modèles Azure Resource Manager

Créer une collection pour l’API Azure Cosmos DB for MongoDB à l’aide d’un modèle Resource Manager.

Étapes suivantes

• Partitioning in Azure Cosmos DB (Partitionnement dans Azure Cosmos DB)
• Unités de requête dans Azure Cosmos DB
• Provisionner le débit sur les conteneurs et les bases de données
• Utiliser un compte Azure Cosmos DB
• Vous tentez d’effectuer une planification de la capacité pour une migration vers Azure Cosmos DB ? Vous pouvez utiliser les informations sur votre cluster de bases de données existant pour la planification de la capacité.
  • Si vous ne connaissez que le nombre de vCore et de serveurs présents dans votre cluster de bases de données existant, lisez Estimation des unités de requête à l’aide de vCore ou de processeurs virtuels.
  • Si vous connaissez les taux de requêtes typiques de votre charge de travail de base de données actuelle, lisez la section concernant l’estimation des unités de requête à l’aide du planificateur de capacité Azure Cosmos DB