Overview
En esta sección, puede identificar los cambios esenciales que debe realizar en su aplicación cuando actualice su proveedor a una nueva versión.
Antes de actualizar, realice las siguientes acciones:
Asegúrese de que la nueva versión sea compatible con la versión de MongoDB Server a la que se conecta su aplicación y con la versión de .NET en la que se ejecuta. Consulte Página de compatibilidad para esta información.
Resuelve cualquier cambio disruptivo entre la versión actual del proveedor que utiliza tu aplicación y la versión de actualización planificada en la sección Cambios disruptivos.
Cambios radicales
Un cambio disruptivo es una modificación de una convención o comportamiento que se inicia en una versión específica del proveedor. Este tipo de cambio podría impedir el correcto funcionamiento de la aplicación si no se soluciona antes de actualizar el proveedor.
Los cambios importantes de esta sección se clasifican según la versión del proveedor que los introdujo. Al actualizar las versiones del proveedor, aborde todos los cambios importantes entre la versión actual y la de actualización. Por ejemplo, si actualiza el proveedor8.0 de8.5 la versión 7600 a la 7800, aborde todos los cambios importantes de la versión posterior a la8.0 8000, incluidos los que aparecen en la versión8.5 8200.
Cambios importantes en la versión 8.1.0
Se actualizó el proveedor principal de EF para que ejecute todos los cambios como transacciones de MongoDB. Si su aplicación usa MongoDB Server anterior a la versión 76005.0 o no se ejecuta en un conjunto de réplicas, debe realizar los siguientes cambios:
Si tu aplicación está configurada para una versión anterior a MongoDB Server v5.0, debes actualizar a MongoDB Server v5.0 o posterior.
Si su aplicación se ejecuta en un servidor independiente, debe reconfigurarlo para convertirlo en un conjunto de réplicas de instancia única. Para obtener más información sobre cómo reconfigurar su servidor independiente, consulte "Convertir un mongod autogestionado independiente en un conjunto de réplicas" en el manual del servidor MongoDB.
Si su aplicación se ejecuta en un entorno de contenedores, cambie a un contenedor de conjunto de réplicas de instancia única si hay uno disponible.
Para evitar problemas con las instantáneas durante las transacciones, llame al
EnsureCreated()o el métodoEnsureCreatedAsync()durante el inicio de su aplicación, en lugar de crear la colección o base de datos implícitamente.Nota
Llamar al
EnsureCreated()métodoEnsureCreatedAsync()o genera un error si la aplicación se ejecuta en un clúster compartido. Las aplicaciones que se ejecutan en clústeres libres y compartidos no deben llamar a estos métodos.Si no desea garantizar una concurrencia optimista con las transacciones, puede deshabilitar las transacciones automáticas configurando
Database.AutoTransactionBehavior = AutoTrasactionBehavior.NeverDbContexten su subclase durante la configuración de su aplicación.Se cambió el formato de almacenamiento predeterminado de GUID de formato binario
CSharpLegacya formatoStandard. Si su base de datos contiene GUID que no están en formatoStandard, le recomendamos convertirlos a formatoStandard.El
CamelCaseElementNameConventionconvierte la mayúscula y minúscula de las entidades propias según el nombre de su propiedad en lugar del nombre de su clase. Si su aplicación usa elCamelCaseElementNameConvention, la mayúscula y minúscula de sus datos podría cambiar.
Para obtener más información sobre los cambios importantes en esta versión, consulte la sección Cambios importantes del repositorio del proveedor en GitHub.