Notas de versão

Novidades no 5.2

A versão do driver 5.2 inclui os seguintes novos recursos, melhorias e correções:

• Permite definir um tempo limite de operações do lado do cliente (CSOT). Este recurso permite a você definir um único tempo limite na sua instância do MongoClient que se aplica a todas as operações realizadas com este cliente. Para saber mais, consulte o guia Limitar o tempo de execução do servidor.

  Importante

  Opções de tempo limite obsoletos

  As seguintes opções de tempo limite são preteridas:

  • waitQueueTimeoutMS

  • socketTimeoutMS

  • wTimeoutMS

  • maxTimeMS

  • maxCommitTimeMS

  Use o recurso CSOT para substituir a funcionalidade dessas opções.

• Adiciona a classe SearchIndexType , que você pode passar ao construir uma instância do SearchIndexModel . Esta alteração permite a você especificar o tipo de índice ao criar um índice de Atlas Search ou Vector Search . Para saber mais, consulte o guia Atlas Search e Vector Search Indexes .

• Delega a implementação dos algoritmos que implementam os mecanismos de autenticação SCRAM-SHA-1 e SCRAM-SHA-256 ao provedor JCA configurado. Essa alteração significa que seu aplicação pode usar um provedor JCA configurado compatível com FIPS para fornecer um nível mais alto de segurança.

• Revisa o mongodb-crypt versão de dependência para corresponder à versão para os drivers JVM . Futuras versões do mongodb-crypt serão lançadas junto com o driver e compartilharão o mesmo número de versão. Você deve atualizar sua dependência mongodb-crypt para v5.2.0 ao atualizar seu driver para esta versão. Para saber mais, consulte o guia criptografia em execução em execução.

• Melhorias de desempenho devido à implementação de criptografia nativa em todas as plataformas suportadas. A lista a seguir descreve as ações necessárias para implementar essa melhoria dependendo do seu sistema operacional:

  • Windows: atualize sua versão do mongodb-crypt para v5.2.0.

  • Mac: atualize sua versão do mongodb-crypt para v5.2.0.

  • Linux: instale libmongocrypt.so diretamente no sistema de arquivos, em vez de usar o arquivo fornecido com o arquivo JAR mongodb-crypt . Você pode encontrar instruções do Linux para instalar o libmongocrypt no manual do Servidor. Se você usar um gerenciador de pacote para instalar o libmongocrypt, o Java Native Access (JNA) o encontrará lá sem configurações adicionais. Como alternativa, você pode especificar o caminho da pesquisa definindo a variável de ambiente LD_LIBRARY_PATH para o caminho do arquivo do pacote libmongocrypt .

    Recomendamos a instalação direta porque a biblioteca compartilhada agrupada não está vinculada ao OpenSSL devido ao potencial de incompatibilidades binárias do OpenSSL.

    O carregamento da biblioteca compartilhada é tratado pelo JNA. Você pode visualizar as regras para a ordem do caminho da pesquisa de carregamento da biblioteca na documentação da classe NativeLibrary.

• Corrige um problema que fazia com que os métodos InsertOneResult.getInsertedId() e InsertManyResult.getInsertedIds() retornassem IDs de documento incorretos em algumas situações. Essa alteração é portada para o driver do Kotlin Sync v5.1.4 e v4.11.4.

• Quando uma operação de cluster fragmentado não obtém êxito, o driver evita selecionar o mesmo servidor mongos para tentativas de repetição de operação se outros servidores mongos estiverem disponíveis.

• Adiciona metadados de acessibilidade necessários quando seu aplicação usa Imagem nativa do GraalVM. Esses metadados substituem a necessidade de coletar metadados de acessibilidade ao usar as bibliotecas de drivers. Para saber mais, consulte Metadados de Acessibilidade na documentação do GraalVM.

  Essa alteração não adiciona as entradas de recursos libjnidispatch e libmongocrypt , porque a adição de entradas para todas as plataformas suportadas (destinos) afeta significativamente o tamanho dos executáveis nativos criados usando a GraalVM Native Imagem. Veja esta amostra resource-config.json no repositório do driver Github para ver como especificar essas entradas explicitamente se seu aplicação depender da org.mongodb:mongodb-crypt biblioteca.

• Ativa a pesquisa vetorial exata estendendo a API VectorSearchOptions para introduzir os seguintes subtipos de opção específicas:

  • ExactVectorSearchOptions: use esse tipo de opções para habilitar a correspondência precisa, garantindo que os resultados sejam os vetores mais próximos de um determinado vetor de consulta.

  • ApproximateVectorSearchOptions: use este tipo de opções para habilitar pesquisas que podem não retornar os vetores exatos mais próximos. Você pode passar um parâmetro numCandidates ao instanciar esse tipo para especificar o número de vizinhos mais próximos a serem considerados.

  Para saber mais sobre como usar a funcionalidade Atlas Vector Search , consulte o Início Rápido do Atlas Vector Search e selecione Kotlin (Sync) no menu suspenso de idiomas.

• Adiciona suporte para serializadores da biblioteca kotlinx-datetime que permitem mapear tipos de data e hora de Kotlin para BSON como os tipos esperados em vez de strings. Para saber mais, consulte a seção Serialize Dates and Times do guia Kotlin Serialization.

• Suporta serialização de JsonElement valores. Para trabalhar com o tipo JsonElement , você deve adicionar a biblioteca kotlinx-serialization-json como uma dependência em seu aplicação.

Novidades em 5.1.3

O 5.1.3 a versão do patch do driver inclui as seguintes alterações:

• Corrige um problema que pode causar erros de asserção ao usar Cursor tipos.

Novidades em 5.1.2

O 5.1.2 a versão do patch do driver inclui as seguintes alterações:

• Suporte para codificação de classes de dados Kotlin com tipos de parâmetro genéricos anuláveis. Por exemplo, você pode codificar a classe Container no seguinte código:

  @Serializable
  data class Box<T>(
      val boxed: T
  )
  @Serializable
  data class Container(
      val box: Box<String?>
  )

Novidades em 5.1.1

O 5.1.1 a versão do patch do driver inclui as seguintes alterações:

• Ao usar o mecanismo de autenticação MONGODB-OIDC , você não deve incluir vírgulas no valor da string de conexão authMechanismProperties. Para saber mais sobre esse comportamento, consulte o guia MONGODB-OIDC.

Novidades no 5.1

Esta seção inclui as seguintes informações:

• Descontinuações no 5.1

• Melhorias na versão 5.1

• Novos recursos em 5.1

Novidades no 5.0

Os novos recursos da versão do driver 5.0 incluem:

• O construtor KotlinSerializerCodecProvider agora aceita objetos serializersModule e bsonConfiguration :

  KotlinSerializerCodec.create(clazz.kotlin, serializersModule=serializersModule, bsonConfiguration=bsonConfiguration)

  Isso torna mais fácil personalizar sua configuração.

• Corrige um bug de reflexão do Kotlin que resultou no apagamento do tipo de container.