Compartir vía


Actualización de la versión de API de la cuenta de Azure Cosmos DB for MongoDB

SE APLICA A: MongoDB

En este artículo se describe cómo actualizar la versión de API de la cuenta de API de Azure Cosmos DB para MongoDB. Tras su actualización, podrá utilizar las últimas funcionalidades de la API de Azure Cosmos DB para MongoDB. El proceso de actualización no interrumpe la disponibilidad de la cuenta y no consume RU/s ni reduce la capacidad de la base de datos en ningún momento. Este proceso no afecta a los datos o índices existentes.

Cuando actualice a una nueva versión de la API, comience con cargas de trabajo de desarrollo y pruebas antes de actualizar las cargas de trabajo de producción. Es importante actualizar sus clientes a una versión compatible con la versión de la API a la que se está actualizando antes de actualizar su cuenta de Azure Cosmos DB para MongoDB.

Advertencia

En este momento, solo las cuentas aptas que usan la versión 3.2 del servidor se pueden actualizar a la versión 3.6 o superior. Si la cuenta no muestra la opción de actualización, abra una incidencia de soporte técnico.

Actualización de la versión

  1. Inicie sesión en Azure Portal.

  2. Vaya a la cuenta de Azure Cosmos DB for MongoDB. Abra el panel de Información general y compruebe que la versión actual del Servidor sea 3.2 o 3.6.

    Captura de pantalla de cómo comprobar la versión actual de su cuenta MongoDB desde el portal Azure.

  3. En el menú de la izquierda, abra el panel Features. Este panel muestra las características de nivel de cuenta que están disponibles para su cuenta de base de datos.

  4. Seleccione la fila Upgrade MongoDB server version. Si no ve esta opción, es posible que la cuenta no sea válida para esta actualización. En ese caso, abra una incidencia de soporte técnico.

    Captura de pantalla de la página de características a0 actualizar la cuenta.

  5. Consulte la información que se muestra sobre esta actualización específica. Seleccione Set server version to 4.2 (o 4.0 o 3.6 según la versión actual).

    Captura de pantalla de la guía de actualización y la opción seleccionar actualización.

  6. Después de iniciar la actualización, el menú de Características aparece atenuado y el estado se establece en Pendiente. Esta actualización tarda unos 15 minutos en completarse. Este proceso no afectará a la funcionalidad u operaciones existentes de la cuenta de base de datos. Una vez que haya finalizado, el estado de la versión de actualización del servidor MongoDB mostrará la versión actualizada. Póngase en contacto con el soporte técnico si se produce alguna incidencia al procesar la solicitud.

  7. A continuación se indican algunas consideraciones después de actualizar la cuenta:

    1. Si ha realizado la actualización desde la versión 3.2, vuelva al panel Información general y copie la nueva cadena de conexión que va a usar en la aplicación. No se interrumpe la cadena de conexión anterior que ejecuta la versión 3.2. Para garantizar una experiencia coherente, todas las aplicaciones deben usar el nuevo punto de conexión.

    2. Si ha actualizado desde la versión 3.6, la cadena de conexión existente se actualizará a la versión especificada y debe seguir utilizándose.

Importante

Para la actualización desde la versión 3.2, el sufijo del punto de conexión de la cuenta de base de datos se actualizará al formato siguiente: <your_database_account_name>.mongo.cosmos.azure.com. Es posible que este punto de conexión tenga ligeras diferencias si la cuenta se ha creado en una nube de Azure soberana, gubernamental o restringida.

Si está actualizando desde la versión 3.2, tendrá que reemplazar el punto de conexión existente en las aplicaciones y los controladores que se conectan con esta cuenta de base de datos. Solo las conexiones que usan el nuevo punto de conexión tendrán acceso a las características de la nueva versión de API. El punto de conexión 3.2 anterior debe tener el sufijo .documents.azure.com. Al actualizar de la versión 3.2 a versiones más recientes, los índices compuestos ahora son necesarios para realizar operaciones de ordenación en varios campos que garanticen un rendimiento estable y alto de estas consultas. Asegúrese de que se crean estos índices compuestos para que la ordenación de varios campos se realice correctamente.

Degradación de la versión

También puede cambiar su cuenta a la versión 4.0 o 3.6 a través de los mismos pasos de la sección actualización de la versión.

  1. Si ha actualizado desde la versión 3.2 y desea cambiar de nuevo a la versión 3.2, simplemente puede volver a usar la cadena de conexión anterior (3.2) con el host accountname.documents.azure.com, que permanece activo después de la actualización que ejecuta la versión 3.2.

  2. Cambie la cadena de conexión en su aplicación.