数据库命令

在此页面上

命令语法

用户命令
数据库操作
审核命令
Atlas Search 命令

下面概述的所有命令文档都描述了命令及其可用参数，并为每个命令提供了文档模板或原型。某些命令文档还包括相关的 mongosh助手。

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

db.runCommand( { <command> } )

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

db.adminCommand( { <command> } )

注意

有关特定命令的详细信息（包括语法和示例），请点击特定命令前往其参考页面。

命令语法

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

db.runCommand( { hello: 1 } )

用户命令

聚合命令

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

地理空间命令

名称	说明	MongoDB Atlas 支持
`geoSearch`	已在 MongoDB 5.0 中删除。执行使用 MongoDB 的干草堆索引功能的地理空间查询。	不支持无服务器实例。

查询和写入操作命令

名称	说明	MongoDB Atlas 支持
`delete`	删除一个或多个文档。	是
`find`	选择集合或视图中的文档。	对M 0 、 M 2和 M 5集群的有限支持。
`findAndModify`	返回并修改单个文档。	是
`getMore`	返回游标当前指向的批量文档。	是
`insert`	插入一份或多份文档。	是
`resetError`	在 MongoDB 5.0 中删除。重置上次错误状态。	否
`update`	更新一个或多个文档。	是

查询计划缓存命令

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

数据库操作

身份验证命令

名称	说明	MongoDB Atlas 支持
`authenticate`	使用用户名和密码启动经过身份验证的会话。	不支持M 0 、 M 2和 M 5集群。
`getnonce`	这是一条内部命令，用于生成用于身份验证的一次性密码。	是
`logout`	终止当前经过身份验证的会话。	是

用户管理命令

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

角色管理命令

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

复制命令

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

提示

另请参阅：

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

分片命令

名称	说明	MongoDB Atlas 支持
`abortReshardCollection`	中止重新分片操作。版本 5.0 中的新增功能。	是
`addShard`	将分片添加到分片集群中。	不支持无服务器实例。
`addShardToZone`	将分片与区域关联。支持在分片集群中配置区域。	不支持无服务器实例。
`balancerCollectionStatus`	返回有关分片集合的数据段是否均衡的信息。	不支持无服务器实例。
`balancerStart`	启动负载均衡器线程。	不支持无服务器实例。
`balancerStatus`	返回负载均衡器状态的信息。	不支持无服务器实例。
`balancerStop`	停止负载均衡器线程。	不支持无服务器实例。
`checkShardingIndex`	验证分片键索引的内部命令。	不支持M 0 、 M 2和 M 5集群。
`clearJumboFlag`	清除数据段的 `jumbo` 标记。	不支持无服务器实例。
`cleanupOrphaned`	删除分片键值超出分片拥有的数据段范围的孤立数据。	不支持M 0 、 M 2和 M 5集群。
`cleanupReshardCollection`	清除失败的重新分片操作。版本 5.0 中的新增功能。	是
`commitReshardCollection`	强制重分区操作以阻止写入并完成。版本 5.0 中的新增功能。	是
`configureCollectionBalancing`	在分片集合上配置负载均衡器设置。 5.3 版本中的新增功能。	是
`enableSharding`	创建数据库。	不支持无服务器实例。
`flushRouterConfig`	强制 `mongod`/`mongos` 实例更新缓存的路由元数据。	不支持无服务器实例。
`getShardMap`	报告分片集群状态的内部命令。	不支持M 0 、 M 2和 M 5集群和无服务器实例。
`getShardVersion`	返回配置服务器版本的内部命令。	不支持M 0 、 M 2和 M 5集群和无服务器实例。
`isdbgrid`	验证进程是否为 `mongos`。	是
`listShards`	返回配置的分片列表。	不支持无服务器实例。
`moveChunk`	在分片之间迁移数据段的内部命令。	不支持无服务器实例。
`movePrimary`	从分片集群删除分片时，重新分配主分片。	不支持无服务器实例。
`moveRange`	在分片之间移动范围。	是
`mergeChunks`	提供在单个分片上合并数据段的功能。	不支持无服务器实例。
`refineCollectionShardKey`	通过向现有键添加后缀来优化集合的分片键。	不支持M 10集群和无服务器实例。
`removeShard`	启动从分片集群中删除分片的过程。	不支持M 10集群和无服务器实例。
`removeShardFromZone`	删除分片与区域之间的关联。支持在分片集群中配置区域。	不支持无服务器实例。
`reshardCollection`	启动重新分片操作以更改集合的分片键，从而更改数据的分布。版本 5.0 中的新增功能。	是
`setShardVersion`	设置配置服务器版本的内部命令。	是
`shardCollection`	为集合启用分片功能，支持对集合进行分片。	不支持无服务器实例。
`shardingState`	报告 `mongod` 是否为分片集群的成员。	是
`split`	创建一个新的数据段。	不支持无服务器实例。
`splitVector`	确定分割点的内部命令。	是
`unsetSharding`	在 MongoDB 5.0 中删除。影响 MongoDB 部署中实例之间连接的内部命令。	是
`updateZoneKeyRange`	添加或删除分片数据范围与区域之间的关联。支持在分片集群中配置区域。	不支持无服务器实例。

提示

另请参阅：

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

会话命令

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

管理命令

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

诊断命令

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

审核命令

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

Atlas Search 命令

版本 6.0.7 中的新增内容。

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

← 连接字符串(Connection Strings)

聚合命令 →

数据库命令.css-134mg1q{-webkit-align-self:center;-ms-flex-item-align:center;align-self:center;padding:0 10px;visibility:hidden;}.css-6vrlzm{border-radius:0!important;display:initial!important;margin:initial!important;}.css-1l4s55v{margin-top:-175px;position:absolute;padding-bottom:2px;}

注意

命令语法

用户命令

聚合命令

地理空间命令

查询和写入操作命令

查询计划缓存命令

数据库操作

身份验证命令

用户管理命令

角色管理命令

复制命令

提示

另请参阅：

分片命令

提示

另请参阅：

会话命令

管理命令

诊断命令

审核命令

Atlas Search 命令

数据库命令