Tous les produits
Search

Ce produit

    ApsaraDB for MongoDB:Connect to an instance

    Centre de documentation

    ApsaraDB for MongoDB:Connect to an instance

    Dernière mise à jour :Aug 25, 2026

    Connectez-vous à votre instance ApsaraDB for MongoDB via DMS, MongoDB Shell (mongosh) ou le code de votre application.

    Prérequis

    Procédure

    DMS

    1. Accédez à la page des instances de jeu de réplicas ApsaraDB for MongoDB ou des instances de cluster fragmenté ApsaraDB for MongoDB. En haut de la page, sélectionnez un groupe de ressources et une région, puis cliquez sur l'ID de l'instance cible.

    2. Dans le coin supérieur droit, cliquez sur Log on to Database.

      • Pour une instance de jeu de réplicas : sélectionnez Primary dans la liste déroulante.

        Remarque

        Les nœuds secondaires sont en lecture seule. Pour écrire des données, sélectionnez Primary.

      • Pour une instance de cluster fragmenté : sélectionnez n'importe quel nœud dans la liste déroulante.

      • Pour une instance autonome : DMS s'ouvre directement.

    3. Dans la boîte de dialogue Log on to Database Instance, saisissez le Database Account et le Database Password. Laissez les autres champs avec leurs valeurs par défaut.

      Remarque

      Si vous avez oublié votre mot de passe ou si vous ne l'avez pas défini, réinitialisez le mot de passe.

    4. Cliquez sur Test Connectivity. Dans la boîte de dialogue confirmant la réussite, cliquez sur Confirm.

    5. Cliquez sur Login.

    Remarque

    Lorsque vous interrogez des données via DMS, la taille maximale d'un document unique est de 512 Ko. Cette limite est immuable. Pour interroger des documents plus volumineux, utilisez MongoDB Shell.

    MongoDB Shell

    Installer MongoDB Shell

    MongoDB propose deux outils CLI : MongoDB Shell (mongosh) et l'ancien shell mongo. Ce guide utilise mongosh.

    1. Sur votre client, téléchargez MongoDB Shell.

    2. Installez mongosh.

    Obtenir une chaîne de connexion

    1. Accédez à la page des instances de jeu de réplicas ApsaraDB for MongoDB ou des instances de cluster fragmenté ApsaraDB for MongoDB. En haut de la page, sélectionnez un groupe de ressources et une région, puis cliquez sur l'ID de l'instance cible.

    2. Dans le volet de navigation de gauche de la page des détails de l'instance, cliquez sur Database Connections.

    3. Sur la page Database Connections, copiez la chaîne de connexion.

      Cet exemple utilise l'High-availability Connection String URI depuis Private Connection - VPC. Pour vous connecter via Internet, demandez d'abord un endpoint public :

      mongodb://root:****@dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717,dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-8970****

      Remplacez root:**** par vos identifiants réels. Si vous avez oublié votre mot de passe, réinitialisez votre mot de passe.

    Se connecter à la base de données

    Exécutez cette commande sur votre client pour vous connecter :

    Remarque

    Si vous utilisez l'ancien shell mongo, remplacez mongosh par mongo.

    mongosh "<your_connection_string_uri>"

    Exemple avec le compte root, le mot de passe PassWord123! et la base de données d'authentification admin :

    mongosh "mongodb://root:PassWord123%21@dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717,dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-8970****"

    Encodez en URL les caractères spéciaux présents dans les identifiants. Par exemple, ! devient %21. Comment résoudre les échecs de connexion causés par des caractères spéciaux dans un nom d'utilisateur ou un mot de passe ?

    Code

    Étapes suivantes

    Écrire des données

    Documents connexes

    Évitez d'utiliser le compte root en production. Créez des comptes dédiés disposant des permissions appropriées. Les comptes dont les permissions sont insuffisantes renvoient des erreurs telles que Exception authenticating....