Compartir a través de

Uso del Shell de MongoDB para conectarse a Azure Cosmos DB para MongoDB (vCore)

SE APLICA A: núcleo virtual de MongoDB

El Shell de MongoDB (mongosh) es un entorno de JavaScript y Node.js para interactuar con las implementaciones de MongoDB. Es una herramienta popular de la comunidad para probar consultas e interactuar con los datos de la base de datos de Azure Cosmos DB for MongoDB.

Requisitos previos

  • Un clúster existente de Azure Cosmos DB for MongoDB (arquitectura de núcleo virtual).

  • Una versión instalada del Shell de MongoDB desde el sitio de la comunidad.

  • Configuración de las variables de entorno posteriores a la instalación necesarias para el sistema operativo.

  • Configuración del firewall que permite que la máquina se conecte. Siga las instrucciones para configurar el firewall para Azure Cosmos DB.

    Puede optar por permitir las solicitudes de la dirección IP actual, las solicitudes de los servicios en la nube o las solicitudes de máquinas virtuales (intervalos IP específicos).

    Animación que muestra una actualización de la configuración del firewall para Azure Cosmos DB for MongoDB en la arquitectura de núcleo virtual.

    Si abre accidentalmente todos los puertos, se le advierte antes de guardar los cambios.

Conexión mediante el Shell de MongoDB

Para agregar el clúster de Azure Cosmos DB al Shell de MongoDB, siga estos pasos:

  1. Recupere la información de conexión para la instancia de Azure Cosmos DB for MongoDB (vCore) utilizando estas instrucciones.

    Animación que muestra las selecciones para obtener una cadena de conexión.

  2. Conéctese mediante cualquiera de estos métodos:

    • Escriba la contraseña en el símbolo del sistema del Shell de Mongo. La cadena de conexión tiene el siguiente aspecto:

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

      El comando tiene el siguiente aspecto:

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

      Animación que muestra cómo conectarse escribiendo una contraseña.

      Después de proporcionar la contraseña y autenticarse correctamente, aparece esta advertencia: "Este servidor o servicio parece ser una emulación de MongoDB". Puede pasarla por alto. Esta advertencia se genera porque la cadena de conexión contiene cosmos.azure. Azure Cosmos DB es una oferta nativa de plataforma como servicio (PaaS) de Azure.

    • Proporcione la contraseña como parte de la cadena de conexión. El formato tiene el siguiente aspecto:

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

      El comando tiene el siguiente aspecto:

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

      Captura de pantalla que muestra una contraseña como parte de una cadena de conexión.

Paso siguiente

Opciones de migración