Usar o MongoDB Shell para se conectar ao Azure Cosmos DB for MongoDB (vCore)

APLICA-SE AO: MongoDB vCore

O MongoDB Shell (mongosh) é um ambiente JavaScript e Node.js para interação com implantações do MongoDB. É uma ferramenta popular da comunidade para testar consultas e interagir com os dados no banco de dados do Azure Cosmos DB for MongoDB.

Pré-requisitos

• Um cluster existente do Azure Cosmos DB for MongoDB (arquitetura vCore).

• Uma versão instalada do MongoDB Shell do site da comunidade.

• Configuração das variáveis de ambiente pós-instalação necessárias para o seu sistema operacional.

• Configurações de firewall que permitem que o computador se conecte. Siga as diretrizes para configurar o firewall para o Azure Cosmos DB.

  Você pode optar por permitir solicitações de seu endereço IP atual, solicitações de serviços de nuvem ou solicitações de máquinas virtuais (intervalos de IP específicos).

  

  Se você abrir acidentalmente todas as portas, você receberá um aviso antes de salvar as alterações.

Conectar usando o MongoDB Shell

Para adicionar o seu cluster do Azure Cosmos DB ao MongoDB Shell, execute as seguintes etapas:

1. Recupere as informações de conexão da instância do Azure Cosmos DB for MongoDB (vCore) usando estas instruções.

   

2. Conecte-se usando um destes métodos:

   • Insira a senha no prompt do Mongo Shell. Sua cadeia de conexão é semelhante a este exemplo:

     "mongodb+srv://<username>@<servername>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"
     

     O comando é semelhante a este exemplo:

     mongosh "mongodb+srv://testuser@mongodbvcoretesting.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000
     

     

     Depois de fornecer a senha e ser autenticado com sucesso, este aviso será exibido: "Este servidor ou serviço parece ser uma emulação do MongoDB". Você pode ignorá-la. Este aviso é gerado porque a cadeia de conexão contém cosmos.azure. O Azure Cosmos DB é uma oferta de plataforma como serviço (PaaS) nativa do Azure.

   • Forneça a senha como parte da cadeia de conexão. O formato é semelhante a este exemplo:

     mongosh "mongodb+srv://<SERVERNAME>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "<USER>" -password "<PASSWORD>"
     

     O comando é semelhante a este exemplo:

     mongosh "mongodb+srv://mongodbvcoretesting.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "testuser" -password "******"
     

     

Próxima etapa

Opções de migração