数据库命令

下文概述的所有命令文档均描述了命令及其可用参数，并提供了每个命令的文档模板或原型。一些命令文档还包括相关的 mongosh 辅助程序。

要针对当前数据库运行命令，请使用 db.runCommand()：

db.runCommand( { <command> } )

要对 admin 数据库运行管理命令，请使用 db.adminCommand()：

db.adminCommand( { <command> } )

注意

有关特定命令（包括事务语法和示例）的详细信息，请单击该命令的参考页面链接。

命令语法

运行数据库命令时，将该命令指定为 db.runCommand() 的文档。文档的键是要运行的命令，值通常为 1。值不影响命令的输出，例如：

db.runCommand( { hello: 1 } )

用户命令

聚合命令

名称	说明	MongoDB Atlas 支持
`aggregate`	使用聚合管道执行聚合任务，例如 `$group`。	对免费和 Flex 集群的支持有限。
`count`	计算集合或视图中的文档数量。	对免费和 Flex 集群的支持有限。
`distinct`	显示在集合或视图中为指定键找到的非重复值。	对免费和 Flex 集群的支持有限。
`mapReduce`	为大型数据集执行 map-reduce 聚合。	不支持免费和 Flex 集群。

查询和写入操作命令

名称	说明	MongoDB Atlas 支持
`bulkWrite`	在一个请求中对多个集合执行多次插入、更新和删除操作。 8.0版本新增。	是
`delete`	删除一个或多个文档。	是
`find`	选择集合或视图中的文档。	对免费和 Flex 集群的支持有限。
`findAndModify`	返回并修改单个文档。	是
`insert`	插入一份或多份文档。	是
`update`	更新一个或多个文档。	是

查询计划缓存命令

名称	说明	MongoDB Atlas 支持
`planCacheClear`	删除集合的缓存查询计划。	不支持免费和 Flex 集群。
`planCacheClearFilters`	清除集合的索引筛选器。	不支持免费和 Flex 集群。
`planCacheListFilters`	列出集合的索引过滤器。	不支持免费和 Flex 集群。
`planCacheSetFilter`	为集合设置索引筛选器。	不支持免费和 Flex 集群。

数据库操作

身份验证命令

名称	说明	MongoDB Atlas 支持
`authenticate`	使用用户名和密码启动经过身份验证的会话。	不支持免费和 Flex 集群。
`logout`	终止当前经过身份验证的会话。	是

用户管理命令

名称	说明	MongoDB Atlas 支持
`createUser`	创建新用户。	不支持Flex 集群、免费和M10 集群。
`dropAllUsersFromDatabase`	删除与数据库关联的所有用户。	不支持免费和 Flex 集群。
`dropUser`	删除单个用户。	不支持 M10 集群。
`grantRolesToUser`	向用户分配角色及其特权。	不支持Flex 集群、免费和M10 集群。
`revokeRolesFromUser`	从用户中删除角色。	不支持Flex 集群、免费和M10 集群。
`updateUser`	更新用户数据。	不支持Flex 集群、免费和M10 集群。
`usersInfo`	返回指定用户的信息。	对免费和 Flex 集群的支持有限。

角色管理命令

名称	说明	MongoDB Atlas 支持
`createRole`	创建角色并指定其特权。	不支持Flex 集群、免费和M10 集群。
`dropRole`	删除用户定义的角色。	不支持Flex 集群、免费和M10 集群。
`dropAllRolesFromDatabase`	删除数据库中所有用户定义的角色。	不支持免费和 Flex 集群。
`grantPrivilegesToRole`	为用户定义的角色分配特权。	不支持免费和 Flex 集群。
`grantRolesToRole`	指定用户定义角色继承相关特权的角色。	不支持免费和 Flex 集群。
`invalidateUserCache`	刷新内存中的用户信息缓存，包括凭证和角色。	不支持免费和 Flex 集群。
`revokePrivilegesFromRole`	从用户定义的角色中删除指定特权。	不支持免费和 Flex 集群。
`revokeRolesFromRole`	从用户定义的角色中删除指定的继承角色。	不支持免费和 Flex 集群。
`rolesInfo`	返回指定角色的信息。	是
`updateRole`	更新用户定义的角色。	不支持Flex 集群、免费和M10 集群。

复制命令

名称	说明	MongoDB Atlas 支持
`appendOplogNote`	向 oplog 写入一个非操作条目。	不支持免费和 Flex 集群。
`applyOps`	将 oplog 条目应用于当前数据集的内部命令。	是
`hello`	显示该节点在副本集中的角色信息，包括是否为主副本。	是
`replSetAbortPrimaryCatchUp`	强制当选的主节点放弃同步（追赶）过程，然后完成到主节点的过渡。	是
`replSetFreeze`	阻止当前节点在一段时间内寻求选举为主节点。	不支持Flex 集群、免费和M10 集群。
`replSetGetConfig`	返回副本集的配置对象。	不支持免费和 Flex 集群。
`replSetGetStatus`	返回报告副本集状态的文档。	不支持免费和 Flex 集群。
`replSetInitiate`	初始化新的副本集。	不支持Flex 集群、免费和M10 集群。
`replSetMaintenance`	启用或禁用维护模式，该模式使从节点处于 `RECOVERING` 状态。	不支持Flex 集群、免费和M10 集群。
`replSetReconfig`	将新配置应用于现有副本集。	不支持Flex 集群、免费和M10 集群。
`replSetResizeOplog`	动态调整副本集节点的 oplog 大小。仅适用于 WiredTiger 存储引擎。	不支持 M10 集群。
`replSetStepDown`	强制当前主节点降级为辅助节点，并触发选举过程。	不支持Flex 集群、免费和M10 集群。
`replSetSyncFrom`	显式覆盖选择成员进行复制的默认逻辑。	不支持Flex 集群、免费和M10 集群。

提示

复制，了解有关复制的更多信息。

分片命令

名称	说明	MongoDB Atlas 支持
`abortReshardCollection`	中止重新分片操作。	是
`abortMoveCollection`	停止正在进行的 `moveCollection` 操作。 8.0版本新增。	不支持 Atlas Free 和 Flex 层级。
`abortUnshardCollection`	停止正在进行的 `unshardCollection` 操作。 8.0版本新增。	不支持 Atlas Free 和 Flex 层级。
`addShard`	将分片添加到分片集群中。	是
`addShardToZone`	将分片与区域关联。支持在分片集群中配置区域。	是
`analyzeShardKey`	计算用于求值分片键的指标。 7.0版本新增。	是
`balancerCollectionStatus`	返回有关分片集合的数据段是否均衡的信息。	是
`balancerStart`	启动负载均衡器线程。	是
`balancerStatus`	返回负载均衡器状态的信息。	是
`balancerStop`	停止负载均衡器线程。	是
`checkMetadataConsistency`	对分片元数据执行一系列一致性检查。 7.0版本新增。	是
`clearJumboFlag`	清除数据段的 `jumbo` 标记。	是
`cleanupOrphaned`	从分片中删除孤立文档，而无需禁用负载均衡器。自版本 8.0 起已弃用。	不支持免费和 Flex 集群。
`cleanupReshardCollection`	清除失败的重新分片操作。	是
`commitReshardCollection`	强制重分区操作以阻止写入并完成。	是
`configureCollectionBalancing`	在分片集合上配置负载均衡器设置。	是
`configureQueryAnalyzer`	为集合配置查询采样。 7.0版本新增。	是
`enableSharding`	创建数据库。	是
`flushRouterConfig`	强制 `mongod`/`mongos` 实例更新缓存的路由元数据。	是
`getShardMap`	报告分片集群状态的内部命令。	不支持免费和 Flex 集群。
`isdbgrid`	验证进程是否为 `mongos`。	是
`listShards`	返回配置的分片列表。	是
`moveChunk`	在分片之间迁移数据段的内部命令。	是
`moveCollection`	将单个未分片集合移动到不同的分分片。	是
`movePrimary`	从分片集群删除分片时，重新分配主分片。	是
`moveRange`	在分片之间移动范围。	是
`mergeAllChunksOnShard`	合并分片为给定集合拥有的所有可合并数据段。	是
`mergeChunks`	提供在单个分片上合并数据段的功能。	是
`refineCollectionShardKey`	通过向现有键添加后缀来优化集合的分片键。	不支持 M10 集群。
`removeShard`	启动从分片集群中删除分片的过程。	不支持 M10 集群。
`removeShardFromZone`	删除分片与区域之间的关联。支持在分片集群中配置区域。	是
`reshardCollection`	启动重新分片操作以更改集合的分片键，从而更改数据的分布。	是
`setAllowMigrations`	防止对集合进行新的自动迁移。	是
`shardCollection`	为集合启用分片功能，支持对集合进行分片。	是
`shardingState`	报告 `mongod` 是否为分片集群的成员。	是
`split`	创建一个新的数据段。	是
`transitionFromDedicatedConfigServer`	配置一个专用配置服务器，使其作为配置分片运行。 8.0版本新增。	不支持 Atlas Free 和 Flex 层级。
`transitionToDedicatedConfigServer`	配置一个配置分片，使其作为专用配置服务器运行。 8.0版本新增。	不支持 Atlas Free 和 Flex 层级。
`unsetSharding`	在 MongoDB 5.0 中删除。影响 MongoDB 部署中实例之间连接的内部命令。	是
`unshardCollection`	取消现有分片集合的分片，并将集合数据移动到单个分片上。当您对集合取消分片时，该集合无法跨多个分片分区，并且分片键将被删除。 8.0版本新增。	是
`updateZoneKeyRange`	添加或删除分片数据范围与区域之间的关联。支持在分片集群中配置区域。	是

提示

分片以了解有关 MongoDB 分片功能的更多信息。

会话命令

命令	说明	Atlas 支持
`abortTransaction`	中止事务。	是
`commitTransaction`	提交 ACID 事务。	是
`endSessions`	在会话超时前使会话过期。	是
`killAllSessions`	终止所有会话。	不支持Flex 集群、免费和M10 集群。
`killAllSessionsByPattern`	终止与指定模式匹配的所有会话	不支持免费和 Flex 集群。
`killSessions`	终止指定会话。	不支持免费和 Flex 集群。
`refreshSessions`	刷新空闲会话。	是
`startSession`	启动新会话。	是

管理命令

名称	说明	MongoDB Atlas 支持
`autoCompact`	启用背景压实。 8.0版本新增。	不支持免费和 Flex 集群。
`cloneCollectionAsCapped`	将非固定大小集合复制为新的固定大小集合。	不支持免费和 Flex 集群。
`collMod`	为集合添加选项或修改视图定义。	是
`compact`	对集合进行碎片整理并重新构建索引。	不支持免费和 Flex 集群。
`compactStructuredEncryptionData`	压缩状态集合中指定的文档并删除冗余文档。	是
`convertToCapped`	将非固定大小集合转换为固定大小集合。	是
`create`	创建集合或视图。	是
`createIndexes`	为集合构建一个或多个索引。	是
`currentOp`	返回一个文档，其中包含有关数据库实例正在进行的操作的信息。	是
`drop`	从数据库中删除指定的集合。	是
`dropDatabase`	删除当前数据库。	是
`dropConnections`	删除指向指定主机列表的传出连接。	是
`dropIndexes`	从集合中删除索引。	是
`filemd5`	已弃用。返回使用 GridFS 存储的文件的 md5 哈希值。	是
`fsync`	将待处理的写入刷新到存储层，并锁定数据库以允许备份。	不支持Flex 集群、免费和M10 集群。
`fsyncUnlock`	解锁一个 fsync 锁。	不支持免费和 Flex 集群。
`getAuditConfig`	在版本 7.1 中已弃用：请改用`auditConfig`集群参数。从 `mongod` 和 `mongos` 实例检索审核配置。	No
`getDefaultRWConcern`	检索部署的全局默认读关注和写关注选项。	是
`getClusterParameter`	从集群中的所有节点检索集群参数值。	是
`getParameter`	Retrieves configuration options.	对免费和 Flex 集群的支持有限。
`killCursors`	终止集合的指定游标。	是
`killOp`	终止操作 ID 所指定的操作。	对免费、M10和Flex 集群的有限支持。
`listCollections`	返回当前数据库中的集合列表。	是
`listDatabases`	返回一份文档，其中列出了所有数据库并返回基本数据库统计信息。	是
`listIndexes`	列出集合的所有索引。	是
`logRotate`	轮换 MongoDB 日志以防止单个文件占用过多空间。	不支持Flex 集群、免费和M10 集群。
`reIndex`	重新构建集合上的所有索引。	不支持免费和 Flex 集群。
`removeQuerySettings`	删除查询结构的查询设置。 8.0版本新增。	是
`renameCollection`	更改现有集合的名称。	是
`rotateCertificates`	执行在线 TLS 证书轮换。	是
`setFeatureCompatibilityVersion`	启用或禁用可将向后兼容的数据持久化的功能。	不支持Flex 集群、免费和M10 集群。
`setIndexCommitQuorum`	更改数据承载成员（即提交法定人数），包括主节点，必须在主节点将这些索引标记为就绪之前投票以提交正在进行的索引构建。	是
`setAuditConfig`	在版本 7.1 中已弃用：请改用`auditConfig`集群参数。在运行时为 `mongod` 和 `mongos` 实例设置审核配置。	No
`setClusterParameter`	修改副本集或分片集群中所有节点的配置选项。 6.0版本新增。	是
`setParameter`	修改配置选项。	不支持Flex 集群、免费和M10 集群。
`setQuerySettings`	为查询结构设置查询设置。 8.0版本新增。	是
`setDefaultRWConcern`	设置部署的全局默认读关注和写关注选项。	是
`setUserWriteBlockMode`	阻止和取消阻止对整个集群的写入。	No
`shutdown`	关闭 `mongod` 或 `mongos` 进程。	不支持Flex 集群、免费和M10 集群。

诊断命令

名称	说明	MongoDB Atlas 支持
`buildInfo`	显示有关 MongoDB 版本的统计信息。	是
`collStats`	报告指定集合的存储利用率统计信息。	是
`connPoolStats`	报告从该 MongoDB 实例到部署中的其他 MongoDB 实例的传出连接的统计信息。	是
`connectionStatus`	报告当前连接的身份验证状态。	是
`dataSize`	返回一定范围数据的数据大小。供内部使用。	不支持免费和 Flex 集群。
`dbHash`	返回数据库及其集合的哈希值。	不支持免费和 Flex 集群。
`dbStats`	报告指定数据库的存储利用率统计信息。	对免费和 Flex 集群的支持有限。
`explain`	返回有关各种操作执行情况的信息。	是
`getCmdLineOpts`	返回一个文档，其中包含 MongoDB 实例的运行时参数及其解析的选项。	是
`getLog`	返回最近的日志消息。	是
`hostInfo`	返回反映底层主机系统的数据。	不支持免费和 Flex 集群。
`listCommands`	列出当前 `mongod` 实例提供的所有数据库命令。	是
`lockInfo`	内部命令，返回当前正在保持或待定的锁信息。仅用于 `mongod` 实例。	不支持免费和 Flex 集群。
`ping`	用于测试部署内连接的内部命令。	是
`profile`	数据库分析器的接口。	是
`serverStatus`	返回实例范围内资源利用率和状态的集合指标。	是
`shardConnPoolStats`	在 MongoDB 5.0 中删除。请改用 `connPoolStats`。	是
`top`	返回 `mongod` 实例中每个数据库的原始使用统计数据。	是
`validate`	用于扫描集合数据和索引的正确性的内部命令。	不支持免费和 Flex 集群。
`validateDBMetadata`	检查数据库或集合的存储元数据在特定 API 版本中是否有效。	是
`whatsmyuri`	内部命令，用于返回当前客户端的信息。	是

审核命令

名称	说明	MongoDB Atlas 支持
`logApplicationMessage`	将自定义消息发布到审核日志。	是

Atlas Search

7.0 版本中的新增功能：（从 6.0.7 开始也可用）

名称	说明
`createSearchIndexes`	在指定的集合上创建一个或多个 Atlas Search 索引。
`dropSearchIndex`	删除现有 Atlas Search 索引。
`updateSearchIndex`	更新现有 Atlas Search 索引。