Tablestore PHP SDK: Perbarui satu baris data - Tablestore

Perbarui nilai kolom atribut, tambahkan kolom atribut, hapus versi tertentu dari kolom atribut, atau hapus seluruh kolom atribut dalam tabel Tablestore menggunakan PHP SDK.

Sebelum memulai

Inisialisasi client Tablestore

Metode

public function updateRow(array $request)

Deskripsi parameter untuk $request

Name	Type	Description
table_name (required)	string	Nama tabel data.
primary_key (required)	array	Informasi kunci primer, termasuk nama dan nilai kolom kunci primer. Tipe data kolom kunci primer meliputi STRING, INTEGER, dan BINARY. Jumlah dan tipe kunci primer harus sesuai dengan yang telah didefinisikan untuk tabel tersebut.
update_of_attribute_columns (required)	array	Kolom atribut yang akan diperbarui beserta jenis operasinya. Jenis operasi yang didukung: PUT (menambahkan atau memperbarui nilai kolom), DELETE (menghapus versi tertentu), dan DELETE_ALL (menghapus seluruh kolom).
condition (required)	array	Kondisi pembaruan. Untuk informasi lebih lanjut, lihat conditional update.
return_content (optional)	array	Data yang akan dikembalikan. return_type (required)`array`: Jenis data yang dikembalikan. ReturnTypeConst::CONST_NONE (default): Tidak mengembalikan data apa pun. ReturnTypeConst::CONST_PK: Mengembalikan kolom kunci primer. ReturnTypeConst::CONST_AFTER_MODIFY: Mengembalikan nilai kolom setelah dimodifikasi. Gunakan opsi ini untuk atomic counters.
transaction_id (optional)	string	ID transaksi lokal. ID ini secara unik mengidentifikasi sebuah transaksi lokal. Untuk informasi lebih lanjut, lihat local transactions.

Contoh

Contoh berikut memperbarui baris dengan nilai kunci primer row1 pada tabel test_table. Kolom atribut col1 diatur menjadi changed_val1.

$request = array(
    'table_name' => 'test_table',
    // Bangun kunci primer
    'primary_key' => array(
        array('id', 'row1')
    ),
    // Tentukan kondisi pembaruan saat memperbarui baris.
    // RowExistenceExpectationConst::CONST_IGNORE berarti melewati pemeriksaan keberadaan baris.
    'condition' => RowExistenceExpectationConst::CONST_IGNORE
);
// Kolom atribut yang akan diperbarui
$request['update_of_attribute_columns'] = array(
    'PUT' => array(
        array('col1', 'changed_val1')
    )
);

try {
    // Panggil metode updateRow untuk memperbarui baris
    $response = $client->updateRow($request);
    echo "* Biaya CU Baca: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "* Biaya CU Tulis: " . $response['consumed']['capacity_unit']['write'] . "\n";   
} catch (Exception $e) {
    echo "Pembaruan Baris gagal.";
}

Gunakan potongan kode berikut untuk melakukan operasi pembaruan baris lainnya.

Tambahkan kolom atribut.

$request['update_of_attribute_columns'] = array(
    'PUT' => array(
        array('col2', 'val2')
    )
);

Tetapkan nomor versi untuk kolom atribut.

$request['update_of_attribute_columns'] = array(
    'PUT' => array(
        array('col2', 'val2', null, intval(microtime(true) * 1000))
    )
);

Hapus versi tertentu dari kolom atribut.

$request['update_of_attribute_columns'] = array(
    'DELETE' => array(
        array('col2', 1754285998447)
    )
);

Hapus semua data dalam kolom atribut.

$request['update_of_attribute_columns'] = array(
    'DELETE_ALL' => array('col2')
);

Referensi

Batch update data