指定现有文档的验证级别

指定具有 moderate 验证级别的验证规则。

使用 moderate validationLevel 向 movies 集合添加一个验证器：

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

因为 validationLevel 是 moderate，MongoDB 将验证规则应用于所有文档插入和对已满足规则的现有文档的更新。

Insert a valid document.

title以下插入命令添加了一个文档，其中包含一个带有 string 值的字段，这满足了验证规则：

db.movies.insertOne(
   { title: "Wings", year: 1927 }
)

观察结果。

由于该文档满足验证规则，因此插入成功。MongoDB 返回类似以下的输出：

{
  acknowledged: true,
  insertedId: ...
}

指定具有 strict 验证级别的验证规则。

使用 strict validationLevel 向 movies 集合添加一个验证器：

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

由于 validationLevel 为 strict，MongoDB 将验证规则应用于所有文档插入和更新。

Insert a valid document.

title以下插入命令添加了一个文档，其中包含一个带有 string 值的字段，这满足了验证规则：

db.movies.insertOne(
   { title: "The Conversation", year: 1974 }
)

观察结果。

由于该文档满足验证规则，因此插入成功。MongoDB 返回类似以下的输出：

{
  acknowledged: true,
  insertedId: ...
}

（可选）将您的 validationLevel 设置为 strict。

If your collection's validationLevel is not already strict, follow the procedure to specify strict validation.

为 constraint 级别准备集合。

将 prepareConstraintValidationLevel 设置为 true 以运行 collMod：

db.runCommand( {
   collMod: "movies",
   prepareConstraintValidationLevel: true
} )

此命令通过阻止 bypassDocumentValidation 并防止对验证程序进行更改，为升级做好集合准备。

将验证级别设置为 constraint。

运行 collMod 以将 validationLevel 设置为 constraint。validationAction 必须是 error 或 errorAndLog：

db.runCommand( {
   collMod: "movies",
   validationLevel: "constraint",
   validationAction: "error"
} )

您无法在将 validationLevel 升级到 constraint 的同一 collMod 操作中更改 validator。在运行此命令之前，请设置验证规则。要在以后更改规则，将级别降级到 strict，修改规则，然后再升级回 constraint。

由于 validationLevel 为 constraint，MongoDB 会将验证规则应用于所有文档插入和更新，无论现有文档在升级前是否符合这些规则。

当您将级别设置为 constraint 时，MongoDB 会扫描集合中的所有现有文档，如果任何文档违反了验证程序，则会使 collMod 操作失败。对于大型集合，此扫描的计算成本可能很高。如果操作失败，请在继续之前更新违规文档以通过验证程序。

Insert a valid document.

title以下插入命令添加了一个文档，其中包含一个带有 string 值的字段，这满足了验证规则：

db.movies.insertOne(
   { title: "Sunrise", year: 1927 }
)

观察结果。

由于该文档满足验证规则，因此插入成功。MongoDB 返回类似以下的输出：

{
  acknowledged: true,
  insertedId: ...
}