Notas de versão

Novidades no 2.26

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

• Adiciona a opção do cliente :key_expiration_ms, que especifica a vida útil do cache da chave de criptografia de dados em milissegundos. A opção aceita um número inteiro não negativo. Um valor de 0 significa que o cache nunca expira. O valor padrão é 60000.

• Adiciona suporte para queries de texto de Queryable Encryption (QE). Agora você pode executar queries de prefixo, sufixo e substring em campos criptografados. Para saber mais, consulte criptografia em execução.

• Melhora o desempenho do driver com o Intelligent Workload Management (IWM) no MongoDB Server 9.0 ou clusters posteriores. O driver agora tenta novamente erros de sobrecarga somente quando a nova tentativa não piora as condições do servidor .

• Não permite vírgulas no valor da opção de string de conexão authMechanismProperties.

• Consulta encryptedFields no lado do servidor ao descartar collections QE, para que você possa descartar collections que usam criptografia automática.

• Corrige um problema de segurança no GridFS usando uma correspondência exata ao procurar arquivos por ID de arquivo.

• Atualiza a versão mínima exigida de libmongocrypt para 1.20.0 e corrige as opções de query de intervalo e timeout_ms para ClientEncryption.

Para saber mais sobre esta versão, consulte as 226v..0 Notas de versão no GitHub.

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 225v..0 Notas de versão 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 224v..1 Notas de versão 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 Workload Management (IWM). O driver Ruby agora lida normalmente 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 dos aplicação . Para saber mais sobre IWM, consulte Bloqueio de gravação na documentação do Atlas . Estas funcionalidades estarão disponíveis nos clusters Atlas que executam o 9 MongoDB.0 e versões posteriores.

Para saber mais sobre esta versão, consulte as Notas de2 versão do24 v. 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 de2 versão do23 v. 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 de2 versão do22 v. 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 de2 versão do21 v. 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 de2 versão do20 v. no GitHub.