필드 유형

유형이 지정되지 않은 필드

필드 의 유형을 지정하지 않으면 Mongoid는 이를 기본값 Object 유형으로 해석합니다. 유형이 지정되지 않은 필드 BSON 에 직접 직렬화할 수 있는 모든 유형의 값을 저장 수 있습니다. 필드 다른 유형의 데이터가 포함되어 있거나 필드 값의 유형을 알 수 없는 경우 필드 유형화하지 않은 상태로 둘 수 있습니다.

다음 예시 유형이 지정되지 않은 필드 있는 Product 클래스를 정의합니다.

class Product
  include Mongoid::Document
  field :name, type: String
  field :properties
end

properties 필드 의 유형은 Object 이지만 해당 필드 에 저장된 데이터 유형에 따라 달라집니다. 다음 예시 두 가지 방법으로 properties 필드 에 데이터를 저장합니다.

product = Product.new(properties: "color=white,size=large")
# properties field saved as String: "color=white,size=large"
product = Product.new(properties: {color: "white", size: "large"})
# properties field saved as Object: {:color=>"white", :size=>"large"}

Mongoid는 데이터베이스 에서 읽을 때 유형이 지정되지 않은 필드에 대해 유형 변환을 수행하지 않기 때문에 특별한 처리가 필요한 값은 유형이 지정되지 않은 필드 의 값으로 올바르게 검색되지 않을 수 있습니다. 다음 BSON 데이터 유형은 유형이 지정되지 않은 필드에 저장 하지 마세요.

• Date: 유형이 지정되지 않은 필드에서 Time(으)로 반환

• DateTime: 유형이 지정되지 않은 필드에서 Time(으)로 반환

• Range: 유형이 지정되지 않은 필드에서 Hash(으)로 반환

해시

Hash 유형을 사용하여 필드 에 Hash 데이터를 저장 수 있습니다. 필드 를 Hash 로 지정하는 경우, 값이 데이터베이스 에 제대로 저장 되도록 MongoDB 이름 지정 제한 사항을 준수해야 합니다.

다음 예시 Person 클래스를 만들고 url 필드 Hash로 지정합니다.

class Person
  include Mongoid::Document
  field :first_name
  field :url, type: Hash
end
person = Person.new(url: {'home_page' => 'http://www.homepage.com'})

시간

Time 필드 값을 사용하여 값을 BSON Time 인스턴스로 저장 수 있습니다. Time 필드는 애플리케이션 에 구성된 구역 에 저장됩니다. 시간대 구성에 대해 자세히 학습 애플리케이션 구성 가이드 의 시간대 구성 섹션을 참조하세요.

다음 예시 Voter 클래스를 만들고 registered_at 필드 의 값이 Time 유형으로 지정합니다.

class Voter
  include Mongoid::Document
  
  field :registered_at, type: Time
end
  
Voter.new(registered_at: Date.today)

날짜

Date로 지정된 필드 에 다음 값 유형을 저장 수 있습니다.

• Date: 제공된 대로 값을 저장합니다.

• Time: 값의 표준 구역 에 따라 값의 날짜 부분을 저장합니다.

• DateTime: 값의 표준 구역 에 따라 값의 날짜 부분을 저장합니다.

• ActiveSupport::TimeWithZone: 값의 표준 구역 에 따라 값의 날짜 부분을 저장합니다.

• String: 문자열에 지정된 날짜를 저장합니다.

• Integer: 값을 UTC 타임스탬프처럼 취하여 애플리케이션에 구성된 표준 구역 로 변환합니다. 그런 다음 Mongoid는 해당 타임스탬프에서 가져온 날짜를 저장합니다.

• Float: 값을 UTC 타임스탬프처럼 취하여 애플리케이션에 구성된 표준 구역 로 변환합니다. 그런 다음 Mongoid는 해당 타임스탬프에서 가져온 날짜를 저장합니다.

Time 또는 DateTime 변환하면 시간 부분이 삭제되므로 String, Time 및 DateTime 객체를 필드 에 할당하기 전에 명시적으로 Date 로 변환하는 것이 좋습니다.

날짜/시간

DateTime 로 정의된 필드 에 값을 할당하거나 이러한 필드에 쿼리 Mongoid는 해당 값을 MongoDB 서버 로 보내기 전에 UTC Time 값으로 변환합니다. Mongoid는 DateTime 객체 에 포함된 구역 와 함께 값을 저장합니다. 값을 조회 때 Mongoid는 UTC 시간을 애플리케이션 에 구성된 구역 로 변환합니다.

다음 예시 Ticket 클래스를 만들고 purchased_at 필드 DateTime 필드 로 지정합니다.

class Ticket
  include Mongoid::Document
  field :purchased_at, type: DateTime
end

DateTime 필드 에 정수 또는 부동 소수점 값을 저장하면 해당 값은 UTC에서 Unix 타임스탬프로 처리됩니다. 다음 예시 정수 값을 purchased_at 필드 에 저장합니다.

ticket.purchased_at = 1544803974
ticket.purchased_at
# Outputs: Fri, 14 Dec 2018 16:12:54 +0000

DateTime 필드 에 문자열 값을 저장하면 Mongoid는 지정된 시간대 구역 사용하여 티켓 저장합니다. 시간대 구역 지정되지 않은 경우, Mongoid는 애플리케이션 의 기본값 으로 구성된 시간대를 사용하여 값을 저장합니다.

ticket.purchased_at = 'Mar 4, 2018 10:00:00 +01:00'
ticket.purchased_at
# Outputs: Sun, 04 Mar 2018 09:00:00 +0000

시간대 구성에 대해 자세히 학습 애플리케이션 구성 가이드 의 시간대 구성 섹션을 참조하세요.

타임스탬프

클래스를 만들 때 Mongoid::Timestamps 모듈을 포함하여 클래스에 타임스탬프 필드를 포함할 수 있습니다. Mongoid::Timestamps를 포함하면 Mongoid는 클래스에 다음 필드를 생성합니다.

• created_at: 문서 가 생성된 시간을 저장합니다.

• updated_at: 문서 마지막으로 업데이트된 시간을 저장합니다.

다음 예시 타임스탬프 필드가 있는 Post 클래스를 만듭니다.

class Post
  include Mongoid::Document
  include Mongoid::Timestamps
end

Created 또는 Updated 모듈만 포함하여 created_at 또는 updated_at 필드만 포함하도록 선택할 수도 있습니다. 다음 예시 created_at 필드 만 있는 Post 클래스와 updated_at 필드 만 있는 Post 클래스를 만듭니다.

class Post
  include Mongoid::Document
  include Mongoid::Timestamps::Created
end
class Post
  include Mongoid::Document
  include Mongoid::Timestamps::Updated
end

모듈을 포함할 때 ::Short 옵션을 설정하여 타임스탬프 필드 이름을 c_at 및 u_at(으)로 줄일 수 있습니다.

class Post
  include Mongoid::Document
  include Mongoid::Timestamps::Short # For c_at and u_at.
end
class Post
  include Mongoid::Document
  include Mongoid::Timestamps::Created::Short # For c_at only.
end
class Post
  include Mongoid::Document
  include Mongoid::Timestamps::Updated::Short # For u_at only.
end

메서드 호출에서 timeless 메서드를 호출하여 특정 작업에 대한 타임스탬프 필드 생성을 비활성화할 수 있습니다. 다음 예시 save 작업에 대한 타임스탬프를 비활성화합니다.

post.timeless.save

정규 표현식

Regexp 유형을 사용하여 필드 에 정규 표현식을 저장 수 있습니다.

MongoDB PCRE( 펄 (Perl) Compatible regular Expressions)를 구현하지만, Mongoid는 Ruby의 Onigmo 라이브러리를 사용합니다. PCRE와 Onigmo는 일반적으로 유사한 기능을 제공하지만, 몇 가지 구문 차이점이 있습니다. 예시 를 들어, Onigmo는 \A 와 \z 를 사용하여 문자열의 시작과 끝을 일치시키는 반면, PCRE는 ^ 와 $를 사용합니다.

필드 를 Regexp로 선언하면 Mongoid는 결과를 데이터베이스 에 저장할 때 Ruby 정규 표현식을 BSON 정규 표현식으로 변환합니다. 데이터베이스 필드 Bson::Regexp::Raw 인스턴스 로 반환합니다. BSON::Regexp::Raw 인스턴스에서 compile 메서드를 사용하여 데이터를 Ruby 정규 표현식 으로 다시 변환할 수 있습니다.

다음 예시 Token 클래스를 만들고 pattern 필드 Regexp로 지정합니다.

class Token
  include Mongoid::Document
  
  field :pattern, type: Regexp
end
  
token = Token.create!(pattern: /hello.world/m)
token.pattern
# Outputs: /hello.world/m
# Reload the token from the database
token.reload
token.pattern
# Outputs: #<BSON::Regexp::Raw:0x0000555f505e4a20 @pattern="hello.world", @options="ms">

BigDecimal

BigDecimal 유형을 사용하면 향상된 정밀도로 숫자를 저장 수 있습니다. Mongoid는 Mongoid.map_big_decimal_to_decimal128 구성 속성 에 설정하다 값에 따라 두 가지 방식으로 BigDecimal 값을 저장합니다.

• true로 설정하다 하면 Mongoid는 BigDecimal 값을 BSON Decimal128 값으로 저장합니다.

• false ( 기본값 )으로 설정하다 하면 Mongoid는 BigDecimal 값을 문자열로 저장합니다.

Mongoid.map_big_decimal_to_decimal128 옵션을 true로 설정할 때는 다음과 같은 제한 사항을 고려하세요.

• Decimal128 범위 와 정밀도는 제한되어 있습니다. Decimal128 의 최대값은 약 10^6145 이고 최소값은 약 -10^6145이며 최대 정밀도는 34 비트입니다. 이러한 제한을 벗어난 값을 저장하는 경우 대신 문자열로 저장하는 것이 좋습니다.

• Decimal128 은(는) 부호가 있는 NaN 값을 허용하지만 BigDecimal 는 허용하지 않습니다. 데이터베이스 에서 부호가 있는 NaN Decimal128 값을 BigDecimal 로 검색하면 부호가 없는 값이 반환됩니다.

• Decimal128 은 후행 0을 유지하지만 BigDecimal 은(는) 유지하지 않습니다. 이 때문에 데이터베이스 에서 Decimal128 값을 BigDecimal(으)로 검색하면 정밀도가 손실될 수 있습니다.

StringifiedSymbol

StringifiedSymbol 필드 유형을 사용하여 Ruby 애플리케이션에 기호로 노출해야 하는 값을 저장 . StringifiedSymbol 를 사용하면 다른 드라이버와의 상호 운용성을 보장하면서 기호를 사용할 수 있습니다. 이 유형은 데이터베이스 의 모든 데이터를 문자열로 저장하고, 애플리케이션 에서 읽을 때 문자열을 기호로 변환합니다. 정수, 배열과 같이 기호로 직접 변환할 수 없는 값은 문자열로 변환한 다음 기호로 변환합니다.

다음 예시 status 필드 StringifiedSymbol 로 정의하고 필드 가 저장되고 반환되는 방법을 보여 줍니다.

class Post
  include Mongoid::Document
  
  field :status, type: StringifiedSymbol
end
  
# Save status as a symbol
post = Post.new(status: :hello)
# status is stored as "hello" on the database, but returned as a Symbol
post.status
# Outputs: :hello
# Save status as a string
post = Post.new(status: "hello")
# status is stored as "hello" in the database, but returned as a Symbol
post.status
# Outputs: :hello

팬텀 사용자 정의 필드 유형

애플리케이션 에 할당된 값과 다른 값을 데이터베이스 에 저장하는 사용자 지정 필드 유형을 만들 수 있습니다. 이 기능은 애플리케이션 에 설명이 포함된 값을 사용하면서 데이터베이스 에 보다 간결한 값을 저장하는 데 유용할 수 있습니다.

다음 예시 애플리케이션 에서 색상 이름을 사용하지만 데이터베이스 에 색상을 정수로 저장하는 ColorMapping 유형을 만듭니다.

class ColorMapping
  MAPPING = {
    'black' => 0,
    'white' => 1,
  }.freeze
  INVERSE_MAPPING = MAPPING.invert.freeze
  class << self
    def mongoize(object)
      MAPPING[object]
    end
    def demongoize(object)
      INVERSE_MAPPING[object]
    end
    def evolve(object)
      MAPPING.fetch(object, object)
    end
  end
end
class Profile
  include Mongoid::Document
  field :color, type: ColorMapping
end
profile = Profile.new(color: 'white')
profile.color
# Outputs: "white"
# Sets "color" field to 0 in MongoDB
profile.save!