All Products
Search
Document Center

Tablestore:Hapus satu baris

Last Updated:Apr 21, 2026

Hapus satu baris data dari tabel Tablestore menggunakan Python SDK.

Prasyarat

Inisialisasi client Tablestore

Metode

def delete_row(self, table_name, row=None, condition=None, return_type=None, transaction_id=None, **kwargs)

Parameter

Parameter

Tipe

Deskripsi

table_name (wajib)

str

Nama tabel.

row (wajib)

Row

Baris yang akan dihapus.

  • primary_key (Wajib)List[Tuple]: Informasi mengenai kunci primer, termasuk nama kolom kunci primer dan nilainya.

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

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

condition (opsional)

Condition

Kondisi untuk penghapusan. Untuk informasi selengkapnya, lihat pembaruan bersyarat.

return_type (opsional)

ReturnType

Tipe nilai yang dikembalikan.

  • RT_NONE (Default): Tidak ada data yang dikembalikan.

  • RT_PK: Kolom kunci primer dikembalikan.

transaction_id (opsional)

str

ID unik untuk transaksi lokal. Untuk informasi selengkapnya, lihat transaksi lokal.

Kode contoh

Kode contoh berikut menghapus baris dengan nilai kunci primer row1 dari tabel test_table.

try:
    # Buat kunci primer.
    primary_key = [('id', 'row1')]

    # Buat baris yang akan dihapus.
    row = Row(primary_key)

    # Panggil delete_row untuk menghapus baris.
    consumed, return_row = client.delete_row('test_table', row)
    print('Read CU Cost: %s' % consumed.read)
    print('Write CU Cost: %s' % consumed.write)
except Exception as e:
    print("Gagal menghapus baris dengan error: %s" % e)

FAQ

Error saat menghapus satu baris menggunakan Tablestore Python SDK 6.0.0

Gunakan salah satu solusi berikut untuk mengatasi masalah ini:

  • Upgrade Tablestore Python SDK ke versi terbaru.

  • Modifikasi parameter metode delete.

    # Tetapkan nama tabel.
    table_name = '<TABLE_NAME>'
    # Buat kunci primer baris tersebut.
    primary_key = [('gid', 1), ('uid', '101')]
    condition = Condition('IGNORE')
    try:
        consumed, return_row = client.delete_row(table_name, primary_key, condition)
        print('Penghapusan berhasil, mengonsumsi %s write CU.' % consumed.write)
    # Tangani exception client, biasanya berupa kesalahan parameter atau masalah jaringan.
    except OTSClientError as e:
        print("Gagal menghapus baris, http_status:%d, error_message:%s" % (e.get_http_status(), e.get_error_message()))
    # Tangani exception server, biasanya berupa kesalahan parameter atau error pembatasan kecepatan.
    except OTSServiceError as e:
        print("Gagal menghapus baris, http_status:%d, error_code:%s, error_message:%s, request_id:%s" % (
        e.get_http_status(), e.get_error_code(), e.get_error_message(), e.get_request_id()))

Topik terkait

Batch Update Data