지속성 구성

모델 수준 지속성 옵션

모델 클래스 이름의 복수형이 아닌 다른 이름을 사용하여 컬렉션 에 모델 문서를 저장 한다고 가정해 보겠습니다. store_in 매크로를 사용하여 Mongoid가 모델의 문서를 저장하는 컬렉션, 데이터베이스 또는 클라이언트 변경할 수 있습니다. 다음 예시 store_in 매크로를 사용하여 analytics라는 클라이언트 내의 other 데이터베이스 에 있는 citizens 컬렉션 에 Person 클래스의 문서를 저장 하는 방법을 보여 줍니다.

class Person
  include Mongoid::Document
  store_in collection: "citizens", database: "other", client: "analytics"
end

store_in 매크로는 Lambda 함수를 사용할 수도 있습니다. 이는 상수 문자열을 사용할 수 없는 값으로 지속성 컨텍스트를 정의하려는 경우에 유용합니다.

여러 사용자가 애플리케이션 에 대한 공통 액세스 주식 하는 멀티 테넌트 애플리케이션 에서 이 패턴 사용할 수 있습니다. Lambda를 사용하면 현재 스레드에 로컬인 정보를 기반으로 지속성 컨텍스트를 정의하여 사용자가 서로의 데이터에 액세스 할 수 없도록 할 수 있습니다.

다음 예시 스레드 로컬 변수에 의해 결정되는 데이터베이스 에 문서를 저장합니다.

class Band
  include Mongoid::Document
  store_in database: ->{ Thread.current[:database] }
end

런타임 지속성 옵션

모델 클래스 또는 인스턴스 에서 with 메서드를 사용하여 런타임 중에 작업 그룹 에 대한 모델의 지속성 구성을 변경할 수 있습니다.

모델 클래스 또는 인스턴스 에서 with 메서드를 호출하고 지속성 컨텍스트를 정의하는 옵션을 전달합니다. 두 가지 방법으로 with 메서드를 호출할 수 있습니다.

• with(context, options): context 은(는) Mongoid::PersistenceContext 의 인스턴스 이고 options 는 사용자 지정 가능한 옵션 설정하다 를 나타내는 해시입니다.

• with(options): options 은(는) 사용자 지정 가능한 옵션 설정하다 나타내는 해시입니다.

그런 다음 차단 사용하여 지정된 컨텍스트에서 실행하려는 작업을 정의합니다. 정의한 컨텍스트는 차단 의 코드가 실행되는 동안에만 존재합니다.

기본값 으로 Mongoid는 Band 클래스에 대한 문서를 bands 컬렉션 에 저장합니다. 다음 코드 예시 with 메서드를 사용하여 일시적으로 다른 클라이언트, 데이터베이스 및 컬렉션 사용하여 Band 클래스의 문서에 대한 작업을 수행합니다.

class Band
  include Mongoid::Document
  field :name, type: String
  field :likes, type: Integer
end
# Creates document in 'bands' collection in 'music-non-stop' database within
# default cluster
Band.with(database: "music-non-stop") do |band_class|
  band_class.create(name: "Medusa and the Polyps")
end
# Deletes all documents in 'artists' collection within default database
Band.with(collection: "artists") do |band_class|
  band_class.delete_all
end
band = Band.new(name: "Japanese Breakfast")
# Perform operations on tertiary cluster
band.with(client: :tertiary) do |band_object|
  band_object.save!
    
  band.save!
end

읽기 또는 쓰기 (write) 작업을 위해 with 메서드 구성 옵션을 전달할 수도 있습니다. 구성은 지정된 작업 유형에만 적용 .

다음 예시 with 메서드를 사용하여 차단 내의 모든 읽기 작업에 세컨더리 노드 를 사용하도록 지정합니다.

Band.with(read: {mode: :secondary}) do
  Band.count
  # This write operation runs in the 
  # new persistence context, but is 
  # not affected by the read preference.
  Band.create(name: "Metallica")
end

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

mongo_client.with

다음 코드 예시 Band 모델 클래스에서 사용하는 클라이언트 에 액세스합니다. 그런 다음 클라이언트 의 with 메서드를 사용하여 music 데이터베이스 에 쓰기 (write) w 쓰기 (write) 옵션을 0 로 설정하여 쓰기 (write) 확인이 필요하지 않습니다.

Band.mongo_client.with(write: { w: 0 }, database: "music") do |client|
  client[:artists].find(...)
end

collection.with

with 메서드를 사용하여 컬렉션 의 :read 및 :write 옵션을 재정의할 수 있습니다. 다음 예시 with 메서드를 사용하여 w 쓰기 (write) 옵션을 0(으)로 설정하다 방법을 보여 줍니다.

Band.collection.with(write: { w: 0 }) do |collection|
  collection[:artists].find(...)
end