UpsertItemAsync 在 .NET Cosmos DB 客户端中做什么？

Question

这个问题涉及到Microsoft.Azure.Cosmos v3.11.0。

该文件中UpsertItemAsync没有为“更新插入”操作指定确切的语义。特别是，它是插入 + 替换，还是插入 +（部分）更新？（我怀疑是前者，因为截至今天这个问题仍然存在。）

Answer 1

CreateItemAsync 将创建一个新项目，但如果已经有一个具有相同 ID 的项目，则会失败。

ReplaceItemAsync 将替换具有相同 ID 的现有项目，但如果该项目不存在，则会失败。

UpsertItemAsync结合上述两个操作，因此它将创建或替换具有指定 ID 的任何项目。所以它不是“插入+替换”。相反，它是一个“插入或替换”。

据我所知，Cosmos 不支持“部分更新”。