mongo Shell 方法

搜索文档…
mongo Shell 方法
在本页面
​集合​
​游标​
​数据库​
​查询计划缓存​
​批量写入操作​
​用户管理​
​角色管理​
​复制​
​分片​
​Free监控​
​构造函数​
​连接​
​本机​
​客户端字段级加密​
MONGODB 中的 JAVASCRIPT
虽然这些方法使用 JavaScript，但大多数与 MongoDB 的交互都不使用 JavaScript，而是在交互 application 的语言中使用惯用的司机。
注意
有关特定方法(包括语法和示例)的详细信息，请单击特定方法以转到其 reference 页面。
集合
名称
描述
db.collection.aggregate()
提供对聚合管道的访问。
db.collection.bulkWrite()
提供批量写入操作功能。
db.collection.copyTo()
已过时。包装EVAL以在单个 MongoDB 实例中的集合之间复制数据。
db.collection.count()
包装计数以_return 计算集合或视图中的文档数。
db.collection.createIndex()
在集合上构建索引。
db.collection.createIndexes()
在集合上构建一个或多个索引。
db.collection.dataSize()
返回集合的大小。包装collStats输出中的尺寸字段。
db.collection.deleteOne()
删除集合中的单个文档。
db.collection.deleteMany()
删除集合中的多个文档。
db.collection.distinct()
返回具有指定字段的不同值的文档的 array。
db.collection.drop()
从数据库中删除指定的集合。
db.collection.dropIndex()
删除集合上的指定索引。
db.collection.dropIndexes()
删除集合上的所有索引。
db.collection.ensureIndex()
已过时。使用db.collection.createIndex()。
db.collection.explain()
返回有关各种方法的查询执行的信息。
db.collection.find()
对集合或视图执行查询并返回游标 object。
db.collection.findAndModify()
以原子方式修改并返回单个文档。
db.collection.findOne()
执行查询并返回单个文档。
db.collection.findOneAndDelete()
查找单个文档并将其删除。
db.collection.findOneAndReplace()
查找单个文档并替换它。
游标
名称
描述
cursor.addOption()
添加特殊的线程协议标志，用于修改查询的行为。
cursor.batchSize()
控制 MongoDB 将在单个网络消息中 return 到 client 的文档数。
cursor.close()
关闭游标并释放相关的服务器资源。
cursor.isClosed()
如果光标关闭，则返回true。
cursor.collation()
指定db.collection.find()返回的游标的排序规则。
cursor.comment()
将 comment 附加到查询以允许日志和 system.profile 集合中的可跟踪性。
cursor.count()
修改光标以_return 结果集中的文档数而不是文档本身。
cursor.explain()
报告游标的查询执行计划。
cursor.forEach()
对游标中的每个文档应用 JavaScript function。
cursor.hasNext()
如果游标有文档并且可以迭代，则返回 true。
cursor.hint()
强制 MongoDB 为查询使用特定索引。
cursor.isExhausted()
如果光标关闭且批处理中没有剩余 object，则返回true。
cursor.itcount()
通过获取和迭代结果集来计算游标 client-side 中的文档总数。
cursor.limit()
约束游标结果集的大小。
cursor.map()
对函数中的每个文档应用 function，并在 array 中收集 return 值。
cursor.max()
指定游标的独占上限索引。用于cursor.hint()。
cursor.maxScan()
指定要扫描的最大项目数;收集扫描的文档，索引扫描的键。
cursor.maxTimeMS()
指定用于处理游标操作的累积 time 限制(以毫秒为单位)。
cursor.min()
指定游标的包含性较低索引范围。用于cursor.hint()
cursor.next()
返回游标中的下一个文档。
数据库
名称
描述
db.adminCommand()
对admin数据库运行命令。
db.aggregate()
运行不需要底层集合的 admin/diagnostic 管道。
db.cloneCollection()
在 MongoDB 实例之间直接复制数据。包裹cloneCollection。
db.cloneDatabase()
将数据库从 remote host 复制到当前 host。包裹克隆。
db.commandHelp()
返回数据库命令的帮助信息。
db.copyDatabase()
将数据库复制到当前 host 上的另一个数据库。包裹COPYDB。
db.createCollection()
创建新集合或视图。常用于创建上限集合。
db.createView()
创建一个视图。
db.currentOp()
报告当前的 in-progress 操作。
db.dropDatabase()
删除当前数据库。
db.eval()
已过时。将 JavaScript function 传递给mongod实例 server-side JavaScript evaluation。
db.fsyncLock()
刷新写入磁盘并锁定数据库以防止写入操作并协助备份操作。包裹FSYNC。
db.fsyncUnlock()
允许在使用db.fsyncLock()锁定的数据库上写入 continue。
db.getCollection()
返回集合或视图 object。用于访问名称在mongo shell 中无效的集合。
db.getCollectionInfos()
返回当前数据库中所有集合和视图的集合信息。
db.getCollectionNames()
列出当前数据库中的所有集合和视图。
db.getLastError()
检查并返回上一次操作的状态。包裹GetLastError 函数。
db.getLastErrorObj()
返回上一个操作的状态文档。包裹GetLastError 函数。
db.getLogComponents()
返回 log 消息详细级别。
db.getMongo()
返回当前连接的Mongo()连接 object。
查询计划缓存
名称
描述
db.collection.getPlanCache()
返回一个接口，用于访问集合的查询计划缓存 object 和关联的 PlanCache 方法。
PlanCache.clear()
清除集合的所有缓存查询计划。可通过特定集合的计划缓存 object 访问，即：db.collection.getPlanCache().clear()。
PlanCache.clearPlansByQuery()
清除指定查询形状的缓存查询计划。可通过特定集合的计划缓存 object 访问，即：db.collection.getPlanCache().clearPlansByQuery()
PlanCache.getPlansByQuery()
显示指定查询形状的缓存查询计划。可通过特定集合的计划缓存 object 访问，即：db.collection.getPlanCache().getPlansByQuery()。
PlanCache.help()
显示集合的查询计划缓存可用的方法。可通过特定集合的计划缓存 object 访问，即：db.collection.getPlanCache().help()。
PlanCache.listQueryShapes()
显示存在缓存查询计划的查询形状。可通过特定集合的计划缓存 object 访问，即：db.collection.getPlanCache().listQueryShapes()。
批量写入操作
名称
描述
db.collection.initializeOrderedBulkOp()
为有序的操作列表初始化Bulk()操作构建器。
db.collection.initializeUnorderedBulkOp()
为无序的操作列表初始化Bulk()操作构建器。
Bulk()
批量运营建设者。
Bulk.execute()
批量执行操作列表。
Bulk.find()
指定更新或删除操作的查询条件。
Bulk.find.arrayFilters()
指定用于确定要为update或updateOne操作更新 array 的哪些元素的过滤器。
Bulk.find.collation()
指定查询条件的整理。
Bulk.find.remove()
将多个文档删除操作添加到操作列表中。
Bulk.find.removeOne()
将单个文档删除操作添加到操作列表。
Bulk.find.replaceOne()
将单个文档替换操作添加到操作列表中。
Bulk.find.updateOne()
将单个文档更新操作添加到操作列表。
Bulk.find.update()
将multi更新操作添加到操作列表中。
Bulk.find.upsert()
为更新操作指定upsert: true。
Bulk.getOperations()
返回Bulk() operations object 中执行的写操作的 array。
Bulk.insert()
将 Insert 操作添加到操作列表中。
Bulk.tojson()
返回一个 JSON 文档，其中包含Bulk() operations object 中的操作数和批处理数。
Bulk.toString()
将Bulk.tojson()结果作为 string 返回。
用户管理
名称
描述
db.auth()
将用户验证到数据库。
db.changeUserPassword()
更改现有用户的密码。
db.createUser()
创建一个新用户。
db.dropUser()
删除单个用户。
db.dropAllUsers()
删除与数据库关联的所有用户。
db.getUser()
返回有关指定用户的信息。
db.getUsers()
返回有关与数据库关联的所有用户的信息。
db.grantRolesToUser()
向用户授予角色及其权限。
db.removeUser()
已过时。从数据库中删除用户。
db.revokeRolesFromUser()
从用户中删除角色。
db.updateUser()
更新用户数据。
角色管理
名称
描述
db.createRole()
创建角色并指定其权限。
db.dropRole()
删除 user-defined 角色。
db.dropAllRoles()
删除与数据库关联的所有 user-defined 角色。
db.getRole()
返回指定角色的信息。
db.getRoles()
返回数据库中所有 user-defined 角色的信息。
db.grantPrivilegesToRole()
为 user-defined 角色分配权限。
db.revokePrivilegesFromRole()
从 user-defined 角色中删除指定的权限。
db.grantRolesToRole()
指定 user-defined 角色从中继承权限的角色。
db.revokeRolesFromRole()
从角色中删除继承的角色。
db.updateRole()
更新 user-defined 角色。
复制
名称
描述
rs.add()
将成员添加到副本集。
rs.addArb()
将仲裁者添加到副本集。
rs.conf()
返回副本集 configuration 文档。
rs.freeze()
阻止当前成员在 time 期间寻求选举。
rs.help()
返回副本集函数的基本帮助文本。
rs.initiate()
初始化新的副本集。
rs.printReplicationInfo()
从主数据库的角度打印副本集状态的报告。
rs.printSlaveReplicationInfo()
从辅助节点的角度打印副本集状态的报告。
rs.reconfig()
Re-configures 通过应用新副本集 configuration object 设置副本。
rs.remove()
从副本集中删除成员。
rs.slaveOk()
为当前连接设置slaveOk property。已过时。使用readPref()和Mongo.setReadPref()设置阅读偏好。
rs.status()
返回包含有关副本集的 state 的信息的文档。
rs.stepDown()
导致当前主成为强制选举的辅助。
rs.syncFrom()
设置此副本集成员将同步的成员，覆盖默认同步目标选择逻辑。
分片
名称
描述
sh.addShard()
将碎片添加到分片 cluster。
sh.addShardTag()
在 MongoDB 3.4 中，此方法别名为sh.addShardToZone()。
sh.addShardToZone()
将碎片与 zone 关联。支持在分片群集中配置zones。
sh.addTagRange()
在 MongoDB 3.4 中，此方法别名为sh.updateZoneKeyRange()。
sh.disableBalancing()
禁用分片数据库中单个集合的平衡。不影响分片 cluster 中其他集合的平衡。
sh.enableBalancing()
如果以前使用sh.disableBalancing()禁用，则激活分片收集平衡器 process。
sh.disableAutoSplit()
禁用分片 cluster 的 auto-splitting。
sh.enableAutoSplit()
为分片 cluster 启用 auto-splitting。
sh.enableSharding()
在特定数据库上启用分片。
sh.getBalancerHost()
从 MongoDB 3.4 开始不推荐使用
sh.getBalancerState()
返回 boolean 以报告当前是否启用了平衡器。
sh.removeTagRange()
在 MongoDB 3.4 中，此方法别名为sh.removeRangeFromZone()。
sh.removeRangeFromZone()
删除一系列分片键和 zone 之间的关联。支持在分片群集中配置zones。
sh.help()
返回sh方法的帮助文本。
sh.isBalancerRunning()
返回 boolean 以报告 balancer process 当前是否正在迁移块。
sh.moveChunk()
在分片 cluster中迁移块。
sh.removeShardTag()
在 MongoDB 3.4 中，此方法别名为sh.removeShardFromZone()。
sh.removeShardFromZone()
删除分片和 zone 之间的关联。用于管理zone 分片。
sh.setBalancerState()
启用或禁用在碎片之间迁移块的平衡器。
sh.shardCollection()
为集合启用分片。
Free监控
名称
描述
db.enableFreeMonitoring()
在运行时启用Free监控。
db.disableFreeMonitoring()
在运行时禁用Free监控。
db.getFreeMonitoringStatus()
返回空闲监视状态。
构造函数
名称
描述
BulkWriteResult()
Wrapper 来自Bulk.execute()的结果集。
Date()
创建 date object。默认情况下，创建包含当前 date 的 date object。
ObjectId()
返回ObjectId。
ObjectId.getTimestamp()
返回ObjectId的时间戳部分。
ObjectId.toString()
显示ObjectId的 string 表示。
ObjectId.valueOf()
将 ObjectId 的str属性显示为十六进制 string。
UUID()
将 32-byte 十六进制 string 转换为 UUID BSON 子类型。
WriteResult()
Wrapper 来自 write 方法的结果集。
WriteResult.hasWriteError()
返回一个 boolean，指定结果是否包含WriteResult.writeError。
WriteResult.hasWriteConcernError()
返回一个 boolean，指定结果是否包含WriteResult.writeConcernError。
连接
名称
描述
connect()
连接到 MongoDB 实例和该实例上的指定数据库。
Mongo()
创建一个新连接 object。
Mongo.getDB()
返回数据库 object。
Mongo.getReadPrefMode()
返回 MongoDB 连接的当前读取首选项模式。
Mongo.getReadPrefTagSet()
返回 MongoDB 连接的读取首选项标记集。
Mongo.isCausalConsistency()
指示是否在连接 object 上启用了因果一致性。
Mongo.setCausalConsistency()
启用或禁用连接 object 上的因果一致性。
Mongo.setReadPref()
为 MongoDB 连接设置阅读偏好。
Mongo.setSlaveOk()
允许当前连接上的操作从次要成员读取。
Mongo.startSession()
在连接 object 上启动 session。
session
session object。
SessionOptions
选项 object 为 session。
本机
名称
描述
cat()
返回指定文件的内容。
cd()
将当前工作目录更改为指定的路径。
copyDbpath()
复制本地DBPATH。供内部使用。
fuzzFile()
供内部使用以支持测试。
getHostName()
返回系统的主机名运行mongo shell。
getMemInfo()
返回报告 shell 使用的 memory 数量的文档。
hostname()
返回系统的主机名运行 shell。
listFiles()
返回给出目录中每个 object 的 name 和大小的文档的 array。
load()
在 shell 中加载并运行 JavaScript 文件。
ls()
返回当前目录中 files 的列表。
md5sumFile()
指定文件的MD5哈希值。
mkdir()
在指定的路径创建目录。
pwd()
返回当前目录。
quit()
退出当前的 shell session。
removeFile()
从本地文件系统中删除指定的文件。
resetDbpath()
删除本地DBPATH。供内部使用。
sleep()
在给定的 time 期间暂停mongo shell。
setVerboseShell()
配置mongo shell 以报告操作时间。
version()
返回mongo shell 实例的当前 version。
_isWindows()
如果 shell 在 Windows 系统上运行，则返回true; false如果是 Unix 或 Linux 系统。
客户端字段级加密
注意
​mongo客户端的字段级的加密方法需要与客户端的字段级加密的数据库连接启用。如果当前数据库连接不是在启用客户端字段级加密的情况下启动的，则可以：
使用shell程序中的Mongo()构造函数mongo与所需的客户端字段级加密选项建立连接。该Mongo()方法同时支持Amazon Web Services和本地密钥管理服务（KMS）提供程序以进行客户主密钥（CMK）管理。
要么
使用mongoshell 命令行选项与所需选项建立连接。命令行选项仅支持AWS KMS提供程序进行CMK管理。
名称
描述
​getKeyVault()​
返回当前MongoDB连接的密钥保险库对象。
​KeyVault.createKey()​
创建用于客户端字段级加密的数据加密密钥。
​KeyVault.deleteKey()​
从密钥库中删除指定的数据加密密钥。
​KeyVault.getKey()​
从密钥库中检索指定的数据加密密钥。
​KeyVault.getKeys()​
检索密钥库中的所有密钥。
​KeyVault.addKeyAlternateName()​
将密钥替代名称与指定的数据加密密钥相关联。
​KeyVault.removeKeyAlternateName()​
从指定的数据加密密钥中删除密钥替代名称。
​KeyVault.getKeyByAltName()​
检索具有指定键替代名称的键。
​getClientEncryption()​
返回用于支持字段的显式加密/解密的客户端加密对象。
​ClientEncryption.encrypt()​
使用指定的数据加密密钥和加密算法对字段进行加密。
​ClientEncryption.decrypt()​
使用关联的数据加密密钥和加密算法解密字段。