模式验证_MonogDB 中文网

参考 > 资料模型 > 模式验证

在本页面

指定验证规则
JSON模式
其他查询表达式
行为
限制条件
绕过文件验证
附加信息

3.2版中的新功能。

MongoDB提供了在更新和插入期间执行架构验证的功能。

指定验证规则¶

验证规则基于每个集合。

要在创建新集合时指定验证规则，请db.createCollection()与validator选项一起使用。

要将文档验证添加到现有集合，请使用 collMod带有该validator选项的command 。

MongoDB还提供以下相关选项：

validationLevel 选项，该选项确定MongoDB在更新过程中对验证规则对现有文档应用的严格程度，以及
validationAction选项，该选项确定MongoDB是应该 error还是拒绝违反验证规则的文档或 warn有关日志中违反但允许无效文档的文档。

JSON模式¶

3.6版的新功能。

从3.6版开始，MongoDB支持JSON模式验证。要指定JSON模式验证，请$jsonSchema在validator表达式中使用运算符。

注意

推荐使用JSON模式进行模式验证。

例如，以下示例使用JSON模式指定验证规则：

复制

db.createCollection("students", {
   validator: {
      $jsonSchema: {
         bsonType: "object",
         required: [ "name", "year", "major", "address" ],
         properties: {
            name: {
               bsonType: "string",
               description: "must be a string and is required"
            },
            year: {
               bsonType: "int",
               minimum: 2017,
               maximum: 3017,
               description: "must be an integer in [ 2017, 3017 ] and is required"
            },
            major: {
               enum: [ "Math", "English", "Computer Science", "History", null ],
               description: "can only be one of the enum values and is required"
            },
            gpa: {
               bsonType: [ "double" ],
               description: "must be a double if the field exists"
            },
            address: {
               bsonType: "object",
               required: [ "city" ],
               properties: {
                  street: {
                     bsonType: "string",
                     description: "must be a string if the field exists"
                  },
                  city: {
                     bsonType: "string",
                     "description": "must be a string and is required"
                  }
               }
            }
         }
      }
   }
})

有关更多信息，请参见$jsonSchema。

其他查询表达式¶

除了使用了JSON模式验证 $jsonSchema查询操作，MongoDB的支持与验证等查询操作符，与例外$near， $nearSphere，$text，和$where运营商。

例如，以下示例使用查询表达式指定验证器规则：

复制

db.createCollection( "contacts",
   { validator: { $or:
      [
         { phone: { $type: "string" } },
         { email: { $regex: /@mongodb\.com$/ } },
         { status: { $in: [ "Unknown", "Incomplete" ] } }
      ]
   }
} )

也可以看看

查询运算符

行为¶

验证在更新和插入期间进行。当您向集合中添加验证时，现有文档将不进行验证检查，直到进行修改。

现有文档¶

该validationLevel选项确定MongoDB应用验证规则的操作：

如果validationLevel为strict（默认），则MongoDB将验证规则应用于所有插入和更新。
如果validationLevel为moderate，则MongoDB将验证规则应用于已满足验证条件的现有文档的插入和更新。对于该moderate级别，不检查对不满足验证标准的现有文档的更新的有效性。

例如，contacts使用以下文档创建一个集合：

复制

db.contacts.insert([
   { "_id": 1, "name": "Anne", "phone": "+1 555 123 456", "city": "London", "status": "Complete" },
   { "_id": 2, "name": "Ivan", "city": "Vancouver" }
])

发出以下命令以将验证器添加到contacts 集合中：

复制

db.runCommand( {
   collMod: "contacts",
   validator: { $jsonSchema: {
      bsonType: "object",
      required: [ "phone", "name" ],
      properties: {
         phone: {
            bsonType: "string",
            description: "must be a string and is required"
         },
         name: {
            bsonType: "string",
            description: "must be a string and is required"
         }
      }
   } },
   validationLevel: "moderate"
} )

该contacts集合现在有与A验证moderate validationLevel：

如果你试图用更新文档_id中1，MongoDB的会因为现有的文档标准匹配应用验证规则。
相比之下，MongoDB中不会验证规则适用于文档更新用_id的2，因为它不符合验证规则。

要完全禁用验证，可以设置validationLevel为 off。

接受或拒绝无效的文档¶

该validationAction选项确定MongoDB如何处理违反验证规则的文档：

如果validationAction是error（默认），则MongoDB拒绝任何违反验证条件的插入或更新。
如果validationAction为warn，则MongoDB会记录任何违规情况，但允许进行插入或更新。

例如，contacts2使用以下JSON模式验证器创建一个集合：

复制

db.createCollection( "contacts2", {
   validator: { $jsonSchema: {
      bsonType: "object",
      required: [ "phone" ],
      properties: {
         phone: {
            bsonType: "string",
            description: "must be a string and is required"
         },
         email: {
            bsonType : "string",
            pattern : "@mongodb\.com$",
            description: "must be a string and match the regular expression pattern"
         },
         status: {
            enum: [ "Unknown", "Incomplete" ],
            description: "can only be one of the enum values"
         }
      }
   } },
   validationAction: "warn"
} )

使用warn validationAction，MongoDB会记录所有违规情况，但允许进行插入或更新。

例如，以下插入操作违反了验证规则：

复制

db.contacts2.insert( { name: "Amanda", status: "Updated" } )

但是，由于validationAction是warn唯一的，因此MongoDB仅记录验证违反消息并允许操作继续进行：

复制

2017-12-01T12:31:23.738-0500 W STORAGE  [conn1] Document would fail validation collection: example.contacts2 doc: { _id: ObjectId('5a2191ebacbbfc2bdc4dcffc'), name: "Amanda", status: "Updated" }

限制¶

你不能指定的集合验证程序admin， local和config数据库。

您不能为system.*集合指定验证器。

旁路文档验证¶

用户可以使用该bypassDocumentValidation选项绕过文档验证。

以下命令可以使用new选项绕过每个操作的验证bypassDocumentValidation：

applyOps 命令
findAndModify命令与 db.collection.findAndModify()方法
mapReduce命令与 db.collection.mapReduce()方法
insert 命令
update 命令
$out和$merge用于阶段 aggregate命令和 db.collection.aggregate()方法

对于已启用访问控制的部署，要绕过文档验证，已认证的用户必须 bypassDocumentValidation采取措施。内置角色 dbAdmin并restore提供此操作。

其他信息¶

也可以看看

collMod，db.createCollection()， db.getCollectionInfos()。

MongoDB 中文手册

模式验证

指定验证规则¶

JSON模式¶

其他查询表达式¶

行为¶

现有文档¶

接受或拒绝无效的文档¶

限制¶

旁路文档验证¶

其他信息¶