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

  • Artículo

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. Después de la actualización, puede usar la funcionalidad más reciente 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 afectará a los índices o datos 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 los clientes a una versión compatible con la versión de API a la que se va a actualizar antes de actualizar la cuenta de Azure Cosmos DB for MongoDB.

Nota

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 a 4.2, 4.0 o 3.6

Ventajas de la actualización a la versión 4.2:

  • Varias mejoras importantes en la canalización de agregación, como la compatibilidad con $merge, trigonometría, expresiones aritméticas, etc.
  • Compatibilidad con el cifrado del lado cliente que protege aún más la base de datos al permitir que los campos individuales se cifren de forma selectiva y mantener la privacidad de los datos cifrados de los usuarios de la base de datos y los proveedores de hospedaje.

Ventajas de la actualización a la versión 4.0

A continuación se describen las nuevas características incluidas en la versión 4.0:

  • Compatibilidad con transacciones de varios documentos en colecciones no particionadas.
  • Nuevos operadores de agregación
  • Rendimiento de análisis mejorado
  • Almacenamiento más rápido y más eficiente

Ventajas de la actualización a la versión 3.6

A continuación se describen las nuevas características incluidas en la versión 3.6:

  • Rendimiento y estabilidad mejorada
  • Compatibilidad con los nuevos comandos de base de datos
  • Compatibilidad con la canalización de agregación de forma predeterminada y nuevas fases de agregación
  • Compatibilidad con flujos de cambios
  • Compatibilidad con índices compuestos
  • Compatibilidad entre particiones para las operaciones siguientes: actualización, eliminación, recuento y ordenación
  • Rendimiento mejorado para las siguientes operaciones de agregado: $count, $skip, $limit y $group
  • Ahora se admite la indexación con caracteres comodín

Cambios con respecto a la versión 3.2

  • De forma predeterminada, la característica de reintentos de servidor (SSR) está habilitada, por lo que las solicitudes de la aplicación cliente no devolverán 16 500 errores. En su lugar, las solicitudes se reanudarán hasta que finalicen o cumplan el tiempo de espera de 60 segundos.
  • El tiempo de espera de cada solicitud se establece en 60 segundos.
  • Las colecciones de MongoDB creadas con la nueva versión del protocolo de conexión solo tendrán la propiedad _id indexada de forma predeterminada.

Acción obligatoria al actualizar desde la versión 3.2

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

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.

Nota:

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.

Procedimiento de actualizació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.

    Compruebe la versión actual de la cuenta de MongoDB desde el Azure Portal.

  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.

    Abra la hoja Características y actualice su 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).

    Revise la guía de actualización y seleccione Actualizar.

  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 interrumpirá 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.

Cambio a una versión anterior

También puede cambiar a una versión anterior (versión 4.0 o 3.6) la cuenta mediante los mismos pasos de la sección "Procedimiento de actualización".

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.

Pasos siguientes