Cosmos DB部分文档更新时increment操作报错，如何实现增量更新？

按照Azure Cosmos DB官方文档说明，可用increment操作实现文档字段的增量更新，但运行以下代码时触发错误：

const operations =
          [
              { op: 'increment', path: '/public/inventory/irradish', value:  irradish},
              { op: 'increment', path: '/public/inventory/sunmelon', value:  sunmelon},
              { op: 'set', path: '/map/garden/lastUse', value:  time}
          ];
          const { resource: updated } = await container
          .item(
              id = email, 
              partitionKeyValue = email
          )

错误信息：

Error: Message: {"Errors":["Invalid value of the patch operation 'op' property in patch request: 'increment'"]} ActivityId: f1bb8b88-ab68-4f2b-b244-8b021b0d9021,...

正确实现增量更新的方法 #

1. 补全核心方法调用 #

原代码缺少关键的.patch()方法调用，这是执行补丁操作的必要步骤，完整代码如下：

const operations = [
    { op: 'increment', path: '/public/inventory/irradish', value: irradish },
    { op: 'increment', path: '/public/inventory/sunmelon', value: sunmelon },
    { op: 'set', path: '/map/garden/lastUse', value: time }
];

// 补全patch方法调用
const { resource: updated } = await container
    .item(email, email)
    .patch(operations);

2. 检查SDK版本兼容性 #

increment是Azure Cosmos DB较新的补丁操作，要求：

• JavaScript SDK版本3.17.0及以上
• 对应API版本设置为2021-05-15或更高

如果使用的是旧版SDK，要么升级SDK，要么改用add操作替代increment（两者功能完全一致，都是对数值字段做增量累加）：

// 旧版SDK用add替代increment
const operations = [
    { op: 'add', path: '/public/inventory/irradish', value: irradish },
    { op: 'add', path: '/public/inventory/sunmelon', value: sunmelon },
    { op: 'set', path: '/map/garden/lastUse', value: time }
];

3. 额外注意事项 #

• 确保irradish和sunmelon是数值类型（number），不能传入字符串
• 如果目标字段可能不存在，可在patch方法中添加upsert: true参数自动创建字段：

  await container.item(email, email).patch(operations, { upsert: true });
  

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