L'une des tâches les plus fondamentales lorsque l'on travaille avec une base de données consiste à y saisir des données. Dans MongoDB, les données sont stockées sous forme de documents, qui sont des structures de données similaires à JSON (JavaScript Object Notation). Dans ce chapitre, nous verrons comment insérer des documents dans une collection MongoDB.
Avant de commencer, il est important de comprendre que dans MongoDB, une base de données n'est pas créée tant que les données n'y sont pas stockées. Par conséquent, la première fois que nous insérons un document dans une collection, MongoDB créera à la fois la base de données et la collection pour nous.
Insérer un seul document
Pour insérer un seul document dans une collection, nous utilisons la méthode insertOne(). Cette méthode crée un nouveau document si les champs du document n'existent pas dans la collection. Si le document contient un champ "_id", la méthode vérifiera la collection pour voir si un document avec le même ID existe déjà. Si le document existe, la méthode retournera une erreur.
Dans cet exemple, nous insérons un document avec deux champs, "item" et "qty", dans la collection appelée 'collectionName'. Si l'insertion réussit, la méthode renvoie un objet résultat qui contient des informations sur l'opération.
Insérer plusieurs documents
Pour insérer plusieurs documents dans une collection à la fois, nous utilisons la méthode insertMany(). Cette méthode accepte un tableau de documents à insérer dans la collection.
Dans cet exemple, nous insérons trois documents dans la collection 'collectionName'. Encore une fois, si l'insertion réussit, la méthode renvoie un objet résultat qui contient des informations sur l'opération.
Travailler avec le champ _id
Dans MongoDB, chaque document doit avoir un champ "_id" unique qui fait office de clé primaire du document. Si un document en cours d'insertion ne contient pas de champ "_id", MongoDB en ajoutera un pour nous. La valeur du champ "_id" est un objet ObjectId automatiquement généré par MongoDB.
Nous pouvons également fournir notre propre valeur pour le champ "_id" lorsque nous insérons un document. Il faut cependant s'assurer que la valeur est unique dans la collection.
Dans cet exemple, nous fournissons notre propre valeur pour le champ "_id" lorsque nous insérons un document. Si un document avec le même ID existe déjà dans la collection, l'opération d'insertion échoue.
Conclusion
L'insertion de documents dans une collection est une tâche basique mais essentielle lorsque vous travaillez avec MongoDB. Grâce à l'utilisation des méthodes insertOne() et insertMany(), nous pouvons insérer un seul document ou plusieurs documents dans une collection à la fois. Nous avons également la possibilité de fournir notre propre valeur pour le champ "_id" d'un document, à condition qu'il soit unique dans la collection.
Comprendre comment insérer des documents est une étape importante pour travailler efficacement avec MongoDB. Dans le chapitre suivant, nous verrons comment interroger des documents dans une collection MongoDB.
