NOVIDADES
Saiba mais sobre os novos recursos, melhorias e correções introduzidas nas seguintes versões do MongoDB Java Reactive Streams Driver:
Novidades no 5.2
Os novos recursos da versão do driver 5.2 incluem:
Adiciona a classe
SearchIndexType
, que você pode passar ao construir uma instância doSearchIndexModel
. 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 SearchIndexModel Documentação da API.Delega a implementação dos algoritmos que implementam os mecanismos de autenticação
SCRAM-SHA-1
eSCRAM-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ênciamongodb-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 JARmongodb-crypt
. Você pode encontrar instruções do Linux para instalar olibmongocrypt
no manual do Servidor. Se você usar um gerenciador de pacote para instalar olibmongocrypt
, 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 ambienteLD_LIBRARY_PATH
para o caminho do arquivo do pacotelibmongocrypt
.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()
eInsertManyResult.getInsertedIds()
retornassem IDs de documento incorretos em algumas situações. Essa alteração é portada para o driver Java Reactive Streams 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 servidoresmongos
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
elibmongocrypt
, 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 daorg.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âmetronumCandidates
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.
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:
Corrige um problema que impede o driver de codificar e decodificar classes concretas que estendem classes de base genéricas, nos casos em que você especifica a classe de base como o tipo genérico da instância
MongoCollection
.
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ãoauthMechanismProperties
.
Novidades no 5.1
Importante
MongoDB Server v3.6 Fim da vida útil
O suporte para o MongoDB Server v3.6 está obsoleto nesta versão e será removido na versão v5.2 do driver.
Para saber mais sobre outras alterações introduzidas na v5.1, consulte o guia Novidades na documentação do Java Sync Driver.