Novedades

Introduce la opción socks5-proxy funcionalidad, que permite conectar a la base de datos mediante un proxy SOCKS5. Puedes configurar esta funcionalidad usando las opciones de cadena de conexión proxyHost, proxyPort, proxyUsername y proxyPassword o el campo ClientOptions::socks5_proxy.

Añade compatibilidad con cursores de lotes sin procesar. Estos cursores permiten iterar sobre lotes de documentos sin procesar devueltos por el servidor, en lugar de valores deserializados individuales. Para obtener más información sobre los cursores de lotes sin procesar, consulte Use la sección Raw agrupar Cursor de la guía Cursor y la raw_batch_cursor Documentación de la API.

Se desaprueba especificar la autenticación de AWS en el nombre de usuario y la contraseña de la cadena de conexión y en la propiedad AWS_SESSION_TOKEN. Esta funcionalidad se eliminará en la siguiente versión principal del driver. Para obtener más información sobre la autenticación de AWS, consulta la sección MONGODB-AWS Mechanism de la guía de autenticación.

La opción está obsoleta. Utilice la opción en su socketTimeoutMS wTimeoutMS lugar. Para obtener más información sobre las opciones de conexión disponibles, consulte la guía de opciones de conexión.

Introducción a la creación de queries de búsqueda de MongoDB (MongoDB Search) seguros en cuanto a tipos a través del módulo atlas_search. Esta funcionalidad ofrece validación en tiempo de compilación, soporte IDE y un patrón de creación fluida para la construcción de queries de búsqueda en MongoDB Search. Para aprender más sobre queries de búsqueda seguros en cuanto a tipo en MongoDB, consulta la sección Construcción de queries seguros en cuanto a tipo de la guía Ejecutar un MongoDB Search Query.

Agrega compatibilidad para rastrear comandos de base de datos y operaciones del controlador para OpenTelemetry.

Añade compatibilidad con índices de texto para el cifrado consultable automático y explícito. Para obtener más información sobre el cifrado consultable, consulte la sección Cifrado consultable del manual de MongoDB Server.

Importante: Esta nueva versión descarta la compatibilidad con la versión 4.0 de MongoDB Server y eleva la versión mínima soportada a 4.2. Recomendamos realizar cambios en tu aplicación para adaptarla a los cambios disruptivos. Consulta la sección Notas de la versión en el manual del servidor para obtener más información sobre la actualización.

Se introduce la compatibilidad con la versión 3.0 del paquete BSON. De forma predeterminada, el controlador usa la versión 2.15 para compatibilidad con versiones anteriores. Para usar la versión 3.0, agregue la función bson-3 a la lista features del paquete del controlador en el archivo Cargo.toml de su proyecto. BSON 3.0 actualiza varias API de forma incompatible con versiones anteriores. Los siguientes cambios podrían requerir actualizaciones en su aplicación:

• Introduce un tipo unificado bson::error::Error que consolida la gestión de errores en toda la caja con campos consistentes y una información de errores detallada.

• Agrega los tipos &CStr y CString para claves BSON y expresiones regulares para evitar problemas de bytes nulos que anteriormente provocaban pánicos. El siguiente ejemplo muestra cómo actualizar su código utilizando los tipos &CStr y CString:

  let mut computed_key = "foo".to_owned();
  computed_key.push_str("bar");
  // Non-static values need to be checked at runtime
  let computed_key = CString::try_from(computed_key)?;
  let doc_buf = rawdoc! {
     // String literal keys in `rawdoc!` are implicitly checked at compile-time.
     "hello": "world",
     computed_key: 42,
     "regex": Regex {
         // `&CStr` implements many common traits like `ToOwned`
         pattern: cstr!("needle").to_owned(),
         options: cstr!("").to_owned(),
     }
  };
  // `append` keys must now be a `&CStr` or `CString`.
  doc_buf.append(cstr!("a key"), "a value");

• Proporciona todas las conversiones entre tipos sin procesar y sus tipos de referencia a través de los rasgos de la biblioteca estándar.

• Hace que serde sea una funcionalidad opcional que está deshabilitada por defecto. Las funciones de serialización y deserialización ahora tienen prefijos serialize_to o deserialize_from para mayor claridad.

• Simplifica la decodificación con pérdida UTF-8 con el tipo contenedor Utf8Lossy y los nuevos métodos de conversión.

• Actualiza serde las funciones auxiliares para trabajar con la serde_as anotación del serde_with caja para realizar conversiones de tipo más flexibles. Para más información, vea Modelado de datos y serialización.

• Para obtener instrucciones detalladas sobre cómo migrar de BSON 2.x a BSON 3.0, consulta la Guía de migración de 2.x a 3.0 en GitHub.

Importante: La próxima versión menor dejará de ser compatible con la versión del servidor MongoDB 4.0 y aumentará la versión mínima compatible a la 4.2. Recomendamos realizar cambios en tu aplicación para adaptarla a los cambios disruptivos. Consulta la sección Notas de la versión en el manual del servidor para obtener más información sobre la actualización.

Aumenta la versión mínima de Rust compatible a 1.71.1. Para obtener más información sobre la compatibilidad de drivers, consulta la página de Compatibilidad.

Marca la funcionalidad de encriptación en uso como estable con las mismas garantías de compatibilidad con versiones anteriores que el driver. El funcionalidad flag se llama in-use-encryption. Este es un cambio de política y la API no cambia respecto a la versión anterior.

Permite nombres de host SRV con menos de tres partes.

Le permite proporcionar una opción de clasificación al realizar operaciones de actualización.

Agrega soporte de autenticación OIDC para entornos Kubernetes.

Para usar OIDC para autenticarse desde un entorno de Kubernetes, configure la opción de conexión authMechanismProperties como ENVIRONMENT:k8s en su cadena de conexión. Puede usar esta función al conectarse a un entorno que se ejecute en Elastic Kubernetes Service de Amazon, Google Kubernetes Engine o Azure Kubernetes Service.

Añade compatibilidad con más de un proveedor de Servicios de Administración de Claves (KMS) del mismo tipo. Para obtener más información sobre los proveedores de KMS, consulte Cifrado Consultable en el manual de MongoDB Server.

Se añade compatibilidad con v2 del protocolo de rango de cifrado consultable. Los índices de rango para cifrado consultable ahora están disponibles con disponibilidad general.

Agrega el campo type al tipo SearchIndexModel para permitir la creación programática de índices de MongoDB Search y MongoDB Vector Search. Para aprender más, consulta la guía MongoDB Search e Índices Vectoriales.

Implementa el algoritmo Happy Eyeballs para gestionar conexiones TCP. Para más información sobre este algoritmo, consulta la documentación de Rust del paquete happy_eyeballs.

El driver publica un evento TopologyDescriptionChangedEvent cuando se cierra una topología.

Corrige un problema en el cual las agregaciones no se compilaban cuando se ejecutaban dentro de sesiones explícitas y también se implementaban tipos personalizados.

Corrige un problema en el que el método Collection::watch() no utilizaba el parámetro de tipo de la instancia Collection en la que se ejecutaba.

Implementa una API fluida, que introduce los siguientes cambios de sintaxis para pasar opciones e iniciar sesiones:

• Para establecer opciones de método asíncrono, encadena los métodos del generador de opciones directamente a la llamada al método en lugar de pasar un parámetro de estructura de opciones.

• Para establecer opciones del método sincrónico, encadene métodos de creación de opciones a la llamada del método y, luego, llame al método run().

• Si necesitas construir una estructura de opciones separada, encadena el método with_options() a la llamada del método y pasa tu estructura de opciones como parámetro.

• Para iniciar una sesión, encadena el método session() a la llamada del método en lugar de usar un método separado que tenga un sufijo _with_session.

Añade compatibilidad con operaciones de escritura masiva. Para obtener más información sobre estas operaciones, consulte la guía de operaciones masivas.

Introduce el tipo EventHandler para reducir la cantidad de código boilerplate necesaria para la supervisión de eventos. Para ejemplos que utilizan el tipo EventHandler, consulta las guías en la sección supervisión.

Se remueve la compatibilidad con el tiempo de ejecución asíncrono async-std. Para obtener más información sobre este cambio, consulte la sección Configurar el entorno de ejecución asíncrono de la guía de las API asíncronas y síncronas.

Requiere el uso de la función compat si una aplicación de controlador de Rust se compila con el indicador de línea de comandos no-default-features. Las funciones rustls y dns-resolution ahora son opcionales.

Se remueve el soporte para las funcionalidades del driver bson-*. Puede seleccionar estas funcionalidades incluyendo bson como una dependencia directa en su aplicación.

Se elimina el soporte para las constantes de nivel de confirmación de lectura y nivel de confirmación de escritura (write concern). En su lugar, utiliza métodos asistentes para establecer los valores de ReadConcern y WriteConcern.

Agrega restricciones Send + Sync al tipo Collection<T>.

Elimina el campo ClientOptions::compressor si no hay funciones de compresor habilitadas.

Cambia el tipo de los campos ReadPreferenceOptions. Estos campos ahora son de tipo Option<ReadPreferenceOptions>.

Elimina la opción CollectionOptions::human_readable_serialization. En su lugar, utiliza el tipo bson::HumanReadable contenedor para serializar los datos de usuario en un formato legible para las personas.

Añade soporte para la conversión de valores mediante el rasgo Into para todos los generadores de structs de opción.

Cambia el nombre del campo comment_bson a comment para las estructuras AggregateOptions, FindOptions y FindOneOptions.

Añade métodos de gestión de índices de MongoDB Search. Para obtener más información sobre estos métodos, consulte la guía de índices de MongoDB Search y Vector Search.

Mejora la conectividad de red y la fiabilidad de las operaciones implementando los siguientes comportamientos:

• Realiza reintentos en un mayor rango de tipos de errores que el controlador encuentre.

• Evita reintentos para instancias de mongos que experimentan problemas de conectividad de red.

Agrega la opción human_readable_serialization a la estructura CollectionOptions. Esta opción indica al controlador que serialice los valores pasados a los métodos CRUD en un formato legible para los humanos. El valor por defecto de esta opción es false.

Añade el run_cursor_command() método para ejecutar un comando de base de datos y obtener la respuesta como Cursor tipo. Para obtener más información,consulte la guía "Ejecutar un comando".

Agrega el registro de eventos SDAM cuando utiliza el indicador de función tracing-unstable.

Agrega las siguientes configuraciones para Client y la gestión de la conexión:

• max_connecting: una opción que puedes configurar en una estructura ClientOptions para especificar cuántas conexiones puedes establecer en paralelo. Para obtener más información sobre esta opción, consulta pool de conexiones en la guía Consideraciones de rendimiento.

• Client::warm_connection_pool(): un método que permite crear nuevas conexiones en el grupo de conexiones para proporcionar un rendimiento más predecible. Al usar este método, el controlador intenta crear conexiones hasta el número especificado en la configuración min_pool_size.

• Client::shutdown(): un método que puedes usar para detener las tareas en segundo plano y esperar a que los controladores se descarten. Este método puede ser útil si utiliza controladores de eventos para hacer referencia a recursos externos, ya que estos controladores pueden utilizarse en tareas incluso después de que el Client esté cerrado.

Admite roles de AWS Identity and Access Management (IAM) para cuentas de servicio, tales como cuentas de Elastic Kubernetes Service (EKS).

Admite cuentas de servicio adjuntas a GCP cuando se utiliza el Sistema de administración de claves en la nube (KMS).

Permite obtener credenciales CSFLE de Azure KMS on-demand.

Implementa el rasgo FromStr para la estructura Namespace. Este cambio te permite analizar una string que incluye un nombre de base de datos y colección, como "testdb.testcollection" en una instancia de Namespace.

Incluye el server_id en una estructura ConnectionInfo como un tipo i64.

Remueve la mayoría de las restricciones de tipo en los valores referenciados por un Cursor.

Actualiza la versión libmongocrypt en las dependencias del controlador para utilizar la función de cifrado consultable con consultas de igualdad.