Connecter une application MongoDB à Azure Cosmos DBConnect a MongoDB application to Azure Cosmos DB

Découvrez comment connecter votre application MongoDB à une instance Azure Cosmos DB à l’aide d’une chaîne de connexion MongoDB.Learn how to connect your MongoDB app to an Azure Cosmos DB by using a MongoDB connection string. Vous pouvez ensuite utiliser une base de données Azure Cosmos en tant que magasin de données pour votre application MongoDB.You can then use an Azure Cosmos database as the data store for your MongoDB app.

Ce didacticiel fournit deux façons de récupérer les informations de la chaîne de connexion :This tutorial provides two ways to retrieve connection string information:

PrérequisPrerequisites

Obtenir la chaîne de connexion MongoDB à l’aide du démarrage rapideGet the MongoDB connection string by using the quick start

  1. Dans un navigateur Internet, connectez-vous au portail Azure.In an Internet browser, sign in to the Azure portal.

  2. Dans le panneau Azure Cosmos DB, sélectionnez l’API.In the Azure Cosmos DB blade, select the API.

  3. Dans le volet gauche du panneau Compte, cliquez sur Démarrage rapide.In the left pane of the account blade, click Quick start.

  4. Choisissez votre plateforme ( .NET, Node.js, MongoDB Shell, Java ou Python).Choose your platform (.NET, Node.js, MongoDB Shell, Java, 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.If you don't see your driver or tool listed, don't worry--we continuously document more connection code snippets. Entrez ci-dessous un commentaire sur ce que vous voudriez voir.Please comment below on what you'd like to see. Pour savoir comment créer votre propre connexion, lisez Obtenir les informations de chaîne de connexion du compte.To learn how to craft your own connection, read Get the account's connection string information.

  5. Copiez et collez l’extrait de code dans votre application MongoDB.Copy and paste the code snippet into your MongoDB app.

    Panneau Démarrage rapide

Obtenir la chaîne de connexion MongoDB à personnaliserGet the MongoDB connection string to customize

  1. Dans un navigateur Internet, connectez-vous au portail Azure.In an Internet browser, sign in to the Azure portal.

  2. Dans le panneau Azure Cosmos DB, sélectionnez l’API.In the Azure Cosmos DB blade, select the API.

  3. Dans le volet gauche du panneau Compte, cliquez sur Chaîne de connexion.In the left pane of the account blade, click Connection String.

  4. Le panneau Chaîne de connexion s’ouvre.The Connection String blade opens. 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.It has all the information necessary to connect to the account by using a driver for MongoDB, including a preconstructed connection string.

    Panneau Chaîne de connexion

Exigences relatives à la chaîne de connexionConnection string requirements

Important

Azure Cosmos DB obéit à des normes et à des exigences strictes en matière de sécurité.Azure Cosmos DB has strict security requirements and standards. Les comptes Azure Cosmos DB requièrent une authentification et une communication sécurisée via SSL.Azure Cosmos DB accounts require authentication and secure communication via SSL.

Azure Cosmos DB prend en charge le format d’URI de la chaîne de connexion MongoDB standard sous certaines conditions spécifiques : l’authentification et la communication sécurisée des comptes Azure Cosmos DB doivent s’effectuer via SSL.Azure Cosmos DB supports the standard MongoDB connection string URI format, with a couple of specific requirements: Azure Cosmos DB accounts require authentication and secure communication via SSL. Le format de chaîne de connexion est donc :So, the connection string format is:

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

Les valeurs de cette chaîne sont disponibles dans le panneau Chaîne de connexion illustré précédemment :The values of this string are available in the Connection String blade shown earlier:

  • Nom d’utilisateur (obligatoire) : Nom du compte Cosmos.Username (required): Cosmos account name.
  • Mot de passe (obligatoire) : Mot de passe du compte Cosmos.Password (required): Cosmos account password.
  • Hôte (obligatoire) : Nom de domaine complet du compte Cosmos.Host (required): FQDN of the Cosmos account.
  • Port (obligatoire) : 10255.Port (required): 10255.
  • Base de données (facultatif) : Base de données utilisée par la connexion.Database (optional): The database that the connection uses. Si aucune base de données n’est fournie, la base de données par défaut est « test ».If no database is provided, the default database is "test."
  • ssl = true (obligatoire)ssl=true (required)

Par exemple, observez le compte figurant dans le panneau Chaîne de connexion.For example, consider the account shown in the Connection String blade. Exemple de chaîne de connexion valide :A valid connection string is:

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

Étapes suivantesNext steps

  • Découvrez comment utiliser Studio 3T avec l’API Azure Cosmos DB pour MongoDB.Learn how to use Studio 3T with Azure Cosmos DB's API for MongoDB.
  • Découvrez comment utiliser Robo 3T avec l’API Azure Cosmos DB pour MongoDB.Learn how to use Robo 3T with Azure Cosmos DB's API for MongoDB.
  • Explorez les exemples MongoDB avec l’API Azure Cosmos DB pour MongoDB.Explore MongoDB samples with Azure Cosmos DB's API for MongoDB.