Notas de versão

Novidades no 2.25

A versão do driver Ruby 2.25 inclui os seguintes novos recursos, alterações e correções de bugs:

• Adiciona os seguintes recursos à criptografia em execução:

  • Adiciona suporte para usar $lookup em pipeline de agregação que referenciam coleções habilitadas para criptografia em execução.

  • Permite especificar uma chave de dados usando o campo keyAltName, em vez de um keyId, ao definir o mapa de campos criptografados para uma coleção Queryable Encryption.

  • Adiciona suporte para a opção delegated na chave mestra KMIP. Quando definido como true, o servidor KMIP executa a criptografia e a descriptografia da chave de dados, para que a chave de criptografia de chave nunca saia do servidor.

  • Adiciona suporte para provedores KMS nomeados, que usam o formato type:name.

  • Encapsula o erro gerado quando mongocrypt_kms_ctx_fail retorna false.

• Adiciona o método Database#cursor_command, que cria um cursor a partir de uma resposta de comando.

• Desativa as opções de ajuste de nova tentativa legadas :max_read_retries, :read_retry_interval e :max_write_retries quando definidas em um Mongo::Client. Essas opções se aplicam apenas ao recurso de nova tentativa legada desativado. As leituras e gravações modernas que podem ser repetidas são habilitadas por padrão e ignoram essas opções.

• Gera um erro quando você passa um valor booleano inválido para a opção de URI tls ou ssl.

• Encapsula o erro gerado quando mongocrypt_kms_ctx_fail retorna false.

• Redige credenciais na renderização de URI e em Mongo::Error::InvalidURI mensagens de erro.

• Protege o thread que monitora o SRV e corrige o tratamento da opção raise_on_invalid.

• Corrige um vazamento de conexão em topologias com balanceamento de carga.

• Corrige o comportamento de preferência de leitura secondaryPreferred para cumprir a especificação de seleção do servidor.

• Mantém o objeto MemoryPointer ativo em Binary.wrap_string para evitar a coleção de lixo prematura.

• Interrompe a publicação de eventos SDAM das verificações de tempo de ida e volta do monitorar.

• Envia afterClusterTime ao gravar em sessões causalmente consistentes.

• Fecha a conexão de monitoramento quando um servidor é marcado Unknown devido a um erro de rede.

• Interrompe a adição de read e write concerns aos comandos assistentes do índice de pesquisa.

Para saber mais sobre esta versão, consulte as Notas da versão v2.25.0 no GitHub.

Novidades em 2.24.1

A versão do driver Ruby 2.24.1 inclui os seguintes novos recursos, alterações e correções de bugs:

• Impede que os rastreamentos do OpenTelemetry capturem comandos confidenciais.

• Adiciona a opção Mongo::Config.include_server_address_in_errors, que por padrão é false. Quando ativadas, as mensagens Mongo::Error::OperationFailure e Mongo::Error::BulkWriteError incluem o host e a porta do servidor que produziu o erro.

• Adiciona a propriedade databaseName aos eventos de comando, alinhando-se à especificação de monitoramento de comando.

• Expõe atClusterTime em sessões de snapshots.

Para saber mais sobre esta versão, consulte as Notas da versão v2.24.1 no GitHub.

Novidades no 2.24

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 do 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 opções :enable_overload_retargeting e :max_adaptive_retries 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.

• Adiciona suporte para o MongoDB Intelligent Gerenciamento de Carga de Trabalho (IWM). O driver Ruby agora lida com cenários de bloqueio de gravação e otimiza o estabelecimento de conexão durante condições de alta carga para manter a disponibilidade do aplicativo. Para aprender mais sobre IWM, consulte gravar-bloqueio na documentação do Atlas. Esses recursos estarão disponíveis em clusters do Atlas executando o MongoDB 9.0 e posterior.

Para saber mais sobre esta versão, consulte as notas de versão v2.24 no Github.

Novidades no 2.23

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::Client definindo a opção tracing como true ou defini-la globalmente por meio da variável de ambiente OTEL_RUBY_INSTRUMENTATION_MONGODB_ENABLED.

• Adiciona a opção de configuração csfle_convert_to_ruby_types para 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_transaction ao 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_one e replace_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 SocketError durante verificações de pool de conexões .

• Corrige um ArgumentError que ocorreu quando um servidor foi marcado como unknown.

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 type aos métodos de criação de índice de pesquisa Mongo::SearchIndex::View#create_one e Mongo::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.

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=1 e mongodb://example.com/?w=1 sã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 mongos diferente em uma topologia fragmentada, se possível.

Para saber mais sobre esta versão, consulte as notas de versão v2.20 no Github.