只有当数据满足列判断条件时,才能对数据表中的数据进行更新;当数据不满足列判断条件时,数据更新失败。
前提条件
已初始化Client。具体操作,请参见初始化OTSClient。
已创建数据表并写入数据。
使用方法
在通过PutRow、UpdateRow、DeleteRow或BatchWriteRow接口更新数据时,可以使用条件更新检查行存在性条件和列条件,只有满足条件时才能成功更新。
条件更新包括行存在性条件和列条件。
行存在性条件:包括IGNORE、EXPECT_EXIST和EXPECT_NOT_EXIST,分别代表忽略、期望存在和期望不存在。
对数据表进行更改操作时,系统会先检查行存在性条件,如果不满足行存在性条件,则更改失败并给用户报错。
列条件:包括SingleColumnCondition和CompositeColumnCondition,是基于某一列或者某些列的列值进行条件判断。
列条件中支持使用关系运算(=、!=、>、>=、<、<=)和逻辑运算(NOT、AND、OR),单个更新条件中最多支持设置10个列条件。
SingleColumnCondition支持一列(可以是主键列)和一个常量比较。不支持两列或者两个常量相比较。
CompositeColumnCondition的内节点为逻辑运算,子条件可以是SingleColumnCondition或CompositeColumnCondition。
条件更新可以实现乐观锁功能,即在更新某行时,先获取某列的值,假设为列A,值为1,然后设置条件列A=1,更新行使列A=2。如果更新失败,表示有其他客户端已成功更新该行。
参数
参数 | 说明 |
RowExistenceExpectation | 对数据表进行更改操作时,系统会先检查行存在性条件,如果不满足行存在性条件,则更改失败并给用户报错。 行存在性条件包括IGNORE、EXPECT_EXIST和EXPECT_NOT_EXIST,分别用RowExistenceExpectation_IGNORE、RowExistenceExpectation_EXPECT_EXIST、RowExistenceExpectation_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表示。 逻辑运算符不同可以添加的子条件个数不同。
|
FilterIfMissing | 当列在某行中不存在时,条件检查是否通过。类型为bool值,默认值为false,表示如果列在某行中不存在时,则条件检查通过,该行满足更新条件。 当设置FilterIfMissing为true时,如果列在某行中不存在时,则条件检查不通过,该行不满足更新条件。 |
LatestVersionsOnly | 当列存在多个版本的数据时,是否只使用最新版本的值做比较。类型为bool值,默认值为true,表示如果列存在多个版本的数据时,则只使用该列最新版本的值进行比较。 当设置LatestVersionsOnly为false时,如果列存在多个版本的数据,则会使用该列的所有版本的值进行比较,此时只要有一个版本的值满足条件,就表示条件检查通过,该行满足更新条件。 |
示例
使用行存在性条件更新数据
以下示例用于根据指定主键更新一行数据,如果指定的行存在,则更新成功,否则更新失败。
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)
if err != nil {
fmt.Println("update failed with error:", err)
} else {
fmt.Println("update row finished")
}
使用行条件和列条件更新数据
使用条件更新一行数据
updateRowRequest := new(tablestore.UpdateRowRequest) updateRowChange := new(tablestore.UpdateRowChange) updateRowChange.TableName = tableName updatePk := new(tablestore.PrimaryKey) updatePk.AddPrimaryKeyColumn("pk1", "pk1value1") updateRowChange.PrimaryKey = updatePk updateRowChange.PutColumn("col2", int64(77)) //新增col2列,值为77。 //期望col5的列值为3。 clCondition1 := tablestore.NewSingleColumnCondition("col5", tablestore.CT_EQUAL, int64(3)) //FilterIfMissing的默认值为false,表示当列在某行中不存在时条件检查通过。 //如果需要当列在某行中不存在时条件检查不通过,请设置FilterIfMissing参数为true。 //clCondition1.FilterIfMissing = true //期望指定行存在。 updateRowChange.SetCondition(tablestore.RowExistenceExpectation_EXPECT_EXIST) updateRowChange.SetColumnCondition(clCondition1) updateRowRequest.UpdateRowChange = updateRowChange _, err := client.UpdateRow(updateRowRequest) if err != nil { fmt.Println("update failed with error:", err) } else { fmt.Println("update row finished") }
使用条件删除一行数据
以下示例用于根据指定主键删除一行数据,如果指定的行存在,且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)) //FilterIfMissing的默认值为false,表示当列在某行中不存在时条件检查通过。 //如果需要当列在某行中不存在时条件检查不通过,请设置FilterIfMissing参数为true。 //clCondition1.FilterIfMissing = true deleteRowReq.DeleteRowChange.SetColumnCondition(clCondition1) _, err := client.DeleteRow(deleteRowReq) if err != nil { fmt.Println("delete failed with error:", err) } else { fmt.Println("delete row finished") }