All Products
Search
Document Center

ApsaraDB for OceanBase (Deprecated):Tambahkan alamat akses

Last Updated:Apr 23, 2026

Topik ini menjelaskan cara menambahkan alamat akses dan melakukan operasi terkait lainnya.

Prinsip

ApsaraDB for OceanBase menyediakan lapisan proxy jaringan antara database dan aplikasi Anda. Anda dapat menambahkan alamat read-only atau alamat read/write splitting pada lapisan proxy untuk memanfaatkan sepenuhnya kemampuan multi-replika ApsaraDB for OceanBase, sehingga meningkatkan efisiensi eksekusi sistem bisnis Anda.

Pada ApsaraDB for OceanBase, read/write splitting berarti operasi baca dan tulis diproses oleh node yang berbeda guna meningkatkan kinerja baca/tulis serta ketersediaan database. Operasi tulis—yang biasanya melibatkan modifikasi dan pembaruan data—dilakukan pada node primary, sehingga menjamin konsistensi dan keandalan data serta mencegah korupsi dan kehilangan data, yang pada gilirannya meningkatkan keamanan dan stabilitas database. Sementara itu, operasi baca—yang hanya mengakses replika data—didistribusikan ke beberapa node standby untuk menerapkan pemrosesan paralel dan load balancing. Pendekatan ini mengurangi beban dan waktu respons database, sehingga meningkatkan pengalaman serta kepuasan pengguna. Untuk informasi selengkapnya, lihat Overview.

Konsep

  • Primary endpoint: Mendukung pembacaan dan penulisan data dengan strong consistency. Secara default, data dibaca menggunakan primary endpoint. Saat penyewa dibuat, primary endpoint secara otomatis dibuat dan diterapkan di zona primary pada lapisan proxy.

  • Alamat akses: Dapat berupa alamat read-only atau alamat read/write splitting.

  • Alamat read-only: Hanya mendukung operasi baca. Permintaan baca dikirim ke follower dari replika full-featured untuk menjamin konsistensi data akhir.

  • 只读副本访问地址:仅支持读操作,读请求发到只读副本,保证数据最终一致性。

  • Alamat Read/Write splitting: Mendukung operasi baca dan tulis. Permintaan tulis dikirim ke leader dari replika full-featured, sedangkan permintaan baca di luar transaksi dikirim ke follower untuk mengurangi beban pada leader sekaligus menjamin konsistensi data akhir.

  • Alamat Direct connection: Mendukung operasi baca dan tulis. Secara default, permintaan langsung diteruskan ke leader.

    Catatan
    • Secara umum, data yang diakses melalui alamat read-only tertinggal kurang dari 1 detik dibandingkan data yang diakses melalui primary endpoint yang sesuai.

    • Kami menyarankan Anda menggunakan primary endpoint, alamat read-only, atau alamat read/write splitting di lingkungan produksi.

    • Saat ini, layanan alamat direct connection hanya tersedia untuk pengguna dalam allowlist. Untuk mengaktifkan layanan ini, hubungi Dukungan Teknis ApsaraDB for OceanBase.

Batasan

  1. Batasan terkait alamat akses adalah sebagai berikut:

    • Anda tidak dapat menambahkan alamat akses untuk penyewa di instans standby.

    • Pada mode penyebaran single-IDC atau dual-IDC, hanya satu primary endpoint yang didukung di lapisan proxy, dan Anda hanya dapat menambahkan satu alamat read-only atau read/write splitting.

    • Pada mode penyebaran multi-IDC, hanya satu primary endpoint yang didukung di lapisan proxy, dan Anda dapat menambahkan paling banyak dua alamat read-only atau read/write splitting. Jika Anda memerlukan lebih banyak alamat, hubungi Dukungan Teknis ApsaraDB for OceanBase untuk mengajukan resource proxy dengan spesifikasi yang lebih tinggi.

  2. Batasan terkait alamat direct connection adalah sebagai berikut:

    • Alamat direct connection hanya dapat dibuat untuk penyewa ApsaraDB for OceanBase versi V4.2.1.2 atau yang lebih baru dengan hanya satu unit resource.

    • Saat ini, alamat direct connection hanya dapat digunakan untuk akses jaringan pribadi.

  3. Batasan versi untuk alamat read/write splitting adalah sebagai berikut:

    • Untuk kluster OceanBase Database V3.x, Anda hanya dapat mengaktifkan alamat read/write splitting jika versi OceanBase Database Proxy (ODP) berada dalam rentang V3.2.9 hingga V4.0.

    • Untuk kluster OceanBase Database V4.x, Anda hanya dapat mengaktifkan alamat read/write splitting jika versi ODP V4.1 atau yang lebih baru.

Prosedur

  1. Masuk ke Konsol ApsaraDB for OceanBase.

  2. Di panel navigasi kiri, klik Instances.

  3. Pada daftar instans, klik nama instans kluster target untuk membuka halaman Cluster Instance Workspace.

  4. Pada daftar penyewa, klik nama penyewa target untuk membuka halaman Tenant Workspace.

  5. Klik ikon More di pojok kanan atas, lalu pilih Add Access Address.

    Catatan

    Jika jumlah alamat akses untuk replika kluster telah mencapai ambang batas yang ditentukan, tombol Add Access Address tidak tersedia.

    1

  6. Tentukan tipe dan zona alamat, lalu klik OK.

    image

    Parameter

    Deskripsi

    Address Type

    Tipe alamat yang akan ditambahkan. Nilai yang valid:

    • Read-only

    • Read/Write Splitting

    • Direct Connect

    Catatan
    • Untuk penyewa dalam instans Edisi Standar (Key-Value), Anda hanya dapat menambahkan satu alamat read-only.

    Zone for Access URL

    Zona alamat tersebut. Untuk menambahkan alamat read-only, tentukan zona tempat alamat tersebut berada. Untuk menambahkan alamat read/write splitting, tentukan zona tempat data yang diakses oleh permintaan baca berada.

    • Jika Anda menambahkan alamat read-only atau read/write splitting, proxy alamat dan data yang diakses berada di zona yang sama, yaitu zona yang ditentukan.

    • Jika Anda menambahkan alamat direct connection, alamat tersebut harus berada di zona primary.

    Select Replica for Read Traffic Access

    • Berdasarkan Tipe Replika: Trafik diteruskan ke tipe replika yang Anda pilih. Jika Anda memilih beberapa replika dari tipe ini, trafik didistribusikan berdasarkan strategi load balancing yang ditentukan.

    • Berdasarkan Replika: Trafik diteruskan ke replika yang Anda pilih.

      Catatan

      Jika Anda memilih metode Based on Replica, Anda harus melakukan upgrade ODP ke V4.3.1 atau yang lebih baru. Untuk melakukan upgrade ODP, kirimkan tiket ke Dukungan Teknis OceanBase.

    Load Balancing Strategy

    • Prioritize Replica in the Same Zone: Mengakses replika di zona yang sama dengan ODP secara prioritas.

      Catatan

      Nilai ini hanya berlaku ketika Based on Replica Type dipilih untuk Select Replica for Read Traffic Access.

    • Automatic Balancing: Secara otomatis menyeimbangkan trafik di antara replika yang dipilih berdasarkan beban saat ini.

    • Custom weights: Memungkinkan Anda menyesuaikan bobot trafik untuk replika yang dipilih.

      Catatan

      Nilai ini hanya berlaku ketika Based on Replica dipilih untuk Select Replica for Read Traffic Access.

    Disaster Recovery Strategy

    • Saat Anda menetapkan strategi disaster recovery berdasarkan tipe replika, trafik baca secara otomatis diteruskan ke leader jika replika dari tipe yang dipilih tidak tersedia.

    • Saat Anda menetapkan strategi berdasarkan replika, trafik diteruskan ke replika disaster recovery yang dipilih jika replika yang ditentukan tidak tersedia. Trafik secara otomatis diseimbangkan di antara beberapa replika berdasarkan beban saat ini.

    Catatan

    Replika columnstore read-only tidak dapat menerima atau meneruskan trafik ke jenis replika lain. Oleh karena itu, strategi disaster recovery memiliki batasan.

    • Saat Based on Replica Type dipilih untuk Select Replica for Read Traffic Access dan read-only columnstore replica dipilih, fitur disaster recovery tidak tersedia.

    • Saat Based on Replica dipilih untuk Select Replica for Read Traffic Access dan read-only columnstore replica dipilih, Anda hanya dapat memilih replika columnstore read-only lain sebagai replika disaster recovery-nya. Saat Anda memilih replika selain replika columnstore read-only untuk trafik baca, Anda tidak dapat memilih replika columnstore read-only sebagai replika disaster recovery-nya.

    Primary Endpoint VPC

    VPC ODP.

    Penting

    Pilih VPC ODP, bukan VPC kluster atau penyewa.

    Jika tidak tersedia VPC yang sesuai, buat VPC sesuai petunjuk. Untuk informasi selengkapnya, lihat Apa itu VPC?

    Primary Endpoint vSwitch

    vSwitch ODP. Jika tidak tersedia vSwitch, buka Konsol VPC dan buat vSwitch.

    Consistency Level

    Nilai default adalah Eventual Consistency. Terdapat latensi replikasi data antara zona read-only dan zona primary. Hal ini dapat menyebabkan perbedaan waktu pada hasil kueri antara zona read-only dan zona primary. Hasil kueri ditentukan oleh latensi replikasi. Namun, data pada akhirnya akan konsisten.

    High Availability

    Layanan ODP diterapkan dengan arsitektur kluster dengan ketersediaan tinggi yang menyediakan kemampuan disaster recovery. Pada penyebaran dual-IDC, Anda dapat menentukan zona sebagai zona primary saat membuat alamat proxy. Secara default, zona lain berfungsi sebagai zona standby. Jika zona primary atau node primary dari alamat proxy mengalami kegagalan, sistem akan beralih ke zona standby.

    Load Balancing Policy

    Nilai default adalah Automatic scheduling based on load. Sistem memantau beban server secara real time dan secara otomatis mengarahkan permintaan baru ke server dengan beban lebih rendah untuk mencegah overload pada node mana pun. Untuk informasi selengkapnya, lihat Load balancing.

Operasi terkait

Aktifkan alamat IP publik

ApsaraDB for OceanBase memungkinkan Anda mengaktifkan alamat IP publik untuk primary endpoint dari instans penyewa dan instans serverless. Prosedur berikut menggunakan instans penyewa sebagai contoh:

  1. Masuk ke Konsol ApsaraDB for OceanBase.

  2. Di panel navigasi kiri, klik Instances.

  3. Pada daftar instans, klik nama instans kluster target untuk membuka halaman Cluster Instance Workspace.

  4. Di panel navigasi kiri, klik Tenant Management.

  5. Pada daftar penyewa, klik nama penyewa target untuk membuka halaman Tenant Workspace.

  6. Pada bagian Deployment Diagram, klik Activate pada kartu endpoint utama.

    image

  7. Pada kotak dialog yang muncul, klik OK.

  8. Setelah alamat IP publik diaktifkan, Anda perlu menambahkannya ke allowlist. Untuk informasi selengkapnya, lihat Buat allowlist.

Edit alamat akses

Catatan

Secara default, alamat akses berada di zona yang sama dengan kluster proxy. Untuk mengubah zona alamat akses, pilih Database Proxy > Change Configuration dan ubah zona node tersebut. Untuk informasi selengkapnya, lihat Kelola layanan database proxy.

  1. Masuk ke Konsol ApsaraDB for OceanBase.

  2. Di panel navigasi kiri, klik Instances.

  3. Pada halaman Instances, klik nama instans kluster target untuk membuka halaman Cluster Instance Workspace.

  4. Di panel navigasi kiri, klik Tenant Management untuk membuka halaman Tenant Management.

  5. Pada daftar penyewa, klik nama penyewa target untuk membuka halaman Tenant Workspace.

  6. Arahkan kursor ke kartu alamat target di bagian Deployment Diagram.

  7. Klik ikon Settings di pojok kanan atas kartu.

    image

  8. Pada halaman edit alamat akses, ubah informasi konfigurasi, lalu klik OK.

    image

Hapus alamat akses

  1. Masuk ke Konsol ApsaraDB for OceanBase.

  2. Di panel navigasi kiri, klik Instances.

  3. Pada halaman Instances, klik nama instans kluster target untuk membuka halaman Cluster Instance Workspace.

  4. Di panel navigasi kiri, klik Tenant Management untuk membuka halaman Tenant Management.

  5. Pada daftar penyewa, klik nama penyewa target untuk membuka halaman Tenant Workspace.

  6. Arahkan kursor ke kartu alamat target di bagian Deployment Diagram.

  7. Klik image di pojok kanan atas kartu.

    Catatan

    Setelah alamat akses dihapus, layanan terkait menjadi tidak tersedia. Sebelum menghapus alamat akses, pastikan semua permintaan akses ke alamat tersebut telah dihentikan.

Lihat informasi alamat proxy

  • Setelah Anda menambahkan alamat akses atau alamat direct connection, Anda dapat melihat informasi alamat tersebut di bagian deployment diagram pada halaman tenant workspace.

  • Anda dapat mengarahkan kursor ke kartu primary endpoint, alamat akses, atau alamat direct connection untuk melihat alamat pribadi lengkap. Di pojok kanan atas kartu, Anda dapat mengklik ikon Set untuk mengedit alamat akses atau alamat direct connection, serta mengklik ikon Delete untuk menghapus alamat tersebut.

  • Anda dapat mengklik ikon Copy di samping alamat pribadi untuk menyalin alamat tersebut.

  • Anda dapat mengklik ikon Edit di samping Maximum Connections untuk mengubah jumlah maksimum koneksi ke alamat yang sesuai.

  • Anda dapat mengklik Activate untuk mengaktifkan alamat publik pada primary endpoint pribadi.

    image