赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 表格存储
  4. 开发参考
  5. SDK参考
  6. Node.js SDK
  7. 表操作
  8. 条件更新

条件更新

  • 表操作
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

只有当数据满足列判断条件时,才能对数据表中的数据进行更新;当数据不满足列判断条件时,数据更新失败。

前提条件

  • 已初始化Client,具体操作,请参见初始化Client。

  • 已创建数据表并写入数据。具体操作,请参见创建数据表和写入数据。

使用方法

在通过PutRow、UpdateRow、DeleteRow或BatchWriteRow接口更新数据时,可以使用条件更新检查行存在性条件和列条件,只有满足条件时才能成功更新。

条件更新包括行存在性条件和列条件。

  • 行存在性条件:包括IGNORE、EXPECT_EXIST和EXPECT_NOT_EXIST,分别代表忽略、期望存在和期望不存在。

    对数据表进行更改操作时,系统会先检查行存在性条件,如果不满足行存在性条件,则更改失败并给用户报错。

  • 列条件:包括SingleColumnCondition和CompositeCondition,是基于某一列或者某些列的列值进行条件判断。

    列条件中支持使用关系运算(=、!=、>、>=、<、<=)和逻辑运算(NOT、AND、OR),单个更新条件中最多支持设置10个列条件。

    • SingleColumnCondition支持一列(可以是主键列)和一个常量比较。不支持两列或者两个常量相比较。

    • CompositeCondition的内节点为逻辑运算,子条件可以是SingleColumnCondition或CompositeCondition。

条件更新可以实现乐观锁功能,即在更新某行时,先获取某列的值,假设为列A,值为1,然后设置条件列A=1,更新行使列A=2。如果更新失败,表示有其他客户端已成功更新该行。

参数

参数

说明

RowExistenceExpectation

对数据表进行更改操作时,系统会先检查行存在性条件,如果不满足行存在性条件,则更改失败并给用户报错。

行存在性条件包括IGNORE、EXPECT_EXIST和EXPECT_NOT_EXIST,分别用RowExistenceExpectation_IGNORE、RowExistenceExpectation_EXPECT_EXIST、RowExistenceExpectation_EXPECT_NOT_EXIST表示。

  • IGNORE:表示忽略,不做任何存在性检查。

  • EXPECT_EXIST:表示期望存在,如果该行存在,则满足条件;如果该行不存在,则不满足条件。

  • EXPECT_NOT_EXIST:期望行不存在,如果该行不存在,则满足条件;如果该行存在,则不满足条件。

columnName

列的名称。

columnValue

列的对比值。

comparator

对列值进行比较的关系运算符,类型详情请参见ComparatorType。

关系运算符包括EQUAL(=)、NOT_EQUAL(!=)、GREATER_THAN(>)、GREATER_EQUAL(>=)、LESS_THAN(<)和LESS_EQUAL(<=),分别用CT_EQUAL、CT_NOT_EQUAL、CT_GREATER_THAN、CT_GREATER_EQUAL、CT_LESS_THAN、CT_LESS_EQUAL表示。

combinator

对多个条件进行组合的逻辑运算符,类型详情请参见LogicalOperator。

逻辑运算符包括NOT、AND和OR,分别用LO_NOT、LO_AND、LO_OR表示。

逻辑运算符不同可以添加的子条件个数不同。

  • 当逻辑运算符为NOT时,只能添加一个子条件。

  • 当逻辑运算符为AND或OR时,必须至少添加两个子条件。

passIfMissing

当列在某行中不存在时,条件检查是否通过。类型为bool值,默认值为true,表示如果列在某行中不存在时,则条件检查通过,该行满足更新条件。

当设置passIfMissing为false时,如果列在某行中不存在时,则条件检查不通过,该行不满足更新条件。

latestVersionOnly

当列存在多个版本的数据时,是否只使用最新版本的值做比较。类型为bool值,默认值为true,表示如果列存在多个版本的数据时,则只使用该列最新版本的值进行比较。

当设置latestVersionOnly为false时,如果列存在多个版本的数据时,则会使用该列的所有版本的值进行比较,此时只要有一个版本的值满足条件,就条件检查通过,该行满足更新条件。

示例

根据指定主键更新一行,只有同时满足行存在,“name”列值为“john”和“addr”列值为“china”条件,才能更新成功;否则更新失败。

   var params = {
    tableName: "sampleTable",
    primaryKey: [{ 'gid': Long.fromNumber(20013) }, { 'uid': Long.fromNumber(20013) }],
    updateOfAttributeColumns: [{ 'PUT': [{ 'col1': 'test6' }] }]
};

//指定条件。期望行存在并且name=john,addr=china。
var condition = new TableStore.CompositeCondition(TableStore.LogicalOperator.AND);
condition.addSubCondition(new TableStore.SingleColumnCondition('name', 'john', TableStore.ComparatorType.EQUAL));
condition.addSubCondition(new TableStore.SingleColumnCondition('addr', 'china', TableStore.ComparatorType.EQUAL));

params.condition = new TableStore.Condition(TableStore.RowExistenceExpectation.EXPECT_EXIST, condition);

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

创建数据表 2025-04-22 14:23

本文将通过参数说明和示例代码为您介绍如何使用 Node.js SDK 创建数据表。在创建数据表时,您需要指定数据表的结构信息和配置信息。CU 模式(原按量模式)下高性能型实例中的数据表还可以根据需要设置预留读写吞吐量。

更新表配置 2025-04-22 14:23

本文将通过参数说明和示例代码为您介绍如何使用 Node.js SDK 更新表配置。在更新数据表时,您可以修改表的配置信息(例如数据生命周期、最大版本数、有效版本偏差等)和 Stream 配置。此外,您还可以为 CU 模式(原按量模式)下高性能型实例中数据表调整预留读写吞吐量。

列出表名称 2025-04-22 14:23

使用ListTable接口获取当前实例下已创建的所有表的表名。 前提条件

查询表描述信息 2025-04-22 14:23

使用DescribeTable接口可以查询指定表的结构、预留读/写吞吐量详情等信息。 前提条件

删除数据表 2025-04-22 14:23

使用DeleteTable接口删除当前实例下指定数据表。 注意事项 数据表删除后将无法恢复,请谨慎操作。

主键列自增 2025-04-22 14:23

设置非分区键的主键列为自增列后,在写入数据时,无需为自增列设置具体值,表格存储

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号