Guide de l'utilisateur BPA Mise à niveau MongoDB v5.1

• Introduction
• Mise à jour des versions
• Variables d'amortissement
• Suppression du rappel
• Mise à jour de la requête Suppression
• Mise à jour des modifications de requête
• Mise à jour de la fonction db.addUser()
• Mise à jour des méthodes
• Mise à jour de GridFS

Introduction

BPA v4.1.2 inclut une mise à niveau vers MongoDB v7, car MongoDB v5 arrive en fin de vie. Ce document fournit des détails pour la mise à niveau de la version MongoDB dans les microservices.

Mise à jour des versions

Mettez à jour les versions de package suivantes dans les microservices :

• «mongodb» : «^3.1.13 » à « mongodb » : « ^6.8.0 »
• «mangouste» : «5.8.7» à «mangouste» : « ^8.5.1 »

Variables d'amortissement

Les variables suivantes sont désapprouvées dans MongoDB v7 :

• ssl
• useNewUrlParser
• utiliserTopologieUnifiée
• utiliserRechercherEtModifier
• utiliserCréerIndex
• sslValidate

Remplacez ssl par tls comme indiqué dans l'exemple suivant :

if (process.env.MONGO_SSL == "true") { 
  //options.ssl = true; 
  options.tls = true;
  options.tlsAllowInvalidCertificates = true;
}

Suppression du rappel

Le rappel dans les requêtes MongoDB a été déconseillé dans MongoDB v7. La requête mise à jour s'affiche en vert ci-dessous.

Mise à jour de la requête Suppression

Après avoir exécuté la requête de suppression, la variable de réponse doit utiliser deletedCount à la place de n (par exemple, remplacer result.n par result.deletedCount).

Mise à jour des modifications de requête

Après avoir effectué l'opération de mise à jour, la variable de réponse doit utiliser modifiedCount à la place de n/nModified (par exemple, Replace devices.n / devices.nModified to devices.modifiedCount dans comme indiqué ci-dessous).

Mise à jour de la fonction db.addUser()

Remplacez la fonction db.addUser() par db.command(createUse: «username») comme indiqué dans l'exemple suivant.

Mise à jour des méthodes

Mettez à jour les méthodes suivantes déconseillées dans MongoDB v7 comme indiqué ci-dessous.

Mise à jour de GridFS

Dans MongoDB v7, la classe GridFSBucket est utilisée pour interagir avec GridFS, une spécification de stockage et de récupération de fichiers volumineux. La classe GridFSBucket fournit des méthodes pour télécharger, télécharger et gérer des fichiers dans GridFS. 

Remplacez gridfs-stream en important GridFSBucket de MongoDB. Reportez-vous aux images suivantes pour afficher les modifications.