지속성 구성

모델 수준 지속성 옵션

모델별로 사용자 지정 컬렉션 이름, 다른 데이터베이스 또는 다른 클라이언트 에 저장 하도록 지정할 수 있습니다. 다음 예시 에서는 기본값 으로 밴드 클래스를 " 음악 " 데이터베이스 의 " 아티스트 " 컬렉션 에 저장 하고 클라이언트 "분석"을 사용합니다.

client 옵션에 제공된 값은 mongoid.yml의 clients 아래에 구성되어야 합니다.

class Band
  include Mongoid::Document
  store_in collection: "artists", database: "music", client: "analytics"
end

store_in 매크로가 제공되지 않았다면 Mongoid는 기본값 클라이언트 의 기본값 데이터베이스 에 있는 'Bands'라는 컬렉션 에 모델을 저장 합니다.

런타임 지속성 옵션

모델 클래스 또는 인스턴스 에서 with 메서드를 사용하여 작업 그룹 의 지속성에 사용되는 클라이언트, 데이터베이스 및 컬렉션 뿐만 아니라 모든 MongoDB 클라이언트 옵션을 변경할 수 있습니다.

Band.with(database: "music-non-stop") do |klass|
  klass.create(...)
  band = Band.first
  Band.create(...)
end
Band.with(collection: "artists") do |klass|
  klass.delete_all
  Band.delete_all
end
band.with(client: :tertiary) do |band_object|
  band_object.save!
  band.save!
end

with 메서드는 임시 지속성 컨텍스트와 컨텍스트의 작업에 사용할 MongoDB 클라이언트 를 생성합니다. 차단 기간 동안 with 가 호출된 모델 클래스 또는 인스턴스 의 지속성 컨텍스트는 임시 지속성 컨텍스트로 변경됩니다. 편의상 with 가 호출된 모델 클래스 또는 인스턴스 는 차단 에 반환됩니다.

임시 지속성 컨텍스트는 쿼리와 쓰기 모두에 적용됩니다.

다양한 지속성 컨텍스트에서 지속성 작업을 수행할 때는 주의를 기울여야 합니다. 예를 예시 문서 가 임시 지속성 컨텍스트에 저장된 경우 기본값 지속성 컨텍스트에 문서가 존재하지 않아 후속 업데이트에 실패할 수 있습니다.

band = Band.new(name: "Scuba")
band.with(collection: "artists") do |band_object|
  band_object.save!
end
# This will not save - updates the collection "bands" which does not have
# the Scuba band
band.update_attribute(likes: 1000)
# This will update the document.
band.with(collection: "artists") do |band_object|
  band_object.update_attribute(likes: 1000)
end

Mongoid 6.0 부터 with 메서드는 항상 차단 과 함께 호출되어야 하며 임시 지속성 컨텍스트는 차단 기간 동안만 존재합니다. 이는 with 에 전달된 옵션을 사용하여 새 클라이언트 가 내부적으로 생성되기 때문입니다. 이 클라이언트 가 닫히고 관련 리소스가 해제되도록 하려면 이 클라이언트 를 사용할 수 있는 범위를 잘 정의해야 합니다.

class BandsController < ApplicationController
  before_action :switch_database
  after_action :reset_database
  private
  def switch_database
    I18n.locale = params[:locale] || I18n.default_locale
    Mongoid.override_database("my_db_name_#{I18n.locale}")
  end
  def reset_database
    Mongoid.override_database(nil)
  end
end

Band.with(read: {mode: :secondary}) do
  Band.count
end

클라이언트 및 컬렉션 액세스

작업을 수행하기 위해 운전자 수준으로 드롭다운하려면 모델 또는 문서 인스턴스 에서 mongo 클라이언트 또는 컬렉션 을 가져올 수 있습니다.

Band.mongo_client
band.mongo_client
Band.collection
band.collection

여기에서 클라이언트의 #with 을(를) 사용하여 동일한 런타임 지속성 옵션을 사용할 수도 있습니다.

client = Band.mongo_client.with(write: { w: 0 }, database: "musik")
client[:artists].find(...)

#with 컬렉션을 사용하여 컬렉션 의 :read 또는 : 쓰기 (write) 옵션을 재정의할 수도 있습니다.

collection_w_0 = Band.collection.with(write: { w: 0 })
collection_w_0[:artists].find(...)