collMod

TTL集合¶

index¶

该index选项更改TTL收集的到期时间 。

用以下格式的文档指定键或索引名称，以及新的到期时间：

复制

{keyPattern: <index_spec> || name: <index_name>, expireAfterSeconds: <seconds> }

在此示例中，<index_spec>是集合中的现有索引。如果多个索引具有相同的键模式，则要求用户按名称指定索引。seconds是从当前时间减去的秒数。

成功后，collMod将返回包含字段的文档， expireAfterSeconds_old并将其expireAfterSeconds_new设置为各自的值。

失败时，collMod返回文档，如果不存在现有 字段或指定的字段 不存在。no expireAfterSeconds field to updateexpireAfterSecondscannot find index { **key**: 1.0 } for ns **namespace**keyPattern

文档验证¶

validator¶

3.2版中的新功能。

validator允许用户为集合指定验证规则或表达式。有关更多信息，请参见模式验证。

该validator选项采用指定验证规则或表达式的文档。您可以使用相同的运营商为指定表达式查询操作符：使用外$geoNear， $near，$nearSphere，$text，和 $where。

注意

• 验证在更新和插入期间进行。现有文档在进行修改之前不会进行验证检查。
• 你不能指定的集合验证程序admin， local和config数据库。
• 您不能为system.*集合指定验证器。

validationLevel¶

3.2版中的新功能。

该validationLevel决定的MongoDB如何严格意义上的更新过程中应用验证规则到现有的文件。

validationLevel	描述
"off"	不验证插入或更新。
"strict"	默认将验证规则应用于所有插入和所有更新。
"moderate"	将验证规则应用于现有有效 文档的插入和更新。不要将规则应用于现有无效 文档的更新。

validationAction¶

3.2版中的新功能。

该validationAction选项确定是error对无效文档还是仅对warn违规，但允许无效文档。

重要

文件的验证仅适用于由validationLevel。

validationAction	描述
"error"	默认文档必须在写入之前通过验证。否则，写入操作将失败。
"warn"	文档不必通过验证。如果文档验证失败，则写操作将记录验证失败。

要查看集合的验证规范，请使用 db.getCollectionInfos()方法。

视图¶

viewOn¶

该视图的基础源集合或视图。视图定义是通过将指定的内容pipeline应用于此源来确定的。

如果在运行带有访问控制的MongoDB部署上修改视图，则为必需。

pipeline¶

定义视图的聚合管道。

注意

视图定义pipeline不能包含$out或$merge阶段。如果视图定义包括嵌套管道（例如，视图定义包括 $lookup或$facet阶段），则此限制也适用于嵌套管道。

如果在运行带有访问控制的MongoDB部署上修改视图，则为必需。

视图定义是公共的；即db.getCollectionInfos() ，explain对视图的操作将包括定义视图的管道。因此，请避免在视图定义中直接引用敏感字段和值。

db.runCommand( {
   collMod: "myView", viewOn: "activities", pipeline: [ { $match: { status: "Q" } }, { $project: { user: 1, date: 1, description: 1} } ]
} )

写关注¶

可选的。表示命令写关注点的文档drop。

省略使用默认的写关注。

资源锁定¶

collMod在操作期间，该命令在指定集合的​​父数据库上获得排他锁。数据库上的所有后续操作及其所有集合必须等待，直到collMod释放锁为止。

对于指数变化到期值¶

要将sessions在lastAccess字段上索引的集合的过期值从30分钟更新为60分钟，请使用以下操作：

db.runCommand( { collMod: "sessions",
                 index: { keyPattern: { lastAccess: 1 },
                          expireAfterSeconds: 3600
                        }
})

哪个将返回文档：

{ "expireAfterSeconds_old" : 1800, "expireAfterSeconds_new" : 3600, "ok" : 1 }

将文档验证添加到现有集合中¶

以下示例将验证器添加到名为的现有集合中 contacts。

db.runCommand( { collMod: "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 match the regular expression pattern"
         },
         status: {
            enum: [ "Unknown", "Incomplete" ],
            description: "can only be one of the enum values"
         }
      }
   } },
   validationLevel: "moderate",
   validationAction: "warn"
} )

使用moderate validationLevel，MongoDB将验证规则应用于插入操作，并将操作更新到已经满足验证条件的现有文档。不检查不满足验证条件的现有文档的更新的有效性。

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

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

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

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

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

有关更多信息，请参见模式验证。