如何用Python更新Azure CosmosDB中的访问计数文档？

错误根源 #

你调用read_item时，partition_key参数传错了——这个参数需要传入对应item的分区键字段的实际值，而不是分区键的路径（比如/value）。

解决步骤 #

1. 确认容器的分区键
   登录Azure门户，进入Cosmos DB数据资源管理器，找到你的容器，查看其分区键设置（比如可能是/id、/value或者其他字段）。

2. 修正读取与更新代码
   根据你的分区键设置，调整代码：

   • 假设容器分区键是/id（这是最常见的情况，因为你创建的item id是visits）：

     from azure.cosmos import exceptions
     
     # 自增访问计数
     try:
         # partition_key传入item的id值，因为分区键是/id
         item = container.read_item(item='visits', partition_key='visits')
         # 自增value字段
         item['value'] += 1
         # 更新item（upsert会自动处理创建或更新）
         container.upsert_item(body=item)
         print('访问计数已成功自增')
     except exceptions.CosmosResourceNotFoundError:
         # 如果item不存在，初始化一个
         init_item = {
             'id': 'visits',
             'value': 1,
             'description': 'amount of visits'
         }
         container.create_item(body=init_item)
         print('首次访问，已初始化计数')
     

   • 如果容器分区键是/value：
     你创建的item里value是0，所以读取时partition_key要传0：

     try:
         item = container.read_item(item='visits', partition_key=0)
         item['value'] += 1
         container.upsert_item(body=item)
         print('访问计数已成功自增')
     except exceptions.CosmosResourceNotFoundError:
         # 初始化时value设为1
         init_item = {
             'id': 'visits',
             'value': 1,
             'description': 'amount of visits'
         }
         container.create_item(body=init_item)
         print('首次访问，已初始化计数')
     

额外说明 #

• 不要用item += 1，这会直接把整个item对象当成数字运算，正确的做法是修改item['value']字段。
• 使用upsert_item比replace_item更稳妥，它会在item不存在时自动创建，避免额外的错误处理。

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