选择如何处理无效文件

您可以指定 MongoDB 如何处理违反违规规则的文档。当操作会导致无效文档时，MongoDB 可以：

拒绝任何违反验证标准的插入或更新。这是默认行为。
允许操作继续，但在 MongoDB 日志中记录违规。

拒绝无效文档可确保您的模式保持一致。但是，在某些情况下，您可能希望允许无效文档，例如包含模式建立之前的文档的数据迁移。

语境

您的架构validationAction选项决定了 MongoDB 如何处理无效文档：

验证操作	行为
`error`	（默认）MongoDB 拒绝任何违反验证标准的插入或更新。
`warn`	MongoDB 允许操作继续进行，但会在 MongoDB 日志中记录违规情况。

选项 1：拒绝无效文件

以下过程显示如何创建拒绝无效文档的架构验证。

使用创建一个集合validationAction: "error"。

使用 JSON 架构验证器创建一个contacts集合，该验证器具有 validationAction: "error"：

db.createCollection( "contacts", {
   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 end with '@mongodb.com'"
         }
      }
   } },
   validationAction: "error"
} )

这error validationAction会导致 MongoDB 拒绝任何无效文档并阻止它们被插入到集合中。

试图插入无效文档。

尝试插入以下文档：

db.contacts.insertOne(
   { name: "Amanda", email: "amanda@xyz.com" }
)

该文档违反了验证规则，因为：

该email字段与正则表达式模式不匹配。该email字段必须以@mongodb.com.
它缺少必填phone字段。

操作失败并出现以下错误：

MongoServerError: Document failed validation
Additional information: {
  failingDocumentId: ObjectId("6377cca4aac957f2b77ea955"),
  details: {
    operatorName: '$jsonSchema',
    schemaRulesNotSatisfied: [
      {
        operatorName: 'properties',
        propertiesNotSatisfied: [
          {
            propertyName: 'email',
            description: "must be a string and end with '@mongodb.com'",
            details: [
              {
                operatorName: 'pattern',
                specifiedAs: { pattern: '@mongodb\\.com$' },
                reason: 'regular expression did not match',
                consideredValue: 'amanda@xyz.com'
              }
            ]
          }
        ]
      },
      {
        operatorName: 'required',
        specifiedAs: { required: [ 'phone' ] },
        missingProperties: [ 'phone' ]
      }
    ]
  }
}

选项 2：允许无效文档，但将它们记录在日志中

以下过程显示如何创建允许无效文档但在 MongoDB 日志中记录无效文档的模式验证。

使用创建一个集合validationAction: "warn"。

使用 JSON 架构验证器创建一个contacts2集合，该验证器具有 validationAction: "warn"：

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 end with '@mongodb.com'"
         }
      }
   } },
   validationAction: "warn"
} )

允许将warn validationAction无效文档插入到集合中。无效文档记录在 MongoDB 日志中。

试图插入无效文档。

尝试插入以下文档：
```
db.contacts2.insertOne(
   { name: "Amanda", email: "amanda@xyz.com" }
)
```
该文档违反了验证规则，因为：
- 该email字段与正则表达式模式不匹配。该email字段必须以@mongodb.com.
- 它缺少必填phone字段。

检查无效文档的日志。

要以可读格式查看 MongoDB 日志，请运行以下命令：

db.adminCommand(
   { getLog:'global'} ).log.forEach(x => { print(x) }
)

MongoDB 日志包含类似于以下对象的条目：

{
   "t": {
      "$date": "2022-11-18T13:30:43.607-05:00"
   },
   "s": "W",
   "c": "STORAGE",
   "id": 20294,
   "ctx": "conn2",
   "msg": "Document would fail validation",
   "attr": {
      "namespace": "test.contacts2",
      "document": {
         "_id": {
            "$oid": "6377cf53d59841355cac1cd0"
         },
         "name": "Amanda",
         "email": "amanda@xyz.com"
      },
      "errInfo": {
         "failingDocumentId": {
            "$oid": "6377cf53d59841355cac1cd0"
         },
         "details": {
            "operatorName": "$jsonSchema",
            "schemaRulesNotSatisfied": [{
               "operatorName": "properties",
               "propertiesNotSatisfied": [{
                  "propertyName": "email",
                  "description": "must be a string and end with '@mongodb.com'",
                  "details": [{
                     "operatorName": "pattern",
                     "specifiedAs": {
                        "pattern": "@mongodb\\.com$"
                     },
                     "reason": "regular expression did not match",
                     "consideredValue": "amanda@xyz.com"
                  }]
               }]
            }, {
               "operatorName": "required",
               "specifiedAs": {
                  "required": ["phone"]
               },
               "missingProperties": ["phone"]
            }]
         }
      }
   }
}

学到更多

参见

原文：Choose How to Handle Invalid Documents

译者：景圣

选择如何处理无效文档

results matching ""

No results matching ""