Notas de versión

Correcciones

• Incrementa la resolución de bson_get_monotonic_time() en plataformas Windows.

• Elimina el soporte para Visual Studio 2015. La versión mínima compatible es Visual Studio 2017.

Obsolescencias

• Se deja de admitir el soporte para macOS 11 y macOS 12

Nuevas características:

• Presenta las siguientes funcionalidades del mecanismo de autenticación MONGODB-OIDC:

  • Agrega soporte para una función de retorno personalizada con mongoc_client_set_oidc_callback y mongoc_client_pool_set_oidc_callback.

  • Agrega soporte para el entorno de Azure con la propiedad environment:azure.

  • Añade compatibilidad para el entorno GCP con la propiedad environment:gcp.

  • No admite entornos de Kubernetes en esta versión.

• Añade las siguientes funcionalidades a mongoc_bulkwrite_t: - Añade la función mongoc_bulkwrite_is_acknowledged. — Añade función mongoc_bulkwriteresult_serverid. - Añade soporte para operaciones de Queryable Encryption.

• Agrega el siguiente soporte para índices de texto para Queryable Encryption:

  • Agrega el tipo mongoc_client_encryption_encrypt_text_opts_t.

  • Agrega soporte de vista previa para búsqueda de subcadenas, prefijos y sufijos solo para cargas de trabajo experimentales. Estas funciones no son estables y su seguridad no está garantizada hasta que se lancen como Generalmente Disponibles (GA). La versión GA de estas funcionalidades puede no ser retrocompatible con la versión preliminar.

• Agrega soporte para TLS v1.3 en plataformas Windows con Windows Secure Channel.

Correcciones

• No intenta reanudar al recorrer un flujo de cambios cerrado.

• Elimina el soporte para Visual Studio 2015. La versión mínima compatible es Visual Studio 2017.

• Eleva la versión requerida de libmongocrypt de 1.13.0 a 1.15.0. Esto admite cifrado en uso y corresponde a la opción ENABLE_CLIENT_SIDE_ENCRYPTION de CMake.

Obsolescencias

• Se descontinúa el soporte para macOS 11 y macOS 12.

Para obtener más información sobre esta versión, consulta las notas de versión v2.2.0.

Correcciones

• Corrige el siguiente problema de vulnerabilidades y exposiciones comunes (CVE): el guardado masivo con opciones lee memoria no válida si se pasa con opciones grandes. Para obtener más información, consulta el problema CVE-2025-12119 relacionado.

Para obtener más información sobre esta versión, consulta las notas de versión v2.1.2.

Correcciones

• Ya no se propaga la bandera -fPIC en los destinos de CMake.

• Aplica el comportamiento del comando de guardado a la función mongoc_collection_create_indexes_with_opts().

• Omite el campo saslSupportedMechs en comandos de supervisión de un solo hilo.

Para obtener más información sobre esta versión, consulta las notas de versión v2.1.1.

Correcciones

• Para entornos que no son Windows, el script de desinstalación ahora llama al comando find "$dir" -maxdepth 1 para detectar directorios que no están vacíos en lugar del comando ls --almost-all, que no era compatible con macOS.

• Para los entornos de Windows, el script de desinstalación ya no "tiene éxito" con un valor %ERRORLABEL% incorrecto o distinto de cero.

• Remueve el soporte para Debian 9 y Debian 10.

Mejoras

• Establece la versión máxima de la política de CMake en 4.0. La versión máxima no estaba establecida anteriormente.

Correcciones

• Para entornos que no son Windows, el script de desinstalación ahora llama al comando find "$dir" -maxdepth 1 para detectar directorios que no están vacíos en lugar del comando ls --almost-all, que no era compatible con macOS.

• Para los entornos de Windows, el script de desinstalación ya no "tiene éxito" con un valor %ERRORLABEL% incorrecto o distinto de cero.

• Agrega compatibilidad con ventana Secure canal para verificar los certificados del cliente con firmas más nuevas.

• Sustituye el uso de rand() por alternativas seguras para hilos.

• Remueve el soporte para Debian 9 y Debian 10.

Mejoras

• Actualiza la versión mínima compatible de MongoDB Server de 4.0 a 4.2.

• Establece la versión máxima de la política de CMake en 4.0. La versión máxima no estaba establecida anteriormente.

• Remueve los búferes duraderos no útiles para reducir el uso de memoria.

• Mejora los mensajes de error generados por las APIs de Windows.

Correcciones

• Corrige un mensaje de bson_strerror_r en Windows.

• Soluciona fugas de memoria con Windows Secure Channel.

• Corrige la carga de claves RSA PKCS#8 con Windows Secure Channel.

Para obtener más información sobre esta versión, consulta las notas de versión v2.0.2.

Correcciones

• Corrige un error de configuración de CMake 4 en sistemas operativos macOS

Correcciones

• Corrige un problema de manejo de nombre de usuario para la autenticación de MONGODB-X509 que se producía cuando el driver C estaba configurado para utilizar la librería Secure Transport o Secure canal

• Ya no rellena un mongoc_bulkwritereturn_t.res con un resultado parcial cuando la función mongoc_bulkwrite_execute() genera un error de cliente después de la primera operación de guardado

Para obtener más información sobre esta versión, consulta las notas de versión v2.0.1.

Nuevas características:

• Agrega soporte para el subtipo Vector Binario BSON. Para obtener más información, consulta Subtipo de Vector Binario BSON en la documentación de la API de libbson.

Nuevas características:

• Admite operaciones agregadas que incluyen $lookup etapas para el cifrado en uso. Para obtener más información, consulta las siguientes referencias en el manual de MongoDB Server:

  • Comportamiento de $lookup y $graphLookup para CSFLE

  • Comportamiento de $lookup y $graphLookup para QE

Para obtener más información sobre esta versión, consulte las notas de versión v2.0.

Correcciones

• Corrige el siguiente problema de vulnerabilidades y exposiciones comunes (CVE): el guardado masivo con opciones lee memoria no válida si se pasa con opciones grandes. Para obtener más información, consulta el problema CVE-2025-12119 relacionado.

Para obtener más información sobre esta versión, consulta las notas de versión v1.30.6.

Nuevas características:

• En anticipación a la v2.0 lanzamiento, añade nuevos paquetes de CMake y objetivos importados para bson que te permiten soportar ambas versiones principales sin modificar tu proyecto CMake.

  • Para importar bson con los nuevos nombres, llame a find_package para el paquete bson. Los nuevos nombres de destino importados son bson::static, bson::shared y bson::bson.

Nuevas características:

• En anticipación de la v2.0 lanzamiento, agrega nuevos paquetes de CMake y objetivos importados para bson y mongoc para permitirle soportar ambas versiones principales sin modificar su proyecto CMake.

  • Para importar mongoc con los nuevos nombres, llame a find_package para el paquete mongoc. Los nuevos nombres de destino importados son mongoc::static, mongoc::shared y mongoc::mongoc.

  • Para importar bson con los nuevos nombres, llame a find_package para el paquete bson. Los nuevos nombres de destino importados son bson::static, bson::shared y bson::bson.

Para obtener más información sobre esta versión, consulta las notas de versión v1.30.3.

Obsolescencias

• Se deprecia la compatibilidad con Debian 9 y Debian 10

Mejoras

• Mejora el rendimiento de la serialización de BSON a JSON para documentos anidados

Correcciones

• Actualiza la salida truncada de la función bson_as_json_with_opts() para que ya no divida las secuencias UTF-8 válidas

• Actualiza el texto JSON generado de las siguientes maneras:

  • Serializa todos los arreglos y documentos vacíos con un espacio

  • Serializa arreglos que el controlador omite debido al límite máximo de recursividad a [ ... ] en lugar de { ... }

  • Aplica el límite máximo de recursión a documentos heredados de CodeWScope

• Soluciona un parámetro de salida filtrado después de llamadas infructuosas a la función bson_append_array_builder_begin()

Obsolescencias

• Se deprecia la compatibilidad con Debian 9 y Debian 10

Nuevas características:

• Añade soporte para registro estructurado. Para configurar esta funcionalidad, utiliza las funciones mongoc_client_set_structured_log_opts() y mongoc_client_pool_set_structured_log_opts().

• Agrega soporte para la configuración de la duración de la caché de las llaves de cifrado de datos de encriptación en uso. Para configurar esta funcionalidad, utiliza las funciones mongoc_auto_encryption_opts_set_key_expiration() y mongoc_client_encryption_opts_set_key_expiration().

  Para obtener más información sobre la encriptación en uso, consulta Cifrado en uso en la guía de MongoDB Server.

• Agrega soporte para la opción sort para las operaciones de actualización y reemplazo.

• Agrega soporte para construir un tipo mongoc_bulkwrite_t sin cliente utilizando las funciones mongoc_bulkwrite_new() y mongoc_bulkwrite_set_client().

Mejoras

• Mejora el rendimiento de la función mongoc_server_description_new_copy()

Correcciones

• Incluye las siguientes correcciones de eventos de APM requeridas por la especificación SDAM:

  • Después de entregar un evento server_opening, el conductor debe entregar un evento server_closed correspondiente antes de entregar topology_closed.

  • Antes de entregar un evento topology_closed, el conductor entrega un evento topology_changed que tiene un new_description de tipo Unknown

• Corrige posibles fallos cuando el controlador informa de las IDs de documentos insertados en los resultados detallados de escrituras masivas de clientes

Para obtener más información sobre esta versión, consulte las notas de versión v1.30.

Obsolescencias

• Obsoleta bson_string_t y las funciones asociadas

• Se desaprueba compilar con BSON_MEMCHECK

• Obsolece las funciones bson_in_range_*() y bson_cmp_*()

• Obsolece las funciones bson_atomic_*() y bson_thrd-yield()

• Obsolece las funciones bson_as_json() y bson_array_as_json()

Obsolescencias

• Se desaprueba mongoc_client_command. Utiliza mongoc_client_command_simple en su lugar.

• Se desaprueba mongoc_database_command. Utiliza mongoc_database_command_simple en su lugar.

• Se desaprueba mongoc_collection_command. Utiliza mongoc_collection_command_simple en su lugar.

Para obtener más información sobre esta versión, consulte las notas de versión v1.29.

Nuevas características:

• Agrega la función bson_validate_with_error_and_offset()

Nuevas características:

• Agrega soporte para consultas de rango de cifrado en uso

• mongoc_collection_insert_one incluye el ID de inserción

• Agrega una nueva API de guardado masivo mongoc_bulkwrite_t

• Adds serverMonitoringMode URI option

Obsolescencias

• Elimina la opción *_hint. En cambio, utiliza la opción *_server_id.

  • Se desaprueba mongoc_bulk_operation_set_hint. En su lugar, utilice mongoc_bulk_operation_set_server_id.

  • Se desaprueba mongoc_bulk_operation_get_hint. En su lugar, utilice mongoc_bulk_operation_get_server_id.

  • Se desaprueba mongoc_cursor_set_hint. En su lugar, utilice mongoc_cursor_set_server_id.

  • Se desaprueba mongoc_cursor_get_hint. En su lugar, utilice mongoc_cursor_get_server_id .

• Se desaprueba ENABLE_SSL=LIBRESSL y mongoc_stream_tls_libressl_new.

• Se desaprueban ENABLE_SASL=CYRUS y la opción CYRUS_PLUGIN_PATH_PREFIX en las plataformas Windows.

Para obtener más información sobre esta versión, consulte las notas de versión v1.28.

Correcciones

• Soluciona el manejo de JSON extendido malformado para tipos especiales de BSON

Correcciones

• Soluciona la advertencia de TSan

• Corrige la compilación de C23

Mejoras

• Documenta el comportamiento esperado de los errores de comandos en una transacción

Correcciones

• Soluciona el manejo de string largas en bson_append_utf8

Correcciones

• Soluciona un posible error de compilación en entornos donde bool o _Bool es una macro

Correcciones

• Soluciona problemas de compilar con Visual Studio 2013

Correcciones

• Corrige posibles fallos al leer mensajes defectuosos del protocolo cableado

• Soluciona problemas de compilar con Visual Studio 2013

Cambios

• Introduce cambios en los procesos de desarrollo, incluyendo nueva firma de código y seguimiento de dependencias. No hay cambios en el comportamiento ni en la API.

Correcciones

• Actualiza el Zlib integrado de la versión 1.2.3 a la 1.3.1

Correcciones

• Correcciones en el análisis de dos puntos en la zona horaria

• Corrige el error al no poder inicializar un subdocumento en bson_iter_visit_all

Correcciones

• Cierra las conexiones residuales a servidores remotos

Nuevas características:

• Verifica la variable de entorno MONGO_EXPERIMENTAL_SRV_PREFER_TCP para preferir TCP sobre la búsqueda SRV

Correcciones

• Corrige el manejo de cadenas grandes en bson_string_new y bson_string_append

Correcciones

• Corrige un posible fallo cuando el cliente está configurado con una contraseña vacía

Nuevas características:

• Agrega el nombre de la base de datos a los eventos de comando mongoc_apm_command_failed_get_database_name y mongoc_apm_command_succeeded_get_database_name

• Admite el protocolo KMIP delegado para encriptación en uso

• Permite configurar el tiempo de espera del socket por cliente

Correcciones

• Corrige iteración en bson_strfreev

Correcciones

• Resuelve un posible cuelgue si se llama a mongoc_gridfs_file_readv con un fragmento dañado con datos incompletos

• Soluciona un assert con el protocolo legacy exhaust cursor al conectarse a versiones del servidor MongoDB anteriores a 4.2

Correcciones

• Utiliza asignación alineada para bson_array_builder_t

Correcciones

• Corrige la compilación de 32bits con 64bits time_t

Nuevas características:

• Soporta proveedores de KMS nombrados

• Redirige los reintentos en clústeres particionados a otro mongos si es posible

Mejoras

• Agrega VERSION_CURRENT archivo en fuente para facilitar la construcción

• Considera que más errores pueden ser reintentados