convertToCapped_MonogDB 中文网

在本页面

convertToCapped¶

该convertToCapped命令将现有的无上限集合转换为同一数据库内的有上限集合。

该命令具有以下语法：

{ convertToCapped: <collection>, size: <capped size> , writeConcern: <document>}

该命令包含以下字段：

领域	描述
convertToCapped	要转换的现有集合的名称。
尺寸	上限集合的最大大小（以字节为单位）。
writeConcern	可选的。表示命令写关注点的文档`drop`。省略使用默认的写关注。

convertToCapped接收一个现有的集合（<collection>），并将其转换为最大大小（以字节为单位）的上限集合size（由参数（）指定）。<capped size>

在转换过程中，该convertToCapped 命令表现出以下行为：

MongoDB以自然顺序遍历原始集合中的文档，并将这些文档加载到新的加盖集合中。
如果为上限集合指定的大小小于原始未上限集合的大小，则MongoDB将根据插入顺序或先进先出顺序覆盖上限集合中的文档。capped size
在内部，为了转换集合，MongoDB使用以下过程
- cloneCollectionAsCapped 命令创建上限集合并导入数据。
- MongoDB删除原始集合。
- renameCollection 将新的加盖集合重命名为原始集合的名称。
在操作期间，它将持有数据库排他锁。锁定同一数据库的其他操作将被阻止，直到该操作完成。请参阅一些常见的客户端操作采取了哪些锁？用于锁定数据库的操作。

注意

MongoDB convertToCapped 在分片群集中不支持该命令。

警告

该convertToCapped不会重新创建新的集合从原来的集合索引，比在该指数的其他_id领域。如果需要此集合上的索引，则转换完成后，需要创建这些索引。

例子¶

以下示例使用一个db.collection.save()操作来创建一个events集合，并db.collection.stats()获取有关该集合的信息：

db.events.save( { click: 'button-1', time: new Date() } )
db.events.stats()

MongoDB将返回以下内容：

{
        "ns" : "test.events",
        ...
        "capped" : false,
        ...
}

要将events集合转换为带上限的集合并查看更新的集合信息，请运行以下命令：

db.runCommand( { convertToCapped: 'events', size: 8192 } )
db.events.stats()

MongoDB将返回以下内容：

{
     "ns" : "test.events",
     ...
     "capped" : true,
     "max" : NumberLong("9223372036854775807"),
     "maxSize" : 8192,
     ...
}

该convertToCapped不会重新创建新的集合从原来的集合索引，比在该指数的其他_id领域。如果需要此集合上的索引，则转换完成后，需要创建这些索引。

也可以看看