Python操作CosmosDB如何删除现有项的指定属性

使用Python CosmosClient操作Cosmos DB集合时，需要删除指定项的部分属性，因待操作项属性量级大，希望避免全量更新项。最初编写的代码仅将目标属性赋值为空字符串，未实现属性的真正删除，同时因目标项分区键为POLICY，无法直接通过Azure门户完成删除操作。

原测试代码如下：

for i, item in enumerate(container.query_items(
        query='SELECT * FROM col c WHERE c._partitionKey="POLICY"',
        enable_cross_partition_query=True)):
    if (item["id"] == "$DEFAULT"):
        item['p1']=''
        item['p2']=''
        response = container.upsert_item(item)

upsert_item的逻辑是全量覆盖写入项，仅将p1、p2赋值为空字符串时，提交的文档中依然保留这两个属性，自然不会触发属性删除，只是把属性值修改为了空串。

方案1：全量覆盖删除（适合项体积较小的场景） #

直接从查询得到的项字典中删除目标属性的键值对，再调用upsert_item做全量覆盖即可，提交的文档中不存在的属性，覆盖后会从原项中移除。
代码示例：

for item in container.query_items(
        query='SELECT * FROM col c WHERE c._partitionKey="POLICY"',
        enable_cross_partition_query=True):
    if item["id"] == "$DEFAULT":
        # 直接删除字典中的目标键，不要赋值空字符串
        del item["p1"]
        del item["p2"]
        response = container.upsert_item(item)

方案2：Patch部分更新（适合大体积项，无需全量替换，最优方案） #

如果项包含大量属性，不想拉取、提交全量项，可以使用Cosmos DB提供的Patch部分更新API，不需要提前查询全量文档，仅需指定要执行的删除操作即可，RU消耗远低于全量替换。
删除属性使用remove类型的补丁操作，传入目标项id、分区键值即可直接操作，完全绕开门户无法操作的限制。
代码示例：

from azure.cosmos import PatchOperation

# 定义要执行的删除操作，路径为属性名前加斜杠
patch_ops = [
    PatchOperation.remove("/p1"),
    PatchOperation.remove("/p2")
]

# 直接对目标项执行补丁更新，无需提前查询全量项
response = container.patch_item(
    item="$DEFAULT",
    partition_key="POLICY",
    patch_operations=patch_ops
)

注意：如果要删除嵌套属性，只需要在路径中写完整层级即可，比如要删除info节点下的p1属性，路径写为/info/p1。

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