mongodb c# API V2 : Difference between ReplaceOne and FindOneAndReplace

Question

查看 mongodb 文档，我读到 FindOneAndReplace 将是一个原子操作。但我不明白的是为什么 ReplaceOne 不会是原子的？如果存在差异，为什么还要使用 ReplaceOne？

Answer 1

文档揭示了一个不同的方法签名:

ReplaceOne :

ReplaceOneResult ReplaceOne(
    FilterDefinition<TDocument> filter,
    TDocument replacement,
    ReplaceOptions options = null,
    CancellationToken cancellationToken = null
)

FindOneAndReplace :

TProjection FindOneAndReplace<TProjection>(
    FilterDefinition<TDocument> filter,
    TDocument replacement,
    FindOneAndReplaceOptions<TDocument, TProjection> options = null,
    CancellationToken cancellationToken = null
)

最值得注意的是返回类型和选项参数不同。

虽然 ReplaceOne 返回 ReplaceOneResult , FindOneAndReplace 返回文档(注意选项中的 ReturnDocument 属性)。

ReplaceOptions与 FindOneAndReplaceOptions 相比相当有限，例如前者不提供 sort 属性来让您控制哪个文档将成为集合中第一个匹配文档。如果您根据 ID 进行过滤，这无关紧要，但如果您想要替换最新文档，则排序选项非常有用。

(旁注:我个人认为此处的文档 https://docs.mongodb.com/manual/reference/method/db.collection.replaceOne/ 和此处的 https://docs.mongodb.com/manual/reference/method/db.collection.findOneAndReplace/ 更有帮助，因为它们更详细地解释了用法并提供了一些示例。但我不知道它与MongoDB C# 驱动程序。)