호환성

이 페이지의 내용

Ruby MongoDB 드라이버 호환성

Ruby 호환성
MongoDB 서버 호환성
Rails 호환성
Rails 프레임워크 지원

Ruby MongoDB 드라이버 호환성

다음 호환성 표는 지정된 Mongoid 버전의 최신 패치 릴리스에서 지원하는 MongoDB 용 Ruby 운전자 ( mongo gem)의 버전을 명시합니다.

참고

동일한 마이너 릴리스에 포함된 이전 버전의 Mongoid는 이전 드라이버 버전을 지원할 수 있습니다. 예를 들어 Mongoid 7.0.5는 드라이버 버전 2.5 이상을 지원하는 반면 Mongoid 7.0.6에는 드라이버 버전 2.7 이상이 필요합니다.

몽고이드	드라이버 2.19-2.18	드라이버 2.17-2.10	드라이버 2.9-2.7
8.0 ~ 9.0	✓
7.2 ~ 7.5	✓	✓
7.0 ~ 7.1	✓	✓	✓

Ruby 호환성

다음 호환성 표에는 Mongoid에서 지원하는 Ruby 인터프리터 버전이 명시되어 있습니다. "D"가 표시된 열은 해당 Ruby 버전에 대한 지원이 중단되었음을 의미합니다.

몽고이드	Ruby 3.3	Ruby 3.2	Ruby 3.1	Ruby 3.0	Ruby 2.7	Ruby 2.6	Ruby 2.5	Ruby 2.4	Ruby 2.3	Ruby 2.2	JRuby 9.4	JRuby 9.3	JRuby 9.2
9.0	✓ [1]	✓	✓	✓	✓						✓
8.1	✓ [1]	✓	✓	✓	✓	✓						✓
8.0			✓	✓	✓	✓						✓
7.5			✓	✓	✓	✓	D					✓	D
7.4			✓	✓	✓	✓	✓						✓
7.3			✓ [2]	✓ [2]	✓	✓	✓	D	D				✓
7.2			✓ [3]	✓ [3]	✓	✓	✓	D	D				✓
7.1			✓ [4]	✓ [4]	✓	✓	✓	✓ [5]	✓				✓
7.0					✓	✓	✓	✓ [5]	✓	✓ [6]			✓

[1]	(1, 2) Ruby 3.3 에는 Mongoid 8.1.7 및 가 9 필요합니다.0.3 81 을 해당 9 0 에 추가합니다. 및 . 안정적인 브랜치.

[2]	(1, 2) Mongoid 버전 7.3.2 이상이 필요합니다.

[3]	(1, 2) Mongoid 버전 7.2.5 이상이 필요합니다.

[4]	(1, 2) Mongoid 버전 7.1.10 이상이 필요합니다.

[5]	(1, 2) Ruby 버전 2.4.1 이상이 필요합니다.

[6]	Ruby 버전 2.2.2 이상이 필요합니다.

MongoDB 서버 호환성

다음 호환성 표는 특정 버전의 MongoDB Server에서 사용할 권장 Mongoid 버전을 지정합니다.

특정 MongoDB 서버 버전의 기능을 사용하려면 운전자 와 Mongoid가 모두 해당 서버 버전을 지원 해야 합니다. 운전자 호환성 매트릭스 는 운전자 호환성 페이지 를 참조하세요.

"D"가 표시된 열은 해당 MongoDB Server 버전에 대한 지원이 더 이상 사용되지 않으며 다음 버전에서 제거됨을 의미합니다.

몽고이드	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2	MongoDB 4.0	MongoDB 3.6	MongoDB 3.4	MongoDB 3.2	MongoDB 3.0	MongoDB 2.6
8.0 ~ 9.0	✓	✓	✓	✓	✓	✓	✓
7.4 ~ 7.5	✓	✓	✓	✓	✓	✓	✓	D	D	D	D
7.0 ~ 7.3			✓	✓	✓	✓	✓	D	D	D	D

Rails 호환성

다음 호환성 표에는 Mongoid가 지원하는 Ruby on Rails 버전이 명시되어 있습니다.

몽고이드	Rails 8.0	Rails 7.2	Rails 7.1	Rails 7.0	Rails 6.1	Rails 6.0	Rails 5.2	Rails 5.1
9.0	✓ [13]	✓ [12]	✓ [11]	✓	✓	✓
8.1	✓ [13]	✓ [12]	✓ [11]	✓	✓	✓	✓ [7]
8.0			✓ [11]	✓	✓	✓	✓ [7]
7.5				✓	✓	✓	✓ [7]	D
7.4				✓	✓	✓	✓ [7]	✓ [7]
7.3				✓ [10]	✓	✓	✓ [7]	✓ [7]
7.2					✓ [9]	✓	✓ [7]	✓ [7]
7.1					✓ [9]	✓	✓	✓
7.0					✓ [9]	✓ [8]	✓	✓

[ 7 ]

(1, 2, 3, 4, 5, 6, 7, 8, 9) Ruby 3에서 Rails 5.x를 사용하는 것은 지원되지 않습니다.

[8]	Rails 6.0에는 Mongoid 7.0.5 이상이 필요합니다.

[ 9 ]

(1, 2, 3) Rails 6.1에는 Mongoid 7.0.12가 필요합니다, 7.1.7 또는 7.2.1을 각각 7.0, 7.1 및 7.2 안정 브랜치로 업데이트하세요.

[10]	Rails 7.x에는 Mongoid 7.3.4 이상이 필요합니다.

[ 11 ]

(1, 2, 3) Rails 7.1 에는 Mongoid 8.0 가 필요합니다.7 또는 8.1.3 를 해당 8 에 추가합니다.0 및 8.1 안정적인 브랜치.

[ 12 ]

(1, 2) Rails 7.2 에는 Mongoid 8.1.6 및 9 가 필요합니다.0.2 을 해당 8 에 추가합니다.1 및 9.0 안정적인 브랜치.

[ 13 ]

(1, 2) Rails 8.0 에는 Mongoid 8.1.7 및 9 가 필요합니다.0.3 을 해당 8 에 추가합니다.1 및 9.0 안정적인 브랜치.

Rails 프레임워크 지원

Ruby on Rails는 여러 프레임워크로 구성되어 있으며, Mongoid는 가능한 한 호환성을 제공하려고 시도합니다.

Mongoid가 Active Record 과의 API 호환성을 제공하려고 시도하지만 , Active Record에 직접적으로 의존하는 라이브러리는 Mongoid를 드롭인 대체품으로 사용할 때 예상대로 작동하지 않을 수 있습니다.

참고

Mongoid는 동일한 애플리케이션 내에서 Active Record와 함께 문제 없이 사용할 수 있습니다.

Rails 프레임워크	지원되나요?
`ActionCable`	✓ [14]
`ActionMailbox`	✗ [15]
`ActionMailer`	✓
`ActionPack`	✓
`ActionText`	✗ [15]
`ActionView`	✓
`ActiveJob`	✓ [18]
`ActiveModel`	✓ [16]
`ActiveStorage`	✗ [15]
`ActiveSupport`	✓ [17]

[14]	현재 에 대한 MongoDB 어댑터는 `ActionCable` 없지만 기존 어댑터(예:Redis)은 Mongoid 모델과 함께 성공적으로 사용할 수 있습니다.

[ 15 ] (1, 2, 3) ActiveRecord에 직접 종속됨

[16]	`Mongoid::Document` `ActiveModel::Model` 을 포함하고 유효성 검사를 위해 `ActiveModel::Validations` 활용

[17]	`Mongoid` `ActiveSupport` 이(가) 필요하며 시간 처리를 위한 `ActiveSupport::TimeWithZone` 을(를) 포함하여 광범위하게 사용합니다.

[18]

BSON & Mongoid 객체의 직렬화는 명시적으로 BSON::ObjectId 를 문자열로 전송하고 작업에서 이를 재구성하는 경우 가장 잘 작동합니다.

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

돌아가기

설치

구성