全部产品
Search

搜索本产品

    Tablestore：Tulis satu baris data

    文档中心

    Tablestore：Tulis satu baris data

    更新时间：Jul 06, 2025

    Topik ini menjelaskan cara menulis satu baris data ke tabel Tablestore menggunakan Tablestore SDK for Java.

    Prasyarat

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

    Metode

    public PutRowResponse putRow(PutRowRequest putRowRequest) throws TableStoreException, ClientException

    Parameter PutRowRequest

    • rowChange (wajib) RowPutChange: Informasi tentang baris yang akan ditulis. Tabel berikut menjelaskan parameter yang menentukan informasi tersebut.

      Parameter

      Tipe

      Deskripsi

      tableName (wajib)

      String

      Nama tabel data.

      primaryKey (wajib)

      PrimaryKey

      Informasi primary key, termasuk nama kolom primary key dan nilainya.

      • Tipe data kolom primary key meliputi STRING, INTEGER, dan BINARY.

      • Jumlah dan tipe primary key yang Anda tentukan harus sesuai dengan yang didefinisikan dalam tabel.

      • Saat kolom primary key ditetapkan sebagai kolom primary key auto-increment, Anda harus mengatur nilai kolom tersebut sebagai placeholder. Untuk informasi lebih lanjut, lihat Kolom primary key auto-increment.

      columnsToPut (opsional)

      List<Column>

      Informasi kolom atribut, termasuk nama kolom atribut, nilai, dan nomor versi.

      • Tipe data kolom atribut meliputi STRING, INTEGER, BINARY, DOUBLE, dan BOOLEAN.

      • Nomor versi adalah timestamp yang secara default dibuat otomatis oleh sistem atau dapat ditentukan oleh Anda. Untuk informasi lebih lanjut, lihat Versi data dan TTL.

      condition (opsional)

      Condition

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

      returnType (opsional)

      ReturnType

      Tipe pengembalian.

      • RT_NONE: nilai default, tidak ada data yang dikembalikan.

      • RT_PK: mengembalikan kolom primary key, yang dapat digunakan untuk kolom primary key auto-increment.

      • RT_AFTER_MODIFY: mengembalikan nilai kolom yang dimodifikasi, yang digunakan untuk penghitung atomik.

    Contoh kode

    Berikut adalah contoh kode untuk menulis satu baris data ke tabel test_table. Nilai primary key dari baris ini adalah row1.

    public static void putRowExample(SyncClient client) {
    // Bangun primary key.
    PrimaryKeyBuilder primaryKeyBuilder = PrimaryKeyBuilder.createPrimaryKeyBuilder();
    primaryKeyBuilder.addPrimaryKeyColumn("id", PrimaryKeyValue.fromString("row1"));
    PrimaryKey primaryKey = primaryKeyBuilder.build();

    // Bangun data baris yang akan ditulis.
    RowPutChange rowPutChange = new RowPutChange("test_table", primaryKey);

    // Panggil metode putRow untuk menulis data baris.
    PutRowRequest putRowRequest = new PutRowRequest(rowPutChange);
    PutRowResponse putRowResponse = client.putRow(putRowRequest);

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

    • Tambahkan kolom atribut.

      rowPutChange.addColumn("col1", ColumnValue.fromString("val1"));

    • Tentukan nomor versi. Anda dapat menentukan nomor versi terpisah untuk setiap kolom atribut.

      // Gunakan timestamp saat ini sebagai nomor versi.
rowPutChange.addColumn("col1", ColumnValue.fromString("val1"), System.currentTimeMillis());

    Referensi