All Products
Search

This Product

    :Ubah bobot baca dan ambang batas latensi

    Document Center

    :Ubah bobot baca dan ambang batas latensi

    Last Updated:May 26, 2026

    Anda dapat memanggil operasi ModifyReadWriteSplittingConnection untuk mengubah ambang batas latensi yang diizinkan oleh tautan pemisahan baca/tulis serta bobot baca dari instans utama dan instans hanya-bacanya.

    Sebelum memanggil operasi ini, pastikan persyaratan berikut terpenuhi:

    • Fitur shared proxy telah diaktifkan untuk instans ApsaraDB RDS for MySQL Anda.
    • Fitur pemisahan baca/tulis telah diaktifkan untuk instans ApsaraDB RDS for MySQL Anda.
    • Instans harus menjalankan salah satu versi mesin database dan edisi RDS berikut:
      • MySQL 5.7 pada RDS High-availability Edition (dengan SSD lokal)
      • MySQL 5.6
      • SQL Server pada RDS Cluster Edition

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

    Parameter permintaan

    Parameter Type Required Example Description
    Action String Yes ModifyReadWriteSplittingConnection

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyReadWriteSplittingConnection.

    DBInstanceId String Yes rm-uf6wjk5xxxxxxx

    ID instans utama.

    ConnectionStringPrefix String No rm-m5xxxxxxxxrw.mysql.rds.aliyuncs.com

    Awalan titik akhir pemisahan baca/tulis. Awalan harus unik, panjangnya maksimal 30 karakter, dan hanya boleh berisi huruf kecil serta tanda hubung (-). Awalan harus dimulai dengan huruf kecil.

    Catatan Awalan default terdiri dari nama instans utama diikuti oleh huruf rw.
    Port String No 3306

    Port yang dikaitkan dengan titik akhir pemisahan baca/tulis.

    MaxDelayTime String No 12

    Ambang batas latensi yang diizinkan oleh tautan pemisahan baca/tulis. Satuan: detik. Jika latensi pada instansi hanya baca melebihi ambang batas yang ditentukan, ApsaraDB RDS tidak lagi mengarahkan permintaan baca ke instansi hanya baca tersebut. Jika Anda tidak menentukan parameter ini, nilai default akan tetap digunakan.

    Catatan
    • Jika instans utama menjalankan SQL Server 2017 pada RDS Cluster Edition, parameter MaxDelayTime tidak didukung.
    • Anda harus menentukan setidaknya salah satu dari parameter berikut: MaxDelayTime dan DistributionType.
    DistributionType String No Standard

    Metode yang digunakan untuk menetapkan bobot baca. Nilai yang valid:

    • Standard: ApsaraDB RDS secara otomatis menetapkan bobot baca untuk setiap instans berdasarkan spesifikasi instans.
    • Custom: Anda harus menetapkan secara manual bobot baca untuk setiap instans.
    Catatan Anda harus menentukan setidaknya salah satu dari parameter berikut: MaxDelayTime dan DistributionType.
    Weight String No {"rm-bp1**********":800,"master":400,"slave":400}

    Bobot baca dari instans utama dan instansi hanya bacanya. Bobot baca harus merupakan kelipatan 100 dan tidak boleh melebihi 10000.

    • Format untuk instans RDS: {"<Read-only instance ID>":<Weight>,"master":<Weight>,"slave":<Weight>}
    • Format untuk instans ApsaraDB MyBase: [{"instanceName":"<Primary instance ID>","weight":<Weight>,"role":"master"},{"instanceName":"<Primary instance ID>","weight":<Weight>,"role":"slave"},{"instanceName":"<Read-only instance ID>","weight":<Weight>,"role":"master"}]
    Catatan
    • Parameter ini wajib ditentukan jika Anda menetapkan parameter DistributionType ke Custom.
    • Parameter ini tidak berlaku jika Anda menetapkan parameter DistributionType ke Standard.

    Parameter respons

    Parameter Type Example Description
    RequestId String 5A77D650-27A1-4E08-AD9E-59008EDB6927

    ID permintaan.

    Contoh

    Contoh permintaan

    http(s)://rds.aliyuncs.com/?Action=ModifyReadWriteSplittingConnection
&DistributionType=Standard
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

    Contoh respons sukses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<ModifyReadWriteSplittingConnectionResponse>
	<RequestID>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestID>
</ModifyReadWriteSplittingConnectionResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestID" : "5A77D650-27A1-4E08-AD9E-59008EDB6927"
}

    Kode kesalahan

    HTTP status code Error code Error message Description
    400 ReadUniformNetTypeNotExists The specified uniform read only network type does not exist. Pesan kesalahan yang dikembalikan karena jenis jaringan unified untuk instansi hanya baca yang Anda tentukan tidak ditemukan.
    400 ReadDBInstance.NotFound The Current DB Instance has not read-only instance. Pesan kesalahan yang dikembalikan karena tidak ada instansi hanya baca yang disambungkan ke instans tersebut.
    403 ReadDBInstance.NotFound The current database instance does not contain any read only instance. Pesan kesalahan yang dikembalikan karena tidak ada instansi hanya baca yang disambungkan ke instans tersebut.

    Untuk daftar kode kesalahan, kunjungi API Error Center.