쿼리 연산자로 유효성 검사 지정

제한 사항

• validator 객체에는 다음 쿼리 연산자를 지정할 수 없습니다.

  • $function 표현식이 포함된 $expr

  • $near

  • $nearSphere

  • $text

  • $where

• 다음의 스키마 유효성 검사를 지정할 수 없습니다:

  • adminlocal, config데이터베이스의 collection

  • 시스템 컬렉션

Context

고객 주문을 추적하는 애플리케이션을 예로 들어 보겠습니다. 주문에는 기본 가격과 VAT 가 있습니다. orders collection에는 총 가격을 추적하기 위한 다음과 같은 필드가 포함되어 있습니다.

• price

• VAT

• totalWithVAT

단계

다음 절차에서는 쿼리 연산자를 사용하여 스키마 유효성 검사를 만들어 totalWithVAT가 price 및 VAT의 예상 조합과 일치하는지 확인합니다.

db.createCollection( "orders",
   {
      validator: {
         $expr:
            {
               $eq: [
                  "$totalWithVAT",
                  { $multiply: [ "$total", { $sum:[ 1, "$VAT" ] } ] }
               ]
            }
      }
   }
)

db.orders.insertOne( {
   total: NumberDecimal("141"),
   VAT: NumberDecimal("0.20"),
   totalWithVAT: NumberDecimal("169")
} )

MongoServerError: Document failed validation
Additional information: {
  failingDocumentId: ObjectId("62bcc9b073c105dde9231293"),
  details: {
    operatorName: '$expr',
    specifiedAs: {
      '$expr': {
        '$eq': [
          '$totalWithVAT',
          {
            '$multiply': [ '$total', { '$sum': [ 1, '$VAT' ] } ]
          }
        ]
      }
    },
    reason: 'expression did not match',
    expressionResult: false
  }
}

db.orders.insertOne( {
   total: NumberDecimal("141"),
   VAT: NumberDecimal("0.20"),
   totalWithVAT: NumberDecimal("169.2")
} )

{
  acknowledged: true,
  insertedId: ObjectId("6304f4651e52f124b84479ba")
}

추가 정보

쿼리 연산자 유효성 검사를 JSON schema 유효성 검사와 결합할 수 있습니다.

예를 들어 이 스키마 유효성 검사를 사용하는 sales 컬렉션을 생각해 보겠습니다.

 db.createCollection("sales", {
   validator: {
     "$and": [
       // Validation with query operators
       {
         "$expr": {
           "$lt": ["$lineItems.discountedPrice", "$lineItems.price"]
         }
       },
       // Validation with JSON Schema
       {
         "$jsonSchema": {
           "properties": {
             "items": { "bsonType": "array" }
           }
          }
        }
      ]
    }
  }
)

sales 컬렉션의 문서에 대해 다음과 같은 규칙을 적용하는 유효성 검사가 이루어집니다:

• lineItems.discountedPrice lineItems.price보다 작아야 합니다. 이 규칙은 $lt 연산자를 사용하여 지정됩니다.

• items 필드는 배열이어야 합니다. 이 규칙은 $jsonSchema를 사용하여 지정됩니다.

자세히 알아보기

• MongoDB에서 사용할 수 있는 모든 쿼리 연산자는 쿼리 선택기를 참조하세요.

• 쿼리 언어 내에서 집계 표현식을 사용할 수 있는 $expr 연산자에 대한 자세한 내용은 $expr을 참조하세요.