Actualizar las versiones de PyMongo

Versión 4.18 cambio disruptivo

• Descarta el soporte para el MongoDB Server v4.2. La versión mínima compatible de MongoDB Server es ahora la v4.4.

• Los métodos asistentes de agregación lanzan un pymongo.errors.ConfigurationError si pasa un argumento de palabra clave aggregate o pipeline. Anteriormente, estas claves reemplazaban silenciosamente el namespace de destino y el pipeline del comando aggregate generado. Este cambio afecta a los siguientes métodos en las clases síncronas y asíncronas:

  • Collection.aggregate()

  • Collection.aggregate_raw_batches()

  • Database.aggregate()

  • Collection.list_search_indexes()

• Los eventos de supervisión de comandos y los mensajes de registro de comandos para una única operación lógica comparten un operation_id estable en todos los intentos de reintento de esa operación. Como resultado, operation_id ya no es igual al request_id por intento para estas operaciones.

• Documentos y subdocumentos que tienen un tamaño de 4 KB o más y se decodifican en bson.raw_bson.RawBSONDocument objetos desde un búfer inmutable se exponen como segmentos memoryview de solo lectura en lugar de bytes copias. Los documentos decodificados de búferes mutables, como un bytearray, son siempre bytes copias.

• El método bson.get_data_and_view() devuelve una vista de una copia privada de bytes para entradas de protocolo de búfer distintas de bytes o bytearray.

• Si utiliza un exhaust cursor (CursorType.EXHAUST) con una versión de mongos anterior a la v7.1, el driver genera un error pymongo.errors.InvalidOperation en la primera iteración del cursor en lugar de desde el método find(), porque el driver comprueba el requisito con la conexión en uso. Los cursores asíncronos que combinan limit con CursorType.EXHAUST generan el error desde el método find() en lugar de en la primera iteración, lo que coincide con la API síncrona.

Versión 4.14 cambio disruptivo

• Descarta el soporte para el MongoDB Server v4.0. La versión mínima compatible de MongoDB Server es ahora la v4.2.

• Cuando codificas un objeto bson.binary.BinaryVector, el valor del campo de metadatos padding debe cumplir con las siguientes condiciones:

  • Si el subtipo binario es PACKED_BIT, el valor debe estar entre 0 y 7 (inclusive).

  • Si no, el valor debe ser 0.

  Si no se cumplen las condiciones anteriores, PyMongo genera un ValueError.

• El parámetro options para el método uri_parser.parse_uri() es del tipo dict. Anteriormente, este parámetro era del tipo _CaseInsensitiveDictionary.

Versión 4.11 cambio disruptivo

• Descarta el soporte para el MongoDB Server v3.6. La versión mínima compatible de MongoDB Server es ahora la v4.0.

• Se desaprueba el soporte para MongoDB Server v4.0. De acuerdo con los Cronogramas del ciclo de vida del software de MongoDB, una próxima versión menor de PyMongo aumentará la versión mínima de MongoDB Server de 4.0 a 4.2.

• Descarta el soporte para el Python v3.8. A versão mínima do Python suportada agora é v3.9.

• Se elimina el soporte para PyPy v3.9. La versión mínima de PyPy compatible es ahora la v3.10.

• Deja de soportar el mecanismo de autenticación MONGODB-CR. Para obtener más información sobre autenticación, consulta la guía de Mecanismos de Autenticación.

Versión 4.9 cambio disruptivo

• Debe utilizar pymongocrypt v1.10 o posterior para usar Cifrado en el lado del cliente a nivel de campo (CSFLE) en su aplicación.

Cambios disruptivos en la versión 4.8

• Debido a que PyMongo v4.8 utiliza hatch como su sistema de compilación backend, ya no puedes compilar el driver usando el archivo setup.py. En su lugar, debe instalar PyMongo usando pip. Para instalaciones editables, debe utilizar pip v21.3 o una versión posterior.

Cambios disruptivos en la versión 4.7

• Todas las incidencias del tipo de colección SON en todas las clases internas y comandos se han cambiado a dict.

• La propiedad options.pool_options.metadata ahora es de tipo dict, no SON. El siguiente ejemplo de código muestra las diferencias en la forma en que estos formatos almacenan datos:

# Before (SON)
>>> from pymongo import MongoClient
>>> client = MongoClient()
>>> client.options.pool_options.metadata
SON([('driver', SON([('name', 'PyMongo'), ('version', '4.7.0.dev0')])), ('os', SON([('type', 'Darwin'), ('name', 'Darwin'), ('architecture', 'arm64'), ('version', '14.3')])), ('platform', 'CPython 3.11.6.final.0')])
# After (dict)
>>> client.options.pool_options.metadata
{'driver': {'name': 'PyMongo', 'version': '4.7.0.dev0'}, 'os': {'type': 'Darwin', 'name': 'Darwin', 'architecture': 'arm64', 'version': '14.3'}, 'platform': 'CPython 3.11.6.final.0'}

Para convertir un objeto de dict de una sola capa en un objeto de SON, pasa el objeto de dict al constructor de SON, tal como se muestra en el siguiente ejemplo:

>>> data_as_dict = client.options.pool_options.metadata
>>> SON(data_as_dict)
SON([('driver', {'name': 'PyMongo', 'version': '4.7.0.dev0'}), ('os', {'type': 'Darwin', 'name': 'Darwin', 'architecture': 'arm64', 'version': '14.3'}), ('platform', 'CPython 3.11.6.final.0')])

Si el objeto dict tiene varias capas, debes convertir los valores uno a la vez, como se muestra en el siguiente ejemplo:

>>> def dict_to_SON(data_as_dict: dict[Any, Any]):
...     data_as_SON = SON()
...     for key, value in data_as_dict.items():
...         data_as_SON[key] = dict_to_SON(value) if isinstance(value, dict) else value
...     return data_as_SON
>>>
>>> dict_to_SON(data_as_dict)
SON([('driver', SON([('name', 'PyMongo'), ('version', '4.7.0.dev0')])), ('os', SON([('type', 'Darwin'), ('name', 'Darwin'), ('architecture', 'arm64'), ('version', '14.3')])), ('platform', 'CPython 3.11.6.final.0')])

Cambios disruptivos en la versión 4.2

• Para mejorar la compatibilidad con la herramienta Pyright, la ClientSession clase ya no utiliza tipado genérico.

• Se requiere pymongocrypt v1.3.0 o posterior para el cifrado a nivel de campo del lado del cliente (CSFLE).

• Los paquetes bson, pymongo y gridfs ahora utilizan la variable __all__ para declarar sus APIs públicas. Si tu aplicación contiene una instrucción from bson import *, asegúrese de que siga importando las APIs necesarias.

• El método estimated_document_count() siempre utiliza el comando count. Este comando no está disponible en la API estable en las versiones 5.0.0 de MongoDB até 5.0.8. Si usas el método estimated_document_count() con la Stable API, debes actualizar a MongoDB Server v5.0.9 o posterior, o configurar la opción pymongo.server_api.ServerApi.strict en False.