Tous les produits
Search

Ce produit

    ApsaraDB for MongoDB:Demander un endpoint Shard

    Centre de documentation

    ApsaraDB for MongoDB:Demander un endpoint Shard

    Dernière mise à jour :Aug 08, 2026

    Par défaut, les applications se connectent à une instance de cluster shardé ApsaraDB for MongoDB via un nœud Mongos. Cela suffit pour les opérations de lecture et d'écriture standard. Pour des tâches avancées, telles que la lecture de l'oplog d'un Shard, vous devez demander un endpoint dédié pour le Shard.

    Prérequis

    • L'instance est une instance de cluster shardé.

    • L'instance utilise le protocole MongoDB.

    Informations contextuelles

    Une instance de cluster shardé ApsaraDB for MongoDB comprend trois composants : Mongos, Shard et ConfigServer. Vous pouvez personnaliser le nombre et les spécifications des composants Shard pour répondre à vos exigences de performance. Pour plus d'informations, consultez Architecture de cluster shardé.

    Notes d'utilisation

    • Lorsque vous demandez un endpoint Shard, le système crée des endpoints pour le nœud primaire, le nœud secondaire et le nœud en lecture seule au sein du Shard. Chaque endpoint consomme une adresse IP. Assurez-vous de disposer d'assez d'adresses IP disponibles.

    • L'endpoint Shard utilise le même type de réseau que les nœuds Mongos de l'instance.

    • Un endpoint Shard ne peut pas être modifié après sa création.

    • L'endpoint décrit dans cette rubrique est un endpoint privé. Pour accéder à l'instance via Internet, demandez d'abord un endpoint privé et configurez un compte comme décrit dans cette rubrique, puis demandez un endpoint public. Pour obtenir des instructions, consultez Demander un endpoint public.

    • Pour une instance avec des disques locaux, vous pouvez créer un compte Shard lors de la demande de l'endpoint Shard. Pour une instance avec des disques cloud, vous devez d'abord créer un compte Shard sur la page Gestion des comptes avant de demander l'endpoint Shard.

    • Les endpoints Shard sont disponibles uniquement pour les instances de cluster shardé ApsaraDB for MongoDB.

    Procédure

    Instance avec disque cloud

    Important

    La demande d'un endpoint Shard sur une instance avec disque cloud peut entraîner une déconnexion transitoire des sessions existantes. Assurez-vous que votre application dispose d'un mécanisme de reconnexion. Nous vous recommandons d'effectuer cette opération pendant les heures creuses.

    1. Accédez à la liste des instances de cluster shardé 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. Créez un compte Shard.

      Remarque

      Vous devez créer un compte Shard uniquement lors de la première demande d'un endpoint Shard. Cette étape n'est pas requise pour les demandes suivantes.

      1. Dans le volet de navigation de gauche de la page des détails de l'instance, cliquez sur Accounts.

      2. Cliquez sur Create Account.

      3. Dans le panneau Create Account (Shard Only), saisissez le nom du compte et le mot de passe.

        Remarque

        Le compte Shard dispose d'autorisations en lecture seule fixes.

        Parameter

        Description

        Account Name

        Le nom du compte doit répondre aux exigences suivantes :

        • Commencer par une lettre minuscule.

        • Contenir uniquement des lettres minuscules, des chiffres et des traits de soulignement (_).

        • Compter entre 4 et 16 caractères.

        Remarque

        • Les mots-clés réservés ne peuvent pas être utilisés comme nom de compte dans ApsaraDB for MongoDB.

        • Le compte dispose d'autorisations en lecture seule fixes.

        Account Password

        Le mot de passe doit répondre aux exigences suivantes :

        • Contenir des caractères d'au moins trois des types suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux.

          Les caractères spéciaux pris en charge sont !@#$%^&*()_+-=.

        • Compter entre 8 et 32 caractères.

        Remarque

        ApsaraDB for MongoDB vous permet de réinitialiser les mots de passe des comptes des nœuds ConfigServer et Shard. Pour plus d'informations, consultez Réinitialiser un mot de passe.

        Confirm Password

        Saisissez à nouveau le mot de passe pour le confirmer.

      4. Cliquez sur Confirm.

    3. Créez l'endpoint Shard.

      1. Dans le volet de navigation de gauche, cliquez sur Database Connections.

      2. Dans la section Private Endpoint - VPC, cliquez sur Apply for Shard Endpoint.

      3. Dans le panneau Apply for Shard Endpoint, définissez les paramètres suivants.

        Paramètre

        Description

        Node Type

        Ce paramètre est fixé sur Shard.

        Select Node ID

        Sélectionnez l'ID du nœud nécessitant un endpoint.

      4. Cliquez sur OK.

    4. Sur la page Database Connections, consultez le nouvel endpoint.

      1. Attendez que le statut de l'instance passe de Establishing Network Connection à Running.

      2. Dans la section Private Endpoint - VPC, consultez l'endpoint du nœud.

    Instance avec disque local

    Remarque

    Vous pouvez également accéder à la page Basic Information de l'instance, trouver la section Shard List et cliquer sur Add Shard. Sélectionnez l'option permettant d'activer une connexion directe au Shard, puis demandez l'endpoint Shard dans la section Apply for Shard Private Endpoint.

    1. Accédez à la liste des instances de cluster shardé 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, cliquez sur Database Connections.

    3. Dans la section Private Endpoint - VPC, cliquez sur Apply for Shard Endpoint.

    4. Dans le panneau Apply for Shard Endpoint, définissez les paramètres suivants.

      Paramètre

      Description

      Node Type

      Ce paramètre est fixé sur Shard.

      Select Node ID

      Sélectionnez l'ID du nœud nécessitant un endpoint.

      Account Name

      Le nom du compte doit répondre aux exigences suivantes :

      • Commencer par une lettre minuscule.

      • Contenir uniquement des lettres minuscules, des chiffres et des traits de soulignement (_).

      • Compter entre 4 et 16 caractères.

      Remarque

      • Les mots-clés réservés ne peuvent pas être utilisés comme nom de compte dans ApsaraDB for MongoDB.

      • Le compte dispose d'autorisations en lecture seule fixes.

      • Vous devez définir un nom de compte et un mot de passe uniquement lors de la première demande d'endpoint sur un nœud Shard ou ConfigServer. Cela n'est pas requis pour les demandes suivantes.

      Account Password

      Le mot de passe doit répondre aux exigences suivantes :

      • Contenir des caractères d'au moins trois des types suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux.

        Les caractères spéciaux pris en charge sont !@#$%^&*()_+-=.

      • Compter entre 8 et 32 caractères.

      Remarque

      ApsaraDB for MongoDB vous permet de réinitialiser les mots de passe des comptes des nœuds ConfigServer et Shard. Pour plus d'informations, consultez Réinitialiser un mot de passe.

      Confirm Password

      Saisissez à nouveau le mot de passe pour le confirmer.

    5. Cliquez sur OK.

    6. Sur la page Database Connections, consultez le nouvel endpoint.

      1. Attendez que le statut de l'instance passe de Establishing Network Connection à Running.

      2. Dans la section Private Endpoint - VPC, consultez l'endpoint du nœud.

    Rubriques connexes

    Pour libérer un endpoint Shard dont vous n'avez plus besoin, consultez Libérer un endpoint de nœud Shard ou ConfigServer.