Notas de versão

4.15: quais as novidades

A versão PyMongo v4.15 inclui as seguintes novas funcionalidades:

• Adiciona suporte experimental para queries de prefixo, sufixo e substring de Queryable Encryption . Estes recursos exigem pymongocrypt 1.16 ou posterior. Para saber mais sobre QE, consulte criptografia em execução.

  Observação

  Recurso experimental

  As queries de prefixo, sufixo e substring do Queryable Encryption são instáveis, e sua segurança não é garantida até que estejam geralmente disponíveis (GA). Use-os apenas em cargas de trabalho experimentais.

• Adiciona suporte para codificação e decodificação de valores BSON Decimal128 para valores Python decimal.Decimal usando a classe bson.codec_options.TypeRegistry . O exemplo a seguir mostra como codificar um valor Decimal128 para um valor decimal.Decimal usando a classe bson.decimal128.DecimalEncoder :

  opts = CodecOptions(type_registry=TypeRegistry([DecimalEncoder()]))
  bson.encode({"d": decimal.Decimal('1.0')}, codec_options=opts)

• Adiciona suporte para discos Windows ARM64.

O que há de novo em 4.14

A versão PyMongo v4.14 inclui as seguintes novas funcionalidades:

• Adiciona suporte inicial para Python 3.14, incluindo recursos de threading gratuito. O driver ainda não é compatível com as seguintes funcionalidades com o Python 3.14:

  • Subintérpretes (concurrent.interpreters)

  • Threading grátis com criptografia

  • mod_wsgi

• Remove o suporte experimental para threading gratuito com o Python 3.13.

• Adiciona as seguintes propriedades na classe bson.codec_options.TypeRegistry :

  • .codecs: fornece acesso aos codecs específicos do tipo de um objeto TypeRegistry

  • .fallback_encoder: fornece acesso a um codificador de fallback de um objeto TypeRegistry

• Adiciona o método append_metadata() às classes MongoClient e AsyncMongoClient. Você pode usar esse método para enviar metadados do cliente para o servidor sob demanda.

• Melhora o desempenho de seleção do servidor ao usar referência de leitura primária.

4.13: quais as novidades

A versão PyMongo v4.13 inclui as seguintes novas funcionalidades:

• A API do PyMongo Async está geralmente disponível. Para saber como migrar para a API PyMongo Async a partir do driver do PyMongo ou da biblioteca Motor, consulte o guia Migrar para o PyMongo Async.

• Corrige um erro onde WriteConcern() não pôde ser avaliado ao utilizar w="majority".

Para ver uma lista completa de problemas resolvidos nesta versão, consulte as notas de versão do Jira.

4.12: quais as novidades

A versão PyMongo v4.12 inclui as seguintes novas funcionalidades:

• Adiciona suporte para configurar a vida útil do cache de DEK usando o argumento key_expiration_ms para AutoEncryptionOpts.

• Adiciona suporte para $lookup em CSFLE e QE para o MongoDB Server 8.1 e posterior.

• Adiciona os métodos gridfs.asynchronous.grid_file.AsyncGridFSBucket.rename_by_name() e gridfs.grid_file.GridFSBucket.rename_by_name(). Você pode usar esses métodos para renomear arquivos com mais desempenho com várias revisões.

• Adiciona os métodos gridfs.asynchronous.grid_file.AsyncGridFSBucket.delete_by_name() e gridfs.grid_file.GridFSBucket.delete_by_name(). Você pode usar esses métodos para obter uma exclusão mais eficiente de arquivos com várias revisões.

• AsyncMongoClient os objetos não executam mais resolução de DNS para connection strings mongodb+srv:// na criação. Para evitar o bloqueio do loop asyncio, o PyMongo agora adia a resolução até que o cliente seja conectado pela primeira vez.

• Adiciona suporte de sugestão de índice aos métodos pymongo.asynchronous.collection.AsyncCollection.distinct() e pymongo.collection.Collection.distinct().

• Descontinua o parâmetro hedge para as preferências de leitura PrimaryPreferred, Secondary, SecondaryPreferred e Nearest. O suporte para hedge será removido no PyMongo v5.0.

• Remove o suporte PyOpenSSL do driver PyMongo Async.

• Permite nomes de host SRV válidos com menos de 3 partes.

Novidades no 4.11

A versão PyMongo v4.11 inclui as seguintes novas funcionalidades:

• Adiciona suporte para CPython de thread livre ao executar Python v3.13+. Para obter mais informações sobre threading gratuito, consulte a documentação do Python.

• A criptografia em uso requer pymongocrypt v1.12 ou posterior.

• Os métodos MongoClient.address() e AsyncMongoClient.address() bloqueiam corretamente quando chamados em clientes não conectados.

• Adiciona suporte __repr__ para as classes IndexModel e SearchIndexModel .

• Adiciona um parâmetro sort aos seguintes métodos:

  • Collection.update_one()

  • Collection.replace_one()

  • operations.UpdateOne()

  • operations.UpdateMany()

• Os métodos MongoClient.bulkWrite() e AsyncMongoClient.bulk_write() lançam um erro de erro se você usá-los com gravações não reconhecidas quando as opções ordered ou verboseResults estiverem definidas como True.

• Corrige um bug que fazia com que DatetimeMS fosse codificado incorretamente como '{"$date": "X"}' em vez de '{"$date": X}' ao usar a representação de data e hora do JSON estendido do MongoDB legado .

• Corrige um erro que fazia com que o método bson.json_util.loads() gerasse um IndexError em vez de um ValueError ao analisar um valor de $date inválido.

Novidades no 4.10

A versão PyMongo v4.10 inclui as seguintes novas funcionalidades:

• Adiciona suporte provisório para um novo subtipo binário de BSON (9), que pode ser usado para armazenamento e recuperação eficientes de vetores usando os métodos bson.binary.Binary.from_vector() e bson.binary.Binary.as_vector() . O suporte para o subtipo 9 de BSON está em versão beta e está sujeito a alterações antes da versão geralmente disponível.

• Adiciona "c" ao campo de metadados do cliente driver.name quando um aplicação usa a extensão C.

• Corrige um bug que pode causar impasse AsyncMongoClient .

Novidades no 4.9

A versão PyMongo v4.9 inclui as seguintes novas funcionalidades:

• Adiciona suporte para MongoDB Server 8.0 e Python 3.13.

• Adiciona suporte para queries de intervalo de Queryable Encryption . Para usar esse recurso, seu aplicativo deve se conectar ao MongoDB Server 8.0 ou posterior. Para obter mais informações sobre Queryable Encryption, consulte Queryable Encryption no manual do MongoDB Server .

• Adiciona uma nova API assíncrona experimental como substituição para o Motor. Essa API está em versão beta e está sujeita a alterações antes da versão geralmente disponível.

4.8: quais as novidades

A versão PyMongo v4.8 inclui as seguintes novas funcionalidades:

• Implementação da automação segura do ciclo de vida de desenvolvimento de software (SSDLC) no processo de lançamento. As versões do Github incluem uma lista de materiais de software (SBOM) e arquivos de assinatura correspondentes aos arquivos de distribuição lançados no PyPI.

• Em objetos do tipo bson.binary.Binary, o método repr() é redigido quando o subtipo binário é SENSITIVE_SUBTYPE (8).

• Foi corrigido um bug nos change streams em que os campos startAtOperationTime e resumeToken podiam ser adicionados a uma nova tentativa, o que fazia com que a nova tentativa falhasse.

• No Windows, os metadados de handshake foram alterados de os.name para Windows para melhorar o tempo de importação.

• Desempenho aprimorado de operações MongoClient , especialmente quando o driver está executando muitas operações simultaneamente.

• Foi adicionado um fallback ao módulo stdlib ssl se a importação do módulo pyopenssl falhar com um AttributeError.

O que há de novo em 4.7

A versão PyMongo v4.7 inclui as seguintes novas funcionalidades:

• Adicionado o Hello.connection_id, CommandStartedEvent.server_connection_id, CommandSucceededEvent.server_connection_id e CommandFailedEvent.server_connection_id propriedades.

• Suporte adicionado para sufixos de nome para fornecedores de KMS (KMS) para criptografia no nível do campo do lado do cliente (CSFLE). Este recurso requer pymongocrypt v1.9+ e libmongocrypt v1.9+. Para obter mais informações, consulte a documentação da API para a classe AutoEncryptionOpts.

• Melhorou o desempenho da codificação de documentos BSON para JSON.

• Os métodos ClientEncryption.encrypt() e ClientEncryption.encrypt_expression() agora permitem que o argumento key_id seja passado como um objeto UUID .

• Aumentar um objeto RawBSONDocument contendo um valor Code não causa mais um erro.

• Correção de um bug no Python 3.12 onde a mensagem de erro RuntimeError: can't create new thread at interpreter shutdown pode ser gravada em stderr quando um thread MongoClient começa quando o interpretador Python está sendo desligado.

• Corrigido um bug em que Int64 as instâncias nem sempre podiam ser codificadas por orjson. Códigos como o exemplo a seguir agora são executados corretamente:

>>> import orjson
>>> from bson import json_util
>>> orjson.dumps({'a': Int64(1)}, default=json_util.default, option=orjson.OPT_PASSTHROUGH_SUBCLASS)