日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

條件更新

只有當數據滿足列判斷條件時,才能對數據表中的數據進行更新;當數據不滿足列判斷條件時,數據更新失敗。

前提條件

使用方法

在通過PutRowUpdateRowDeleteRowBatchWriteRow接口操作表中數據時,可以使用條件更新檢查行存在性條件和列條件,只有滿足條件時才能成功更新。

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

  • 行存在性條件:包括IGNORE、EXPECT_EXISTEXPECT_NOT_EXIST,分別代表忽略、期望存在和期望不存在。

    對數據表進行更改操作時,系統會先檢查行存在性條件,如果不滿足行存在性條件,則更改失敗并給用戶報錯。

  • 列條件:包括RelationalConditionCompositeCondition,是基于某一列或者某些列的列值進行條件判斷。

    列條件中支持使用關系運算(=、!=、>、>=、<、<=)和邏輯運算(NOT、AND、OR),單個更新條件中最多支持設置10個列條件。

    • RelationalCondition支持一列(可以是主鍵列)和一個常量比較。不支持兩列或者兩個常量相比較。

    • CompositeCondition的內節點為邏輯運算,子條件可以是RelationalConditionCompositeCondition。

條件更新可以實現樂觀鎖功能,即在更新某行時,先獲取某列的值,假設為列A,值為1,然后設置條件A=1,更新行使A=2。如果更新失敗,表示有其他客戶端已成功更新該行。

參數

參數

說明

RowExistenceExpectation

對數據表進行更改操作時,系統會先檢查行存在性條件,如果不滿足行存在性條件,則更改失敗并給用戶報錯。

行存在性條件包括IGNORE、EXPECT_EXISTEXPECT_NOT_EXIST。

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

  • EXPECT_EXIST:表示期望存在,如果該行存在,則滿足條件;如果該行不存在,則不滿足條件。

  • EXPECT_NOT_EXIST:期望行不存在,如果該行不存在,則滿足條件;如果該行存在,則不滿足條件。

ColumnName

列的名稱。

ColumnValue

列的對比值。

Operator

對列值進行比較的關系運算符,類型詳情請參見ComparatorType

關系運算符包括EQUAL(=)、NOT_EQUAL(!=)、GREATER_THAN(>)、GREATER_THAN(>=)、LESS_THAN(<)和LESS_EQUAL(<=)。

LogicOperator

對多個條件進行組合的邏輯運算符,類型詳情請參見LogicalOperator

邏輯運算符包括NOT、ANDOR。

邏輯運算符不同可以添加的子條件個數不同。

  • 當邏輯運算符為NOT時,只能添加一個子條件。

  • 當邏輯運算符為ANDOR時,必須至少添加兩個子條件。

PassIfMissing

當列在某行中不存在時,條件檢查是否通過。類型為bool值,默認值為true,表示如果列在某行中不存在時,則條件檢查通過,該行滿足更新條件。

當設置PassIfMissingfalse時,如果列在某行中不存在時,則條件檢查不通過,該行不滿足更新條件。

LatestVersionsOnly

當列存在多個版本的數據時,是否只使用最新版本的值做比較。類型為bool值,默認值為true,表示如果列存在多個版本的數據時,則只使用該列最新版本的值進行比較。

當設置LatestVersionsOnlyfalse時,如果列存在多個版本的數據時,則會使用該列的所有版本的值進行比較,此時只要有一個版本的值滿足條件,就條件檢查通過,該行滿足更新條件。

示例

以下示例用于更新滿足指定條件的數據。當col0列的值不等于5時更新數據成功,當col0列的值等于5時更新數據失敗。

    //定義行的主鍵,必須與創建表時的TableMeta中定義的一致。
    PrimaryKey primaryKey = new PrimaryKey();
    primaryKey.Add("pk0", new ColumnValue(0));
    primaryKey.Add("pk1", new ColumnValue("abc"));

    //定義行的屬性列。
    AttributeColumns attribute = new AttributeColumns();
    attribute.Add("col0", new ColumnValue(0));
    attribute.Add("col1", new ColumnValue("a"));
    attribute.Add("col2", new ColumnValue(true));

    PutRowRequest request = new PutRowRequest(tableName, new Condition(RowExistenceExpectation.IGNORE), primaryKey, attribute);

    //不帶condition時putrow,預期更新成功。
    try
    {
        otsClient.PutRow(request);

        Console.WriteLine("Put row succeeded.");
    } catch (Exception ex)
    {
        Console.WriteLine("Put row failed. error:{0}", ex.Message);
    }

    //當col0列的值不等于5,將再次putrow,覆蓋原有值,預期更新成功。
    try
    {
        request.Condition.ColumnCondition = new RelationalCondition("col0",
                                            CompareOperator.NOT_EQUAL,
                                            new ColumnValue(5));
        otsClient.PutRow(request);

        Console.WriteLine("Put row succeeded.");
    } catch (Exception ex)
    {
        Console.WriteLine("Put row failed. error:{0}", ex.Message);
    }

    //當col0列的值等于5,將再次putrow,覆蓋原有值,預期更新失敗。
    try
    {
        //新增col0列的值等于5條件。
        request.Condition.ColumnCondition = new RelationalCondition("col0",
                                            CompareOperator.EQUAL,
                                            new ColumnValue(5));
        otsClient.PutRow(request);

        Console.WriteLine("Put row succeeded.");
    }
    catch (OTSServerException)
    {
        //由于條件不滿足,拋出OTSServerException。
        Console.WriteLine("Put row failed  because condition check failed. but expected");
    }
    catch (Exception ex)
    {
        Console.WriteLine("Put row failed. error:{0}", ex.Message);
    }