Editar

Compartir a través de


Conectar una aplicación de MongoDB a Azure Cosmos DB

SE APLICA A: MongoDB

Aprenda a conectar su aplicación de MongoDB a una instancia de Azure Cosmos DB mediante una cadena de conexión de MongoDB. Después, puede usar una base de datos de Azure Cosmos DB como almacén de datos de la aplicación MongoDB.

En este tutorial se proporcionan dos maneras de recuperar información de la cadena de conexión:

Requisitos previos

Hay dos elementos necesarios

Obtención de la cadena de conexión de MongoDB mediante el menú de inicio rápido

Siga los pasos siguientes:

  1. En un explorador de Internet, inicie sesión en Azure Portal.

  2. En el panel Azure Cosmos DB, seleccione la API.

  3. En el panel izquierdo del panel de la cuenta, seleccione Inicio rápido.

  4. Elija la plataforma ( .NET, Node.js, Shell de MongoDB, Java, Python). Si no ve el controlador o la herramienta en la lista, no se preocupe, documentamos constantemente más fragmentos de código de conexión. Comente lo que le gustaría ver. Para aprender a crear su propia conexión, lea la sección sobre cómo obtener información de la cadena de conexión de la cuenta.

  5. Copie y pegue el fragmento de código en la aplicación MongoDB.

Obtención de la cadena de conexión de MongoDB para personalizar

Siga los pasos siguientes:

  1. En un explorador de Internet, inicie sesión en Azure Portal.

  2. En el panel Azure Cosmos DB, seleccione la API.

  3. En el panel izquierdo del panel de la cuenta, seleccione Cadenas de conexión.

  4. Se abre el panel Cadenas de conexión. que contiene toda la información necesaria para conectarse a la cuenta con un controlador para MongoDB, incluida una cadena de conexión precreada.

    Requisitos de la cadena de conexión

    Importante

    Azure Cosmos DB tiene estándares y requisitos de seguridad estrictos. Las cuentas de Azure Cosmos DB requieren autenticación y comunicación segura mediante TLS.

    Azure Cosmos DB es compatible con el formato URI de la cadena de conexión de MongoDB estándar con un par de requisitos específicos: Las cuentas de Azure Cosmos DB requieren autenticación y comunicación segura mediante TLS. El formato de la cadena de conexión es:

    mongodb://username:password@host:port/[database]?ssl=true

    Los valores de esta cadena son:

    • Username (obligatorio): nombre de la cuenta de Azure Cosmos DB.
    • Password (obligatorio): contraseña de la cuenta de Azure Cosmos DB.
    • Host (obligatorio): FQDN de la cuenta de Azure Cosmos DB.
    • Port (obligatorio): 10255.
    • Database (opcional): base de datos que usa la conexión. Si no se proporciona ninguna base de datos, la base de datos predeterminada es "test".
    • ssl=true (obligatorio).

    Por ejemplo, considere la cuenta que aparece en el panel Cadenas de conexión. Una cadena de conexión válida es:

    mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.com:10255/mydatabase?ssl=true

    Requisitos para controladores

    Todos los controladores que admitan la versión 3.4 o posteriores del protocolo de conexión admitirán Azure Cosmos DB for MongoDB.

    • Los controladores de cliente deben admitir la extensión TLS de la identificación de nombre de servicio (SNI) o la opción de cadena de conexión appName.
    • Si se proporciona el parámetro appName, debe incluirse como se encuentra en el valor de la cadena de conexión en Azure Portal.