Descubra as novidades de cada versão:
Novidades no 2.24
Importante
Esta versão elimina o suporte para as versões 3.6 e 4.0 do MongoDB Server . Se você estiver utilizando o MongoDB Server 4.0 ou anterior, atualize para a versão 4.2 ou posterior.
A versão do driver Ruby 2.24 inclui os seguintes novos recursos, alterações e correções de bugs:
Apresenta a opção de conexão
:server_monitoring_mode. Para saber mais, consulte a seção Seleção de Servidor no guia Opções de Conexão.Adiciona suporte para recursos de limitação da taxa de conexão de entrada. Você pode usar as
:enable_overload_retargeting:max_adaptive_retriesopções e para melhorar o comportamento quando conectado a servidores sobrecarregados. Para saber mais sobre essas opções, consulte a seção Operações de leitura e escrita no guia Opções de conexão.
Novidades no 2.23
Importante
O suporte para as versões 3.6 e 4.0 do MongoDB Server está obsoleto nesta versão e será removido na versão 2.24. Se você estiver utilizando o MongoDB Server 4.0 ou anterior, atualize para a versão 4.2 ou posterior.
A versão do driver Ruby 2.23 inclui os seguintes novos recursos, alterações e correções de bugs:
Adiciona suporte para rastreamento de operações de driver com OpenTelemetry. Quando ativado, esse recurso rastreia as operações do driver Ruby e os comandos correspondentes do servidor . Você pode ativar o rastreamento em uma instância
Mongo::Clientdefinindo a opçãotracingcomotrueou defini-la globalmente por meio da variável de ambienteOTEL_RUBY_INSTRUMENTATION_MONGODB_ENABLED.Adiciona a opção de configuração
csfle_convert_to_ruby_typespara converter tipos de criptografia no nível do campo do lado do cliente (CSFLE) em tipos de Ruby.Adiciona o mecanismo Ruby (por exemplo, TrfleRuby ou JRuby) ao campo de plataforma nos registros de metadados do cliente .
Permite connection strings SRV que usam nomes de host válidos com menos de três rótulos.
Implementa corretamente a opção de URI do
srv_max_hosts.Adiciona suporte para Ruby 4.0.
Corrige o manuseio do Tempo limite de operações do lado do cliente (CSOT) em
with_transactionao manipular corretamente valores de tempo limite zero (infinito) e positivo.
Para saber mais sobre esta versão, consulte as notas de versão v2.23 no Github.
Novidades no 2.22
A versão do driver Ruby 2.22 inclui os seguintes novos recursos, alterações e melhorias:
Adiciona uma opção de classificação para os métodos
update_oneereplace_one. Para obter mais informações, consulte a documentação da API para update_one e replace_one.Adiciona lógica de repetição ao tratamento
SocketErrordurante verificações de pool de conexões .Corrige um
ArgumentErrorque ocorreu quando um servidor foi marcado comounknown.
Para saber mais sobre esta versão, consulte as notas de versão v2.22 no Github.
Novidades em 2.21.1
A versão do driver Ruby 2.21.1 inclui os seguintes novos recursos, alterações e melhorias:
Adiciona o parâmetro
typeaos métodos de criação de índice de pesquisaMongo::SearchIndex::View#create_oneeMongo::SearchIndex::View#create_many. Isso permite que você crie índices de pesquisa Vector Search do MongoDB programaticamente. Para saber mais e ver exemplos, consulte o guia de índices de pesquisa do MongoDB Search e do MongoDB Vector Search.Adiciona compatibilidade com Ruby 3.3. Para saber mais, consulte Compatibilidade.
BSON v5.1
A joia bson é a implementação da especificação BSON em Ruby. bson v5.1 acompanha o driver Ruby v2.21.1 liberação.
A versão bson 5.1 inclui os seguintes novos recursos, alterações e aprimoramentos:
Adiciona o tipo
BSON::Vectorpara representar vetores de valores numéricos. Para saber mais, consulte a seção BSON::Vector do guia BSON.BSON::Documentobjetos não suportam o uso dos métodos#deep_symbolize_keys!e#symbolize_keys!. Em versões anteriores, o método#symbolize_keys!gera umArgumentErrorquando usado em umBSON::Document, mas#deep_symbolize_keys!não, e só retorna umHashem vez de umBSON::Document.Esta versão adiciona um aviso quando você usa
#deep_symbolize_keys!em uma instânciaBSON::Document. Embsonv6.0, essa ação gerará um erro.
Para saber mais sobre esta versão, consulte as Notas da versão v2.21.1 no GitHub.
Novidades no 2.21
A versão do driver Ruby 2.21 inclui os seguintes novos recursos:
Suporta o recurso Tempo limite de operações do lado do cliente (CSOT), que unifica a maioria das opções relacionadas ao tempo limite em uma única opção
timeout_ms.Suporta a versão 8.0 do MongoDB Server .
Suporte para queries de intervalo v2 com Queryable Encryption, incluindo um novo parâmetro
trim_factor. Para obter mais informações sobre Queryable Encryption, consulte Queryable Encryption no manual do MongoDB Server.
Para saber mais sobre esta versão, consulte as notas de versão v2.21 no Github.
Novidades no 2.20
A versão do driver Ruby 2.20 inclui os seguintes novos recursos:
Descontinua o suporte para Ruby 2.5 e 2.6. Substitui o suporte para Ruby 2.7 e JRuby 9.2, que serão descontinuados na próxima versão secundária do driver. Adiciona suporte para JRuby 9.4.
Suporta a versão recém-lançada do Ruby-BSON 5.0.
Permite connection strings sem uma barra entre os hosts e as opções. Por exemplo,
mongodb://example.com?w=1emongodb://example.com/?w=1são ambas connection strings válidas agora.Envia metadados de tempo de execução e orquestração do container para o ambiente do cliente para o servidor para fins analíticos.
Escreve uma mensagem de aviso no registro ao detectar o host como uma instância CosmosDB (Azure) ou DocumentDB (Amazon).
Tenta novas tentativas de operações de leitura ou gravação em uma instância
mongosdiferente em uma topologia fragmentada, se possível.
Para saber mais sobre esta versão, consulte as notas de versão v2.20 no Github.