Tablestore:Lakukan pembaruan bersyarat

Prasyarat

• Instans OTSClient telah diinisialisasi. Untuk informasi selengkapnya, lihat Inisialisasi instans OTSClient.

• Tabel data telah dibuat dan data telah ditulis ke dalamnya. Untuk informasi selengkapnya, lihat Buat tabel data dan Tulis data.

Catatan penggunaan

Saat memanggil operasi PutRow, UpdateRow, DeleteRow, atau BatchWriteRow untuk memperbarui data dalam tabel, Anda dapat menentukan kondisi keberadaan baris dan kondisi berbasis kolom guna menerapkan pembaruan bersyarat. Data hanya diperbarui jika semua kondisi terpenuhi.

Pembaruan bersyarat didasarkan pada dua jenis kondisi: kondisi keberadaan baris dan kondisi berbasis kolom.

• Kondisi keberadaan baris yang didukung meliputi: IGNORE, EXPECT_EXIST, dan EXPECT_NOT_EXIST.

  Saat memperbarui tabel, Tablestore terlebih dahulu memverifikasi apakah kondisi keberadaan baris terpenuhi. Jika tidak, pembaruan gagal dan kesalahan dilaporkan.

• Kondisi berbasis kolom mencakup RelationalCondition dan CompositeCondition, yang digunakan untuk mengevaluasi apakah nilai satu atau beberapa kolom memenuhi kriteria tertentu.

  Kondisi berbasis kolom mendukung operator relasional berikut: =, !=, >, >=, <, dan <=. Selain itu, kondisi ini juga mendukung operator logika: NOT, AND, dan OR. Anda dapat menentukan hingga 10 kondisi berbasis kolom dalam satu pembaruan bersyarat.

  • RelationalCondition memungkinkan perbandingan antara suatu kolom dan konstanta. Perbandingan antar dua kolom atau antar dua konstanta tidak didukung.

  • CompositeCondition terdiri dari beberapa RelationalCondition atau CompositeCondition lainnya, dengan hubungan logika yang ditentukan di antara subkondisi tersebut.

Anda dapat melakukan pembaruan bersyarat untuk menerapkan kunci optimis (optimistic locking). Saat memperbarui suatu baris, Anda harus mengambil nilai kolom tertentu dan menentukan kondisi pembaruan baris berdasarkan nilai kolom tersebut. Misalnya, saat memperbarui nilai Kolom A dalam suatu baris menjadi 2, Anda harus mengambil nilai Kolom A terlebih dahulu. Dalam contoh ini, nilai yang diambil adalah 1. Lalu, Anda harus menentukan bahwa baris hanya dapat diperbarui jika nilai Kolom A adalah 1. Jika kondisi yang ditentukan terpenuhi, pembaruan berhasil. Jika baris tersebut telah diperbarui oleh client lain, pembaruan akan gagal.

Parameter

Contoh

Kode contoh berikut menunjukkan cara memperbarui data berdasarkan kondisi berbasis kolom. Jika nilai kolom col0 sama dengan 5, data diperbarui; jika tidak, pembaruan gagal.

    // Tentukan primary key baris. Primary key harus sama dengan primary key yang ditentukan dalam TableMeta saat tabel dibuat. 
    PrimaryKey primaryKey = new PrimaryKey();
    primaryKey.Add("pk0", new ColumnValue(0));
    primaryKey.Add("pk1", new ColumnValue("abc"));

    // Tentukan kolom atribut baris. 
    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);

    // Panggil operasi PutRow saat kondisi lain belum dikonfigurasi. Operasi ini diharapkan berhasil. 
    try
    {
        otsClient.PutRow(request);

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

    // Jika nilai kolom col0 tidak sama dengan 5, panggil kembali operasi PutRow untuk menimpa nilai aslinya. Operasi ini diharapkan berhasil. 
    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);
    }

    // Jika nilai kolom col0 sama dengan 5, panggil kembali operasi PutRow untuk menimpa nilai aslinya. Operasi ini diharapkan berhasil. 
    try
    {
        // Tambahkan kondisi baru bahwa nilai kolom col0 sama dengan 5. 
        request.Condition.ColumnCondition = new RelationalCondition("col0",
                                            CompareOperator.EQUAL,
                                            new ColumnValue(5));
        otsClient.PutRow(request);

        Console.WriteLine("Put row succeeded.");
    }
    catch (OTSServerException)
    {
        // OTSServerException dikembalikan karena kondisi tidak terpenuhi. 
        Console.WriteLine("Put row failed  because condition check failed. but expected");
    }
    catch (Exception ex)
    {
        Console.WriteLine("Put row failed. error:{0}", ex.Message);
    }