全部产品
Search

搜索本产品

    Tablestore：Memperbarui satu baris data

    文档中心

    Tablestore：Memperbarui satu baris data

    更新时间：Jul 06, 2025

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

    Prasyarat

    Klien telah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi klien Tablestore.

    Metode

    public UpdateRowResponse updateRow(UpdateRowRequest updateRowRequest) throws TableStoreException, ClientException

    Parameter UpdateRowRequest

    • rowChange (wajib) RowUpdateChange: Informasi tentang baris yang akan diperbarui, mencakup parameter berikut.

      Parameter

      Tipe

      Deskripsi

      tableName (wajib)

      String

      Nama tabel data.

      primaryKey (wajib)

      PrimaryKey

      Informasi kunci utama, termasuk nama dan nilai kolom kunci utama.

      • Tipe data kolom kunci utama meliputi STRING, INTEGER, dan BINARY.

      • Jumlah dan tipe kolom kunci utama yang Anda tentukan harus sesuai dengan yang didefinisikan dalam tabel data.

      columnsToUpdate (wajib)

      List<Pair<Column, Type>>

      Informasi tentang kolom atribut yang akan diperbarui dan tipe operasi.

      condition (opsional)

      Condition

      Kondisi penulisan. Untuk informasi lebih lanjut, lihat Melakukan pembaruan bersyarat.

    Kode contoh

    Berikut adalah kode contoh yang menunjukkan cara memodifikasi data baris dengan nilai kunci utama row1 dalam tabel test_table. Dalam contoh ini, nilai kolom atribut col1 diubah menjadi changed_val1.

    public static void updateRowExample(SyncClient client) {
    // Membangun kunci utama.
    PrimaryKeyBuilder primaryKeyBuilder = PrimaryKeyBuilder.createPrimaryKeyBuilder();
    primaryKeyBuilder.addPrimaryKeyColumn("id", PrimaryKeyValue.fromString("row1"));
    PrimaryKey primaryKey = primaryKeyBuilder.build();

    // Membangun nilai kolom yang ingin diperbarui.
    RowUpdateChange rowUpdateChange = new RowUpdateChange("test_table", primaryKey);
    rowUpdateChange.put("col1", ColumnValue.fromString("changed_val1"));

    // Panggil metode updateRow untuk memperbarui data baris.
    UpdateRowRequest updateRowRequest = new UpdateRowRequest(rowUpdateChange);
    UpdateRowResponse updateRowResponse = client.updateRow(updateRowRequest);

    // Kembalikan hasilnya.
    System.out.println("RequestId: " + updateRowResponse.getRequestId());
    System.out.println("Biaya CU Baca: " + updateRowResponse.getConsumedCapacity().getCapacityUnit().getReadCapacityUnit());
    System.out.println("Biaya CU Tulis: " + updateRowResponse.getConsumedCapacity().getCapacityUnit().getWriteCapacityUnit());
}

    Anda juga dapat merujuk pada kode contoh untuk melakukan operasi data baris berikut:

    • Menambahkan kolom atribut

      rowUpdateChange.put("col2", ColumnValue.fromString("val2"));

    • Menentukan nomor versi data dalam kolom atribut

      rowUpdateChange.put("col2", ColumnValue.fromString("val2"), System.currentTimeMillis());

    • Menghapus versi tertentu dari data dalam kolom atribut

      rowUpdateChange.deleteColumn("col2", 1747893563831L);

    • Menghapus seluruh kolom atribut

      rowUpdateChange.deleteColumns("col2");

    Referensi