原子计数器是将列当成一个原子计数器来使用,为某些在线应用提供实时统计功能,例如统计帖子的PV(实时浏览量)等。

说明 原子计数器的详细介绍参见原子计数器

接口说明

updateRow接口新增了原子计数器的相关参数:
  • updateOfAttributeColumns中添加INCREMENT相关逻辑,执行增量变更(如:+X, -X等)。
  • returnContent中的returnColumns可以指定对哪一列进行原子计数器操作,returnType设置返回类型(TableStore.ReturnType.AfterModify表示返回指定列的新值)。

示例

写入数据时,使用updateRow接口对整型列做列值的增量变更,示例代码如下。
var params = {
  tableName: "<Your-Table-Name>",
  condition: new TableStore.Condition(TableStore.RowExistenceExpectation.EXPECT_EXIST, null),
  primaryKey: [{'pk0': Long.fromNumber(1)}],
  // 对price属性列进行原子计数器操作
  updateOfAttributeColumns: [
    {'INCREMENT': [{'price': Long.fromNumber(10)}]}
  ],
  // 返回price列的新值
  returnContent: {
    returnColumns: ["price"],
    returnType: TableStore.ReturnType.AfterModify
  }
};

client.updateRow(params,
  function (err, data) {
    if (err) {
      console.log('error:', err);
      return;
    }

    console.log('success:', JSON.stringify(data, null, 2));
  });