All Products
Search

This Product

    Tablestore:membaca satu baris data

    Document Center

    Tablestore:membaca satu baris data

    Last Updated:Apr 21, 2026

    Baca satu baris dari tabel Tablestore berdasarkan kunci primer menggunakan PHP SDK.

    Catatan penggunaan

    Berikan nilai lengkap kunci primer saat membaca data, termasuk nilai untuk kolom kunci utama auto-increment.

    Sebelum memulai

    Inisialisasi Tablestore Client

    Deskripsi metode

    public function getRow(array $request)

    Deskripsi parameter $request

    Name

    Type

    Description

    table_name (Required)

    string

    Nama tabel data.

    primary_key (Required)

    array

    Informasi kunci primer, termasuk nama dan nilai kolom.

    • Tipe data kolom kunci primer mencakup STRING, INTEGER, dan BINARY.

    • Jumlah dan tipe kunci primer harus sesuai dengan yang ada di tabel data.

    max_versions (Optional)

    int

    Jumlah maksimum versi data yang akan dikembalikan.

    • Tentukan salah satu antara max_versions atau time_range.

    • Jika jumlah versi data yang sesuai melebihi nilai ini, sistem mengembalikan versi dari yang terbaru hingga terlama hingga mencapai batas yang ditentukan.

    time_range (Optional)

    array

    Rentang versi data.

    • Tentukan salah satu antara max_versions atau time_range.

    • Setiap kolom atribut dalam tabel Tablestore dapat berisi beberapa versi data. Hanya data dalam rentang versi yang ditentukan yang dikembalikan.

    columns_to_get (Optional)

    array

    Kolom data yang akan dibaca. Menerima kolom kunci primer maupun kolom atribut.

    • Jika tidak ditentukan, seluruh baris dikembalikan.

    • Jika ditentukan tetapi baris tidak berisi kolom yang dimaksud, null dikembalikan.

    column_filter (Optional)

    array

    Kondisi filter. Untuk informasi lebih lanjut, lihat Filter.

    • Jika columns_to_get dan column_filter keduanya ditentukan, sistem terlebih dahulu mengambil kolom yang ditentukan, lalu menerapkan kondisi filter pada hasil tersebut.

    transaction_id (Optional)

    string

    ID transaksi lokal yang secara unik mengidentifikasi sebuah transaksi lokal. Untuk informasi lebih lanjut, lihat Local transactions.

    Kode contoh

    Contoh berikut membaca satu baris dengan nilai kunci primer row1.

    $request = array (
    'table_name' => 'test_table',
    // Construct primary key
    'primary_key' => array (
        array ('id', 'row1')
    ),
    'max_versions' => 1
);

try {
    // Call the getRow method to read row data
    $response = $client->getRow ($request);
    echo "* Read CU Cost: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "* Write CU Cost: " . $response['consumed']['capacity_unit']['write'] . "\n";
    echo "* Row Data: " . "\n";
    echo "Primary Key: ". json_encode($response['primary_key']) . "\n";
    echo "Attribute Columns: ". json_encode($response['attribute_columns']) . "\n";
} catch (Exception $e){
    echo "Get Row failed.";
}

    • Tentukan rentang versi untuk hanya mengembalikan data dalam rentang tersebut.

      // Set the query data version range to one day before the current time
$request['time_range'] = array (
    'start_time' => intval(microtime(true) * 1000) - 86400 * 1000,
    'end_time' => intval(microtime(true) * 1000)
);

    • Tentukan kolom atribut yang akan dibaca.

      $request['columns_to_get'] = array('col2');

    Referensi