Édition

Partage via


Connecter une application MongoDB à Azure Cosmos DB

S’APPLIQUE À : MongoDB

Découvrez comment connecter votre application MongoDB à une instance Azure Cosmos DB à l’aide d’une chaîne de connexion MongoDB. Vous pouvez ensuite utiliser une base de données Azure Cosmos DB en tant que magasin de données pour votre application MongoDB.

Ce didacticiel fournit deux façons de récupérer les informations de la chaîne de connexion :

Prérequis

Deux éléments sont requis

  • Un compte Azure. Si vous ne possédez pas de compte Azure, vous pouvez créer un compte Azure gratuit dès maintenant.

Obtenir la chaîne de connexion MongoDB à l’aide du démarrage rapide

Procédez comme suit :

  1. Dans un navigateur Internet, connectez-vous au portail Azure.

  2. Dans le volet Azure Cosmos DB, sélectionnez l’API.

  3. Dans le volet gauche du volet Compte, sélectionnez Démarrage rapide.

  4. Choisissez votre plateforme ( .NET, Node.js, MongoDB Shell, Java ou Python). Si votre pilote ou outil n’est pas répertorié, ne vous inquiétez pas, nous développons en permanence de nouveaux extraits de code de connexion. Entrez un commentaire sur ce que vous voudriez voir. Pour savoir comment créer votre propre connexion, lisez Obtenir les informations de chaîne de connexion du compte.

  5. Copiez et collez l’extrait de code dans votre application MongoDB.

Obtenir la chaîne de connexion MongoDB à personnaliser

Procédez comme suit :

  1. Dans un navigateur Internet, connectez-vous au portail Azure.

  2. Dans le volet Azure Cosmos DB, sélectionnez l’API.

  3. Dans le volet gauche du volet Compte, sélectionnez Chaînes de connexion.

  4. Le volet Chaînes de connexion s’ouvre. Il affiche toutes les informations nécessaires pour la connexion au compte à l’aide d’un pilote pour MongoDB, dont une chaîne de connexion prédéfinie.

    Exigences relatives à la chaîne de connexion

    Important

    Azure Cosmos DB obéit à des normes et à des exigences strictes en matière de sécurité. Les comptes Azure Cosmos DB nécessitent une authentification et une communication sécurisée via TLS.

    Azure Cosmos DB prend en charge le format d’URI de la chaîne de connexion MongoDB standard sous certaines conditions spécifiques : Les comptes Azure Cosmos DB nécessitent une authentification et une communication sécurisée via TLS. Le format de chaîne de connexion est :

    mongodb://username:password@host:port/[database]?ssl=true

    Les valeurs de cette chaîne sont les suivantes :

    • Nom d’utilisateur (obligatoire) : nom du compte Azure Cosmos DB.
    • Mot de passe (obligatoire) : mot de passe du compte Azure Cosmos DB.
    • Hôte (obligatoire) : nom de domaine complet (FQDN) du compte Azure Cosmos DB.
    • Port (obligatoire) : 10255.
    • Base de données (facultatif) : Base de données utilisée par la connexion. Si aucune base de données n’est fournie, la base de données par défaut est « test ».
    • ssl=true (obligatoire).

    Par exemple, observez le compte figurant dans le volet Chaîne de connexion. Exemple de chaîne de connexion valide :

    mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.com:10255/mydatabase?ssl=true

    Exigences des pilotes

    Tous les pilotes prenant en charge le protocole filaire version 3.4 ou ultérieure prennent en charge Azure Cosmos DB for MongoDB.

    • Les pilotes clients doivent prendre en charge l’extension de protocole TLS SNI (identification du nom de service) et/ou l’option de chaîne de connexion appName.
    • Si le paramètre appName est fourni, il doit être inclus exactement comme il a été trouvé dans la valeur de la chaîne de connexion dans le portail Azure.