クエリ演算子による検証を指定する

制限事項

• validatorオブジェクトでは次のクエリ演算子を指定できません。

  • $exprと$function式

  • $near

  • $nearSphere

  • $text

  • $where

• 次のスキーマ検証は指定することはできません。

  • admin データベース、local データベース、config データベースのコレクション

  • システム コレクション

Context

カスタマーの注文を追跡するアプリケーションを考えてみましょう。 注文には基本価格と VATが含まれます。 ordersコレクションには、合計価格を追跡するための次のフィールドが含まれています。

• 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をご覧ください。