只有满足条件时，才能对数据表中的数据进行更新；当不满足条件时，更新失败并给用户报错。

前提条件

  • 已初始化Client，详情请参见初始化。
  • 已创建数据表并写入数据。

使用方法

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

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

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

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

  • 列条件：包括SingleColumnCondition和CompositeColumnCondition，是基于某一列或者某些列的列值进行条件判断。
    • SingleColumnCondition支持一列（可以是主键列）和一个常量比较。不支持两列或者两个常量相比较。
    • CompositeColumnCondition的内节点为逻辑运算，子条件可以是SingleColumnCondition或CompositeColumnCondition。

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

限制

条件更新的列条件支持关系运算（=、!=、>、>=、<、<=）和逻辑运算（NOT、AND、OR），最多支持10个条件的组合。

参数

参数说明
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表示。

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

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

逻辑运算符不同可以添加的子条件个数不同。
  • 当逻辑运算符为NOT时，只能添加一个子条件。
  • 当逻辑运算符为AND或OR时，必须至少添加两个子条件。
FilterIfMissing当列在某行中不存在时，条件检查是否通过。类型为bool值，默认值为true，表示如果列在某行中不存在时，则条件检查通过，该行满足更新条件。

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

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

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

示例

  • 示例1
    根据指定主键更新一行，如果指定的行存在，则更新成功，否则更新失败。 
        updateRowRequest := new(tablestore.UpdateRowRequest)
    updateRowChange := new(tablestore.UpdateRowChange)
    updateRowChange.TableName = tableName
    updatePk := new(tablestore.PrimaryKey)
    updatePk.AddPrimaryKeyColumn("pk1", "pk1value1")
    updatePk.AddPrimaryKeyColumn("pk2", int64(2))
    updatePk.AddPrimaryKeyColumn("pk3", []byte("pk3"))
    updateRowChange.PrimaryKey = updatePk
    updateRowChange.DeleteColumn("col1")            //删除col1列。
    updateRowChange.PutColumn("col2", int64(77))    //新增col2列，值为77。
    updateRowChange.PutColumn("col4", "newcol3")    //新增col4列，值为"newcol3"。
    //期望指定行存在。
    updateRowChange.SetCondition(tablestore.RowExistenceExpectation_EXPECT_EXIST)
    updateRowRequest.UpdateRowChange = updateRowChange
    _, err := client.UpdateRow(updateRowRequest)
  • 示例2
    根据指定主键删除一行，如果指定的行存在，且col2列的值为3，则更新成功，否则更新失败。 
        deleteRowReq := new(tablestore.DeleteRowRequest)
    deleteRowReq.DeleteRowChange = new(tablestore.DeleteRowChange)
    deleteRowReq.DeleteRowChange.TableName = tableName
    deletePk := new(tablestore.PrimaryKey)
    deletePk.AddPrimaryKeyColumn("pk1", "pk1value1")
    deletePk.AddPrimaryKeyColumn("pk2", int64(2))
    deletePk.AddPrimaryKeyColumn("pk3", []byte("pk3"))
    deleteRowReq.DeleteRowChange.PrimaryKey = deletePk

    //期望行存在。
    deleteRowReq.DeleteRowChange.SetCondition(tablestore.RowExistenceExpectation_EXPECT_EXIST)
    //期望列col2的值为3。
    clCondition1 := tablestore.NewSingleColumnCondition("col2", tablestore.CT_EQUAL, int64(3))
    deleteRowReq.DeleteRowChange.SetColumnCondition(clCondition1)
    _, err := client.DeleteRow(deleteRowReq)