Todos os produtos
Search

Este produto

    ApsaraDB for MongoDB:Conectar-se a uma instância

    Central de documentação

    ApsaraDB for MongoDB:Conectar-se a uma instância

    Última atualização: Jun 26, 2026

    Após criar uma instância do ApsaraDB for MongoDB, conecte-se a ela usando uma ferramenta cliente.

    Pré-requisitos

    Procedimento

    DMS

    1. Acesse a página de instâncias de conjunto de réplicas do ApsaraDB for MongoDB ou a página de instâncias de cluster fragmentado do ApsaraDB for MongoDB. Na parte superior da página, selecione um grupo de recursos e uma região. Em seguida, clique em ID da instância desejada.

    2. No canto superior direito da página, clique em Log On.

      • Para instância de conjunto de réplicas: na lista suspensa, selecione Primary. O sistema redireciona você ao console do Data Management (DMS).

        Nota

        Os nós secundários suportam apenas operações de leitura. Para gravar dados, selecione o nó primário.

      • Para instância de cluster fragmentado: na lista suspensa, selecione qualquer nó. O sistema redireciona você ao console do DMS.

      • Para instância autônoma: nenhuma seleção é necessária. O sistema redireciona você ao console do DMS.

    3. Na caixa de diálogo Log on to Database Instance do console do DMS, insira a Database Account e a Database Password. Mantenha as demais configurações com os valores padrão.

      Nota

      Caso tenha esquecido a senha ou não a tenha definido durante a criação da instância, acesse o console do ApsaraDB for MongoDB para redefinir a senha.

    4. Clique em Test Connection. Na caixa de diálogo de sucesso, clique em OK.

    5. Clique em Login.

    Nota

    Ao consultar dados pelo DMS, o tamanho máximo de um único documento é de 512 KB. Esse limite não pode ser ajustado. Para consultar documentos maiores, use o MongoDB Shell.

    MongoDB Shell

    Instale o MongoDB Shell em um dispositivo local ou em uma instância ECS

    O MongoDB oferece duas ferramentas de interface de linha de comando (CLI): MongoDB Shell (mongosh) e mongo shell. O mongo shell é a ferramenta cliente legada, enquanto o MongoDB Shell é a versão atualizada. Este tópico usa o MongoDB Shell como exemplo.

    1. No seu cliente, baixe o MongoDB Shell.

    2. Instale o mongosh.

    Obter um endereço de conexão

    1. Acesse a página de instâncias de conjunto de réplicas do ApsaraDB for MongoDB ou a página de instâncias de cluster fragmentado do ApsaraDB for MongoDB. Na parte superior da página, selecione um grupo de recursos e uma região. Em seguida, clique em ID da instância desejada.

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

    3. Na página Database Connections, obtenha o endereço de conexão necessário.

      Este tópico usa o High-availability Connection String URI na seção Private Connection - VPC como exemplo. Para conectar-se à instância pela internet, primeiro solicite um endpoint público.

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

      Substitua root:**** pela conta e senha do banco de dados. Caso tenha esquecido a senha ou não a tenha definido ao criar a instância, acesse o console do ApsaraDB for MongoDB para redefinir a senha.

    Conectar-se ao banco de dados

    No cliente, execute o seguinte comando para conectar-se à instância do MongoDB.

    Nota

    Se estiver usando o mongo shell, substitua mongosh por mongo no comando.

    mongosh "<High-availability connection string URI>"

    O exemplo a seguir mostra como conectar-se à instância. A conta do banco de dados é root, a senha é PassWord123! e o banco de dados de autenticação é admin.

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

    Caracteres especiais na senha da string de conexão devem ser escapados. Por exemplo, o ponto de exclamação (!) na senha do exemplo deve ser escapado como %21. Para mais informações, consulte Como resolver uma falha de conexão causada por caracteres especiais no nome de usuário ou senha de uma string de conexão?

    Código do programa

    Próxima etapa

    Gravar dados

    Referências

    Não use a conta root para conectar-se a uma instância em ambiente de produção. Em vez disso, crie outras contas de banco de dados e conceda a elas as permissões necessárias. Se você se conectar a uma instância usando uma conta sem as permissões adequadas, não conseguirá executar operações no banco de dados. Uma mensagem de erro como Exception authenticating... será retornada.