Todos os produtos
Search

Este produto

    ApsaraDB for MongoDB:Connect to an instance

    Central de documentação

    ApsaraDB for MongoDB:Connect to an instance

    Última atualização: Aug 25, 2026

    Conecte-se à sua instância do ApsaraDB for MongoDB usando o DMS, o MongoDB Shell (mongosh) ou código de aplicação.

    Pré-requisitos

    Procedimento

    DMS

    1. Acesse a página de instâncias de conjunto de réplicas do ApsaraDB for MongoDB ou de instâncias de cluster fragmentado 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 canto superior direito, clique em Log on to Database.

      • Para instância de conjunto de réplicas: selecione Primary na lista suspensa.

        Nota

        Os nós secundários são somente leitura. Para gravar dados, selecione Primary.

      • Para instância de cluster fragmentado: selecione qualquer nó na lista suspensa.

      • Para instância autônoma: o DMS abre diretamente.

    3. Na caixa de diálogo Log on to Database Instance, insira a Database Account e a Database Password. Mantenha os demais campos com os valores padrão.

      Nota

      Se você esqueceu ou ainda não definiu uma senha, redefina a senha.

    4. Clique em Test Connectivity. Na caixa de diálogo de sucesso, clique em Confirm.

    5. Clique em Login.

    Nota

    Ao consultar dados pelo DMS, o tamanho máximo de um único documento é de 512 KB. Não é possível ajustar esse limite. Para consultar documentos maiores, use o MongoDB Shell.

    MongoDB Shell

    Instale o MongoDB Shell

    O MongoDB oferece duas ferramentas de CLI: o MongoDB Shell (mongosh) e o shell mongo legado. Este guia utiliza o mongosh.

    1. No seu cliente, baixe o MongoDB Shell.

    2. Instale o mongosh.

    Obter uma string de conexão

    1. Acesse a página de instâncias de conjunto de réplicas do ApsaraDB for MongoDB ou de instâncias de cluster fragmentado 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 da página de detalhes da instância, clique em Database Connections.

    3. Na página Database Connections, copie a string de conexão.

      Este exemplo utiliza a High-availability Connection String URI da Private Connection - VPC. Para conectar-se pela internet, solicite um endpoint público primeiro:

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

      Substitua root:**** pelas suas credenciais reais. Caso tenha esquecido a senha, redefina a senha.

    Conectar-se ao banco de dados

    Execute este comando no seu cliente para estabelecer a conexão:

    Nota

    Se estiver usando o shell mongo legado, substitua mongosh por mongo.

    mongosh "<your_connection_string_uri>"

    Exemplo com a conta root, senha PassWord123! e 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****"

    Codifique caracteres especiais nas credenciais usando codificação de URL. Por exemplo, ! torna-se %21. Como resolver falhas de conexão causadas por caracteres especiais em nome de usuário ou senha?

    Code

    Próximas etapas

    Gravar dados

    Documentos relacionados

    Evite usar a conta root em produção. Crie contas dedicadas com as permissões adequadas. Contas com permissões insuficientes retornam erros como Exception authenticating....