Java调用MongoDB的deleteMany()传入空查询时会产生什么结果？

结论 #

调用collection.deleteMany()时传入空查询，会清空当前集合内的所有文档，不会删除集合本身，不会删除数据库，也不会执行失败。

具体规则说明 #

• MongoDB官方设计中，deleteMany(filter)的作用是删除所有匹配filter条件的文档，空查询（即{}）会匹配集合内的全部文档，因此所有文档都会被删除。
• Java MongoDB驱动中，以下写法均属于传入空查询的场景，执行效果完全一致：
  • 传入Filters.empty()作为查询条件
  • 传入空的BsonDocument实例
  • 部分旧版本驱动支持的无参deleteMany()调用
• 注意和其他删除操作做区分：
  • deleteMany({})仅删除集合内的文档，集合本身、集合的索引配置、元数据都会完整保留
  • 只有调用collection.drop()才会删除整个集合（含索引、元数据）
  • 只有调用mongoDatabase.drop()才会删除整个数据库，deleteMany()操作不会触发库级别删除

代码示例 #

import com.mongodb.client.MongoCollection;
import com.mongodb.client.model.Filters;
import org.bson.Document;
import org.bson.BsonDocument;

// 获取集合实例
MongoCollection<Document> myCollection = mongoDatabase.getCollection("test_collection");

// 以下三种写法均会清空集合内所有文档
myCollection.deleteMany(Filters.empty());
myCollection.deleteMany(new BsonDocument());
// 旧版本驱动支持的无参调用
// myCollection.deleteMany();

生产环境注意事项 #

如果担心误操作清空数据，可以在执行删除前先调用countDocuments()校验匹配的文档数量，确认符合预期后再执行删除操作。

内容的提问来源于stack exchange，提问作者Jonathan Andrew