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 desestima la compatibilidad con 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): la escritura masiva con opciones lee memoria no válida si se pasa con opciones grandes. Para obtener más información, consulte 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.

• En entornos Windows, el script de desinstalación ya no "tiene éxito" con un valor %ERRORLABEL% incorrecto y 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.

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

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

• Reemplaza el uso de rand() con alternativas seguras para subprocesos.

• 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 producidos por las API 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 etapas $lookup para el cifrado en uso. Para obtener más información, consulte 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 la versión v.2.0

Correcciones

• Corrige el siguiente problema de vulnerabilidades y exposiciones comunes (CVE): la escritura masiva con opciones lee memoria no válida si se pasa con opciones grandes. Para obtener más información, consulte 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 previsión del lanzamiento de v2.0, se agregan nuevos paquetes CMake y destinos importados para bson para permitirle soportar ambas versiones principales sin modificar su 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 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 los ID de documentos insertados en los resultados detallados de las escrituras masivas del cliente.

Para obtener más información sobre esta versión, consulte las notas de la versión v.1.30

Obsolescencias

• Desestima el 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 la versión v.1.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 nueva API de escritura masiva 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 la versión v.1.28

Correcciones

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

Correcciones

• Corrige 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

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

Correcciones

• Corrige problemas de compilación con Visual Studio 2013

Correcciones

• Corrige posibles fallos al leer mensajes defectuosos del protocolo cableado

• Corrige problemas de compilación 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

• Corrige la afirmación con el protocolo de cursor de escape heredado cuando se conecta a versiones del servidor MongoDB anteriores a 4.2

Correcciones

• Utiliza la asignación alineada para bson_array_builder_t

Correcciones

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

Nuevas características:

• Admite proveedores KMS con nombre

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

Mejoras

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

• Considera que más errores se pueden reintentar