All Products
Search

This Product

    Tablestore:Penanganan error Python SDK

    Document Center

    Tablestore:Penanganan error Python SDK

    Last Updated:Aug 05, 2026

    SDK Tablestore Python menangani error menggunakan eksepsi. Topik ini menjelaskan metode penanganan error Tablestore, informasi eksepsi, dan kebijakan pengulangan ulang.

    Metode

    SDK Tablestore Python menggunakan eksepsi untuk menangani error. Panggilan API dianggap berhasil jika tidak ada eksepsi yang dilempar; sebaliknya, operasi tersebut gagal.

    Catatan

    Untuk operasi batch, seperti BatchGetRow dan BatchWriteRow, Anda harus memeriksa adanya eksepsi dan memverifikasi status setiap baris. Panggilan API hanya dianggap berhasil jika semua baris diproses tanpa error.

    Eksepsi

    SDK Tablestore Python mendefinisikan dua jenis eksepsi: OTSClientError dan OTSServiceError, keduanya merupakan turunan dari kelas Exception.

    • OTSClientError: Menunjukkan eksepsi yang terjadi di dalam SDK, seperti parameter yang tidak valid atau error saat mengurai respons.

    • OTSServiceError: Menunjukkan error sisi server yang diurai dari respons server. OTSServiceError mencakup anggota berikut:

      • get_http_status: Kode status HTTP respons, misalnya 200 atau 404.

      • get_error_code: Kode error berupa string yang dikembalikan oleh Tablestore.

      • get_error_message: Pesan error berupa string yang dikembalikan oleh Tablestore.

      • get_request_id: Pengidentifikasi unik universal (UUID) yang secara unik mengidentifikasi permintaan. Jika Anda tidak dapat menyelesaikan masalah, catat ID permintaan ini dan submit a ticket.

    Pengulangan Ulang

    • SDK secara otomatis melakukan pengulangan ulang operasi ketika terjadi error. Secara default, jumlah maksimum pengulangan ulang adalah 20 dengan interval maksimum antar pengulangan ulang sebesar 3.000 ms. SDK melakukan pengulangan ulang untuk error pembatasan kecepatan (throttling) dan error internal sisi server pada operasi baca. Untuk informasi lebih lanjut, lihat tablestore/retry.py.

    • Untuk membuat kebijakan pengulangan ulang kustom, wariskan kelas RetryPolicy. Saat menginisialisasi objek OTSClient, teruskan kebijakan pengulangan ulang kustom tersebut sebagai parameter.

    SDK menyediakan kebijakan pengulangan ulang berikut:

    • DefaultRetryPolicy: Kebijakan pengulangan ulang default yang hanya berlaku untuk operasi baca, dengan jumlah maksimum pengulangan ulang sebanyak 20 kali dan interval maksimum antar pengulangan ulang sebesar 3.000 ms.

    • NoRetryPolicy: Tidak melakukan pengulangan ulang sama sekali.

    • NoDelayRetryPolicy: Kebijakan pengulangan ulang tanpa jeda. Gunakan kebijakan ini dengan hati-hati.

    • WriteRetryPolicy: Berdasarkan kebijakan pengulangan ulang default, kebijakan ini juga mencakup pengulangan ulang untuk operasi tulis.