All Products
Search
Document Center

Tablestore:Perbarui satu baris

Last Updated:May 12, 2026

Topik ini menjelaskan cara menggunakan Tablestore .NET SDK untuk memperbarui satu baris dalam tabel Tablestore. Anda dapat memperbarui nilai kolom atribut, menambahkan kolom atribut, atau menghapus versi tertentu atau seluruh kolom atribut.

Prasyarat

Inisialisasi client Tablestore

Metode

public UpdateRowResponse UpdateRow(UpdateRowRequest request)

Metode asinkron:

public Task<UpdateRowResponse> UpdateRowAsync(UpdateRowRequest request)

Parameter UpdateRowRequest

Parameter

Tipe

Deskripsi

tableName (Wajib)

string

Nama tabel.

primaryKey (Wajib)

PrimaryKey

Kunci primer dari baris yang akan diperbarui. Berisi nama dan nilai kolom kunci primer.

  • Tipe data untuk kolom kunci primer dapat berupa STRING, INTEGER, atau BINARY.

  • Jumlah dan tipe data kolom kunci primer harus sesuai dengan skema kunci primer tabel.

updateOfAttribute (Wajib)

UpdateOfAttribute

Kolom atribut yang akan diperbarui dan jenis operasi pembaruan.

condition (Wajib)

Condition

Kondisi pembaruan. Untuk informasi lebih lanjut, lihat Conditional update.

Kode contoh

Contoh ini memperbarui baris dengan kunci primer row1 dengan mengubah nilai kolom atribut col1 menjadi changed_val1.

try
{
    // Membuat kunci primer.
    PrimaryKey primaryKey = new PrimaryKey
    {
        { "id", new ColumnValue("row1") }
    };
    // Menentukan kolom atribut yang akan diperbarui.
    UpdateOfAttribute updateOfAttribute = new UpdateOfAttribute();
    updateOfAttribute.AddAttributeColumnToPut("col1", new ColumnValue("changed_val1"));
    // Anda harus menentukan kondisi saat memperbarui baris. (RowExistenceExpectation.IGNORE melewati pemeriksaan keberadaan baris.)
    Condition condition = new Condition(RowExistenceExpectation.IGNORE);

    // Memanggil metode UpdateRow untuk memperbarui baris.
    UpdateRowRequest updateRowRequest = new UpdateRowRequest("test_table", condition, primaryKey, updateOfAttribute);
    UpdateRowResponse updateRowResponse = client.UpdateRow(updateRowRequest);
    Console.WriteLine($"RequestId: {updateRowResponse.RequestID}");
    Console.WriteLine($"Biaya CU Baca: {updateRowResponse.ConsumedCapacityUnit.Read}");
    Console.WriteLine($"Biaya CU Tulis: {updateRowResponse.ConsumedCapacityUnit.Write}");
}
catch (Exception ex)
{
    Console.WriteLine($"Pembaruan baris gagal, exception: {ex.Message}");
}

Modifikasi kode contoh untuk melakukan operasi baris berikut:

  • Tambahkan kolom atribut.

    updateOfAttribute.AddAttributeColumnToPut("col2", new ColumnValue("val2"));
  • Hapus seluruh kolom atribut.

    updateOfAttribute.AddAttributeColumnToDelete("col2");

Topik terkait