Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs 菜单
Docs 主页
/ /

compact(数据库命令)

compact

对集合中的所有数据和索引进行重写和碎片整理。在 WiredTiger 数据库中,该命令会将不需要的磁盘空间释放给操作系统。

此命令可用于以下环境中托管的部署:

  • MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务

重要

M0 和 Flex 集群不支持此命令。有关更多信息,请参阅不支持的命令。

该命令具有以下语法:

db.runCommand(
{
compact: <collection name>
}
)

该命令接受以下字段:

字段
类型
说明

compact

字符串

集合的名称。

force

flag

可选。 如指定,则强制compact副本集主节点上运行。compact 不会阻止正在压缩的数据库上的MongoDB CRUD 操作

comment

any

可选。用户提供的待附加到该命令的注释。设置后,该注释将与该命令的记录一起出现在以下位置:

注释可以是任何有效的 BSON 类型(字符串、整型、对象、数组等)。

对于强制进行身份验证的集群,您必须使用对目标集合执行 compact 特权操作的用户身份进行身份验证。dbAdmin 角色提供针对非系统集合运行 compact 所需的特权。

对于系统集合,您必须:

  1. 创建一个自定义角色,该角色授予对系统集合的 compact 操作。

  2. 将该角色授予新用户或现有用户。

  3. 作为该用户进行身份验证,以执行 compact 命令。

例如,以下操作创建一个自定义角色,该角色授予针对指定数据库和集合的 compact 操作:

use admin
db.createRole(
{
role: "myCustomCompactRole",
privileges: [
{
resource: { "db" : "<database>" , "collection" : "<collection>" },
actions: [ "compact" ]
}
],
roles: []
}
)

有关如何配置 resource 文档的详细信息,请参阅有关自管理部署的资源文档。

要将 dbAdmin 或自定义角色添加到现有用户,请使用 db.grantRolesToUser()db.updateUser()。以下操作在 admin 数据库上将自定义 compact 角色授予 myCompactUser

use admin
db.grantRolesToUser("myCompactUser", [ "dbAdmin" | "myCustomCompactRole" ] )

要向新用户添加 dbAdmin 或自定义角色,请在创建用户时对 db.createUser() 方法的 roles 数组指定该角色。

use admin
db.createUser(
{
user: "myCompactUser",
pwd: "myCompactUserPassword",
roles: [
{ role: "dbAdmin", db: "<database>" } | "myCustomCompactRole"
]
}
)

要检查 compact 操作的进度,请监控 mongod 日志文件或从另一个 shell 实例运行 db.currentOp()

如果在 compact 完成之前重新启动服务器,该操作则会终止,并且在将磁盘空间发布回操作系统的尝试中可能会失败。

compact 命令尝试通过将过时的块释放回操作系统来减少集合中的数据和索引消耗的磁盘空间。 compact 的有效性与可供释放的区块数量以及这些区块在数据文件中的位置有关。

要查看集合的存储空间如何变化,请在压实之前和之后运行collStats 命令。您可以使用输出指标collStats.freeStorageSize 来查看可供重复使用的存储量。

该操作是迭代式的,并在每次遍历中对数据文件的分段进行操作。对集合调用 compact 会压缩该集合及其关联的索引。

compact 可能需要额外的磁盘空间才能运行。

您可以在存储在副本集中的集合和索引上使用 compact,但有一些重要的注意事项:

  • 主节点不会将 compact 命令复制到从节点。

  • 尽可能在从节点上运行 compact。如果无法在从节点上运行 compact,请参阅 force 选项。

  • 从 MongoDB 6.1.0开始 (和6.0.2 ):

    • 从节点可以在 compact 运行时进行复制。

    • 允许读取。

在集群上运行 compact

1

在其中一个从节点上运行 compact。当 compact 完成后,依次对剩余的每个从节点重复该操作。

2

要降级当前主节点并触发选举,请使用 rs.stepDown() 方法。要指定特定的从节点,请调整节点优先级

3

降级后,旧的主节点将成为从节点。在旧的主节点上运行 compact

  • 从节点可以在 compact 运行时进行复制。

  • 允许读取。

运行 compact 命令时,副本集将保持 SECONDARY 状态。

有关副本集成员状态的更多信息,请参阅副本集成员状态

有关副本集维护和可用性,请参阅对自管理副本集节点进行维护。

compact 只适用于mongod实例。在分片环境中,在每个分片上分别运行 compact 作为维护操作。

您无法针对 mongos 实例发出 compact

mongod 在执行 compact 操作后并行重建所有索引。

以下操作将对 movies 集合运行 compact 命令:

db.runCommand( { compact: "movies" } )

运行 compact 会返回类似于以下内容的输出:

{ bytesFreed: 27859, ok: 1 }

后退

collMod

在此页面上