Todos os produtos
Search

Este produto

    ApsaraDB for MongoDB:Solicitar um endpoint de Shard

    Central de documentação

    ApsaraDB for MongoDB:Solicitar um endpoint de Shard

    Última atualização: Jul 20, 2026

    Por padrão, as aplicações se conectam a uma instância de cluster sharded do ApsaraDB for MongoDB por meio de um nó Mongos. Isso basta para operações padrão de leitura e escrita. Para tarefas avançadas, como ler o oplog de um Shard, solicite um endpoint dedicado para esse Shard.

    Pré-requisitos

    • A instância deve ser do tipo cluster sharded.

    • A instância utiliza o protocolo MongoDB.

    Informações básicas

    Uma instância de cluster sharded do ApsaraDB for MongoDB é composta por três componentes: Mongos, Shard e ConfigServer. Personalize a quantidade e as especificações dos componentes Shard para atender aos seus requisitos de desempenho. Para mais informações, consulte Sharded cluster architecture.

    Observações de uso

    • Ao solicitar um endpoint de Shard, o sistema cria endpoints para os nós primário, secundário e somente leitura dentro do Shard. Cada endpoint consome um endereço IP. Verifique se há endereços IP disponíveis suficientes.

    • O endpoint de Shard utiliza o mesmo tipo de rede dos nós Mongos da instância.

    • Não é possível modificar um endpoint de Shard após sua criação.

    • O endpoint descrito neste tópico é privado. Para acessar a instância pela Internet, solicite primeiro um endpoint privado e configure uma conta conforme descrito aqui; em seguida, solicite um endpoint público. Para obter instruções, consulte Apply for a public endpoint.

    • Em instâncias com discos locais, crie uma conta de Shard durante a solicitação do endpoint. Já em instâncias com discos cloud, crie previamente uma conta de Shard na página Account Management antes de solicitar o endpoint.

    • Endpoints de Shard estão disponíveis apenas para instâncias de cluster sharded do ApsaraDB for MongoDB.

    Procedimento

    Instância com disco cloud

    Importante

    Solicitar um endpoint de Shard em uma instância com disco cloud pode causar uma desconexão transitória nas sessões existentes. Certifique-se de que sua aplicação possua um mecanismo de reconexão. Recomendamos executar esta operação fora dos horários de pico.

    1. Acesse a lista de instâncias de cluster sharded do ApsaraDB for MongoDB. No topo da página, selecione um grupo de recursos e uma região e clique em ID da instância desejada.

    2. Crie uma conta de Shard.

      Nota

      A criação da conta de Shard é necessária apenas na primeira vez que você solicita um endpoint de Shard. Este passo não é obrigatório para solicitações subsequentes.

      1. No painel de navegação à esquerda da página de detalhes da instância, clique em Accounts.

      2. Clique em Create Account.

      3. No painel Create Account (Shard Only), insira o nome e a senha da conta.

        Nota

        A conta de Shard possui permissões fixas de somente leitura.

        Parâmetro

        Descrição

        Account Name

        O nome da conta deve atender aos seguintes requisitos:

        • Começar com uma letra minúscula.

        • Conter apenas letras minúsculas, dígitos e underscores (_).

        • Ter entre 4 e 16 caracteres.

        Nota

        • Palavras-chave reservadas não podem ser usadas como nome de conta no ApsaraDB for MongoDB.

        • A conta possui permissões fixas de somente leitura.

        Account Password

        A senha deve atender aos seguintes requisitos:

        • Conter caracteres de pelo menos três dos seguintes tipos: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais.

          Os caracteres especiais suportados são !@#$%^&*()_+-=.

        • Ter entre 8 e 32 caracteres.

        Nota

        O ApsaraDB for MongoDB permite redefinir senhas de contas dos nós ConfigServer e Shard. Para mais informações, consulte Reset a password.

        Confirm Password

        Insira a senha novamente para confirmar.

      4. Clique em Confirm.

    3. Crie o endpoint de Shard.

      1. No painel de navegação à esquerda, clique em Database Connections.

      2. Na seção Private Endpoint - VPC, clique em Apply for Shard Endpoint.

      3. No painel Apply for Shard Endpoint, defina os seguintes parâmetros.

        Parâmetro

        Descrição

        Node Type

        Este parâmetro é fixo como Shard.

        Select Node ID

        Selecione o ID do nó que precisa de um endpoint.

      4. Clique em OK.

    4. Na página Database Connections, visualize o novo endpoint.

      1. Aguarde o status da instância mudar de Establishing Network Connection para Running.

      2. Na seção Private Endpoint - VPC, visualize o endpoint do nó.

    Instância com disco local

    Nota

    Alternativamente, acesse a página Basic Information da instância, localize a seção Shard List e clique em Add Shard. Selecione a opção para ativar uma conexão direta ao Shard e solicite o endpoint na seção Apply for Shard Private Endpoint.

    1. Acesse a lista de instâncias de cluster sharded do ApsaraDB for MongoDB. No topo da página, selecione um grupo de recursos e uma região e clique em ID da instância desejada.

    2. No painel de navegação à esquerda, clique em Database Connections.

    3. Na seção Private Endpoint - VPC, clique em Apply for Shard Endpoint.

    4. No painel Apply for Shard Endpoint, defina os seguintes parâmetros.

      Parâmetro

      Descrição

      Node Type

      Este parâmetro é fixo como Shard.

      Select Node ID

      Selecione o ID do nó que precisa de um endpoint.

      Account Name

      O nome da conta deve atender aos seguintes requisitos:

      • Começar com uma letra minúscula.

      • Conter apenas letras minúsculas, dígitos e underscores (_).

      • Ter entre 4 e 16 caracteres.

      Nota

      • Palavras-chave reservadas não podem ser usadas como nome de conta no ApsaraDB for MongoDB.

      • A conta possui permissões fixas de somente leitura.

      • Defina o nome e a senha da conta apenas na primeira solicitação de endpoint para um nó Shard ou ConfigServer. Isso não é necessário para solicitações posteriores.

      Account Password

      A senha deve atender aos seguintes requisitos:

      • Conter caracteres de pelo menos três dos seguintes tipos: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais.

        Os caracteres especiais suportados são !@#$%^&*()_+-=.

      • Ter entre 8 e 32 caracteres.

      Nota

      O ApsaraDB for MongoDB permite redefinir senhas de contas dos nós ConfigServer e Shard. Para mais informações, consulte Reset a password.

      Confirm Password

      Insira a senha novamente para confirmar.

    5. Clique em OK.

    6. Na página Database Connections, visualize o novo endpoint.

      1. Aguarde o status da instância mudar de Establishing Network Connection para Running.

      2. Na seção Private Endpoint - VPC, visualize o endpoint do nó.

    Tópicos relacionados

    Para liberar um endpoint de Shard que não seja mais necessário, consulte Release a Shard or ConfigServer node endpoint.