All Products
Search

This Product

    Tablestore:Membaca satu baris data

    Document Center

    Tablestore:Membaca satu baris data

    Last Updated:Apr 21, 2026

    Gunakan Python SDK untuk membaca satu baris data dari tabel Tablestore.

    Usage notes

    Saat membaca data, Anda harus menyediakan nilai kunci utama lengkap, termasuk nilai kolom kunci utama auto-increment apa pun.

    Prerequisites

    Initialize Tablestore Client

    Method

    def get_row(self, table_name, primary_key, columns_to_get=None,
            column_filter=None, max_version=1, time_range=None,
            start_column=None, end_column=None, token=None,
            transaction_id=None):

    Parameters

    Parameter

    Type

    Description

    table_name (Required)

    str

    Nama tabel data.

    primary_key (Required)

    List[Tuple]

    Kunci utama, yang mencakup nama dan nilai kolom kunci utama.

    • Tipe data kolom kunci utama dapat berupa STRING, INTEGER, atau BINARY.

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

    max_version (Optional)

    int

    Jumlah maksimum versi yang dikembalikan. Nilai default: 1.

    • Anda harus menentukan salah satu parameter max_version atau time_range.

    • Jika jumlah versi data yang sesuai melebihi nilai ini, metode akan mengembalikan sejumlah versi terbaru tersebut dalam urutan menurun berdasarkan timestamp.

    time_range (Optional)

    Tuple

    Rentang versi data.

    • Anda harus menentukan salah satu parameter max_version atau time_range.

    • Setiap kolom atribut dalam tabel data Tablestore dapat memiliki beberapa versi data. Jika Anda menentukan rentang versi, metode hanya akan mengembalikan data dalam rentang tersebut.

    columns_to_get (Optional)

    List[str]

    Daftar kolom data yang akan dibaca. Daftar ini dapat mencakup kolom kunci utama maupun kolom atribut.

    • Jika Anda menghilangkan parameter ini, metode akan mengembalikan seluruh baris.

    • Jika baris tidak berisi kolom yang ditentukan, objek baris yang dikembalikan mencakup kunci utama tetapi tidak ada kolom atribut.

    column_filter (Optional)

    ColumnCondition

    Kondisi filter. Untuk informasi selengkapnya, lihat Filter.

    • Jika Anda menentukan columns_to_get dan column_filter, sistem pertama-tama akan mengambil kolom yang ditentukan dalam columns_to_get, lalu menerapkan column_filter pada hasilnya.

    transaction_id (Optional)

    str

    ID transaksi lokal, yang secara unik mengidentifikasi transaksi lokal. Untuk informasi selengkapnya, lihat Local transactions.

    Examples

    Contoh berikut membaca satu baris dengan nilai kunci utama row1.

    try:
    # Construct the primary key.
    primary_key = [('id', 'row1')]

    # Call the get_row method to read the row data.
    consumed, return_row, next_token = client.get_row('test_table', primary_key)
    print('Read CU Cost: %s' % consumed.read)
    print('Write CU Cost: %s' % consumed.write)
    print('Row Data: %s %s' % (return_row.primary_key, return_row.attribute_columns))
except Exception as e:
    print("Get row failed with error: %s" % e)

    • Untuk mengembalikan hanya data dalam rentang versi tertentu, tentukan parameter time_range.

      # Set the version range for the query to the last 24 hours.
time_range = (int(time.time() * 1000 - 86400 * 1000), int(time.time() * 1000))

# Call the get_row method to read the row data.
consumed, return_row, next_token = client.get_row('test_table', primary_key, time_range=time_range)

    • Untuk mengambil kolom atribut tertentu, tentukan parameter columns_to_get.

      columns_to_get = ['col2']

# Call the get_row method to read the row data.
consumed, return_row, next_token = client.get_row('test_table', primary_key, columns_to_get=columns_to_get)

    References