Menu Docs

Compatibilidade

A tabela de compatibilidade a seguir especifica as versões do driver Ruby compatíveis com cada versão Mongoid.

Observação

Compatibilidade com a versão do patch

Versões de patch mais antigas do Mongoid na mesma versão menor podem suportar versões mais antigas do driver Ruby. Por exemplo, Mongoid v7.0.5 suporta o driver Ruby v2.5 e posterior, mas o Mongoid v7.0.6 requer driver v2.7 ou posterior.

Versão mongoid
Ruby Driver 2.18 a 2.21
Ruby Driver 2.10 a 2.17
Ruby Driver 2.7 a 2.9

8.0 a 9.0

A tabela de compatibilidade a seguir especifica a versão recomendada ou versões do Mongoid que você pode usar com uma versão específica do MongoDB. Para usar recursos de uma versão específica do MongoDB Server , o driver Ruby e o Mongoid devem ser compatíveis com essa versão do MongoDB . Para saber mais sobre os detalhes de compatibilidade do driver MongoDB , consulte Compatibilidade na documentação do driver Ruby.

A primeira coluna lista a versão do Mongoid.

Importante

O MongoDB garante a compatibilidade entre o MongoDB Server e os drivers por três anos após a data de fim da vida útil (EOL) da versão do servidor. Para saber mais sobre a versão do MongoDB e as datas de EOL, consulte Agendamentos do ciclo de vida do software MongoDB.

Icon
Explicação

Todas as funcionalidades são suportadas.

A versão Driver funcionará com a versão MongoDB, mas nem todos os novos recursos MongoDB são suportados.

Sem marca

A versão Driver não é testada com a versão MongoDB.

Versão mongoid
MongoDB 8.0
MongoDB 7.0
MongoDB 6.0
MongoDB 5.0
MongoDB 4.4
MongoDB 4.2
MongoDB 4.0
MongoDB 3.6

9.0

8.0 a 8.1

Para saber mais sobre como ler as tabelas de compatibilidade, consulte o guia sobre tabelas de compatibilidade do MongoDB .

A tabela de compatibilidade a seguir especifica a versão recomendada ou versões do Mongoid que você pode usar com versões específicas do interpretador Ruby.

A primeira coluna lista a versão do Mongoid.

Versão mongoid
Ruby 3.2
Ruby 3.1
Ruby 3.0
Ruby 2.7
Ruby 2.6
Ruby 2.5
JRuby 9.4
JRuby 9.3
JRuby 9.2

9.0

8.1

8.0

Para saber mais sobre como ler as tabelas de compatibilidade, consulte o guia sobre tabelas de compatibilidade do MongoDB .

A tabela de compatibilidade a seguir especifica quais versões do Ruby on Rails são suportadas pelo Mongoid.

Versão mongoid
Trilhos 8.0
Trilhos 7.2
Trilhos 7.1
Rails 7.0
Trilhos 6.1
Rails 6.0
Trilhos 5.2
Rails 5.1

9.0

[1]

[2]

[3]

8.1

[1]

[2]

[3]

[4]

8.0

[3]

[4]

[1](1, 2) As ferrovias 8.0 exigem Mongoid v8.1.7 e v9.0.3 nos respectivos 8.1 e 9.0 ramificações estáveis.
[2](1, 2) As ferrovias 7.2 exigem Mongoid v8.1.6 e v9.0.2 nos respectivos 8.1 e 9.0 ramificações estáveis.
[3](1, 2, 3) As ferrovias 7.1 exigem Mongoid v8.0.7 ou v8.1.3 nos respectivos 8.0 e 8.1 ramificações estáveis.
[4](1, 2) A utilização do Rails 5.x com Ruby 3 não é suportada.

O Mongoid é compatível com muitas das estruturas que compõem o Ruby on Rails. Nesta seção, você pode aprender sobre quais estruturas você pode usar com o Mongoid.

O Mongoid tenta oferecer compatibilidade de API com o Active Record, mas as bibliotecas que dependem diretamente do Active Record podem não funcionar como esperado se você usar o Mongoid como uma substituição direta.

Observação

Você pode usar o Mongoid junto com o Active Record no mesmo aplicação.

Framework Rails
Suporte Mongoid
Notas

ActionCable

Não há adaptador MongoDB ActionCable para, mas você pode usar qualquer adaptador existente, como o Adaptador Redis, junto com os modelos Mongoid.

ActionMailbox

Não suportado

Depende diretamente do Active Record.

ActionMailer

ActionPack

ActionText

Não suportado

Depende diretamente do Active Record.

ActionView

ActiveJob

A serialização de objetos BSON e Mongoid funciona melhor se você enviar explicitamente valores BSON::ObjectId como strings e reconstruí-los no tarefa. Por exemplo:

record = Model.find(...)
MyJob.perform_later(record._id.to_s)
class MyJob < ApplicationJob
def perform(id_as_string)
record = Model.find(id_as_string)
# ...
end
end

ActiveModel

O Mongoid::Document módulo inclui ActiveModel::Model e aproveita o ActiveModel::Validations para validação de documentos.

ActiveStorage

Não suportado

Depende diretamente do Active Record.

ActiveSupport

O módulo Mongoid exige ActiveSupport. Mongoid utiliza ActiveSupport::TimeWithZone para lidar com valores de tempo.

Se você tiver dúvidas sobre compatibilidade, acesse os seguintes recursos para obter mais orientações: