All Products
Search
Document Center

Tablestore:Menulis satu baris data

Last Updated:Apr 21, 2026

Gunakan metode putRow dalam PHP SDK untuk menulis satu baris data ke tabel Tablestore.

Sebelum memulai

Inisialisasi client Tablestore

Deskripsi metode

public function putRow(array $request)

Deskripsi parameter untuk $request

Name

Type

Description

table_name (required)

string

Nama tabel.

primary_key (required)

array

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

  • Tipe kolom kunci primer meliputi STRING, INTEGER, dan BINARY.

  • Jumlah dan tipe kunci primer pada baris tersebut harus sesuai dengan yang didefinisikan untuk tabel.

  • Jika kolom kunci primer merupakan kolom auto-increment, atur nilainya ke placeholder. Untuk informasi selengkapnya, lihat Auto-increment primary key column.

attribute_columns (optional)

array

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

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

  • Nomor versi berupa timestamp. Secara default, sistem menghasilkannya secara otomatis. Untuk menentukan nomor versi secara manual, lihat Data versions and lifecycle.

condition (optional)

array

Kondisi penulisan. Untuk informasi selengkapnya, lihat Conditional update.

return_content (optional)

array

Data yang akan dikembalikan.

  • return_type (required)array: Tipe pengembalian.

    • ReturnTypeConst::CONST_NONE (default): Tidak mengembalikan data apa pun.

    • ReturnTypeConst::CONST_PK: Mengembalikan kolom kunci primer. Gunakan ini untuk mengambil nilai kunci primer auto-increment.

    • ReturnTypeConst::CONST_AFTER_MODIFY: Mengembalikan nilai kolom yang telah diperbarui. Gunakan ini untuk atomic counters.

transaction_id (optional)

string

ID transaksi lokal. Ini secara unik mengidentifikasi suatu transaksi lokal. Untuk informasi selengkapnya, lihat Local transaction.

Kode contoh

Menulis satu baris data ke tabel test_table dengan nilai kunci primer row1.

$request = array (
    'table_name' => 'test_table',
    // Bangun kunci primer
    'primary_key' => array (
        array('id', 'row1')
    )
);

try{
    // Panggil putRow untuk menulis baris
    $response = $client->putRow($request);
    echo "* Read CU Cost: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "* Write CU Cost: " . $response['consumed']['capacity_unit']['write'] . "\n";
} catch (Exception $e) {
    echo "Put Row failed.";
}
  • Tambahkan kolom atribut.

    $request['attribute_columns'] = array(
        array('col1', 'val1')
    );
  • Tentukan nomor versi. Tetapkan nomor versi terpisah untuk setiap kolom atribut.

    $request['attribute_columns'] = array(
        array('col1', 'val1', null, intval(microtime(true) * 1000))
    );

Referensi

Batch update data