All Products
Search

This Product

    Tablestore:Penanganan error Java SDK

    Document Center

    Tablestore:Penanganan error Java SDK

    Last Updated:Aug 05, 2026

    Tablestore Java SDK melemparkan eksepsi untuk menangani error. Topik ini menjelaskan metode penanganan error, detail eksepsi, dan kebijakan pengulangan.

    Metode

    Jika pemanggilan API tidak melemparkan eksepsi, operasi tersebut berhasil. Sebaliknya, operasi dianggap gagal.

    Catatan

    Untuk operasi batch, seperti BatchGetRow dan BatchWriteRow, Anda harus memeriksa eksepsi dan memverifikasi status setiap baris. Pemanggilan API dianggap berhasil hanya jika semua baris diproses dengan sukses.

    Eksepsi

    Tablestore Java SDK mencakup dua jenis eksepsi, yaitu ClientException dan TableStoreException, keduanya merupakan turunan dari RuntimeException.

    • ClientException: Eksepsi internal SDK, seperti yang disebabkan oleh pengaturan parameter yang salah.

    • TableStoreException: Error sisi server yang dihasilkan dari penguraian pesan error dari server. Objek TableStoreException berisi anggota berikut:

      • getHttpStatus(): Kode respons HTTP, seperti 200 atau 404.

      • getErrorCode(): String kode kesalahan yang dikembalikan oleh Tablestore.

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

    Pengulangan

    • SDK secara otomatis mengulang operasi jika terjadi error. Secara default, SDK hanya mengulang operasi baca yang gagal akibat error throttling atau error internal sisi server. Kebijakan pengulangan default memiliki durasi maksimum pengulangan selama 10 detik.

    • Anda dapat menerapkan kebijakan pengulangan kustom dengan mewarisi kelas RetryStrategy, lalu meneruskan kebijakan kustom tersebut sebagai parameter saat membuat objek OTSClient.

    Kebijakan pengulangan berikut diimplementasikan dalam SDK:

    • DefaultRetryStrategy: Kebijakan pengulangan default. Hanya mengulang operasi baca. Interval pengulangan meningkat secara eksponensial mulai dari 10 ms, dengan durasi maksimum pengulangan 10 detik.

    • AlwaysRetryStrategy: Mengulang semua jenis permintaan hingga tiga kali. Interval pengulangan meningkat secara eksponensial mulai dari 4 ms, dengan interval maksimum 1 detik.