All Products
Search
Document Center

Tablestore:Menulis satu baris

Last Updated:May 12, 2026

Pelajari cara menggunakan .NET SDK untuk menulis satu baris ke tabel Tablestore.

Prasyarat

Inisialisasi client Tablestore

Metode

public PutRowResponse PutRow(PutRowRequest request)

Metode asinkron:

public Task<PutRowResponse> PutRowAsync(PutRowRequest request)

Parameter PutRowRequest

Parameter

Tipe

Deskripsi

tableName (Wajib)

string

Nama tabel.

primaryKey (Wajib)

PrimaryKey

Nama dan nilai kolom kunci primer untuk baris tersebut.

  • Tipe data yang valid untuk kolom kunci primer adalah STRING, INTEGER, dan BINARY.

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

columns (Opsional)

AttributeColumns

Kolom atribut, termasuk nama, nilai, dan versi datanya.

  • Tipe data yang valid untuk kolom atribut adalah STRING, INTEGER, BINARY, DOUBLE, dan BOOLEAN.

  • Secara default, Tablestore secara otomatis menghasilkan versi data. Anda juga dapat menentukan versi kustom. Untuk informasi selengkapnya, lihat Versi data dan masa hidup data.

condition (Wajib)

Condition

Kondisi untuk operasi penulisan. Untuk informasi selengkapnya, lihat penulisan kondisional.

Kode contoh

Contoh ini menulis satu baris dengan nilai kunci primer "row1" ke tabel "test_table".

try
{
    // Membuat kunci primer.
    PrimaryKey primaryKey = new PrimaryKey
    {
        { "id", new ColumnValue("row1") }
    };
    // Menentukan kondisi untuk operasi penulisan. 
    // RowExistenceExpectation.IGNORE melewati pemeriksaan keberadaan baris.
    Condition condition = new Condition(RowExistenceExpectation.IGNORE);

    // Memanggil metode PutRow untuk menulis baris.
    PutRowRequest putRowRequest = new PutRowRequest("test_table", condition, primaryKey, null);
    PutRowResponse putRowResponse = client.PutRow(putRowRequest);
    Console.WriteLine($"* RequestId: {putRowResponse.RequestID}");
    Console.WriteLine($"* Biaya CU Baca: {putRowResponse.ConsumedCapacityUnit.Read}");
    Console.WriteLine($"* Biaya CU Tulis: {putRowResponse.ConsumedCapacityUnit.Write}");
}
catch (Exception ex)
{
    Console.WriteLine($"Gagal menulis baris, exception: {ex.Message}");
}
  • Menambahkan kolom atribut.

    AttributeColumns columns = new AttributeColumns
    {
        { "col1", new ColumnValue("val1") }
    };
    
    // Membuat PutRowRequest.
    PutRowRequest putRowRequest = new PutRowRequest("test_table", condition, primaryKey, columns);

Topik terkait

Menulis data secara batch