Cara membuat dan mengelola replika baca di Azure Database for MySQL menggunakan Azure CLI dan REST API

  • Artikel

BERLAKU UNTUKAzure Database for MySQL - Server Tunggal

Penting

Server tunggal Azure Database for MySQL berada di jalur penghentian. Kami sangat menyarankan Agar Anda meningkatkan ke server fleksibel Azure Database for MySQL. Untuk informasi selengkapnya tentang migrasi ke server fleksibel Azure Database for MySQL, lihat Apa yang terjadi pada Server Tunggal Azure Database for MySQL?

Dalam artikel ini, Anda akan mempelajari cara membuat dan mengelola replika baca di layanan Azure Database for MySQL menggunakan Azure CLI dan REST API. Untuk mempelajari selengkapnya tentang replika baca, lihat gambaran umum.

Azure CLI

Anda dapat membuat dan mengelola replika baca menggunakan Azure CLI.

Prasyarat

Penting

Fitur replika baca hanya tersedia untuk server Azure Database for MySQL di tingkat harga Tujuan Umum atau Memori yang Dioptimalkan. Pastikan server sumber berada di salah satu tingkat harga tersebut.

Buat replika baca

Penting

Jika server sumber Anda tidak memiliki server replika yang ada, server sumber mungkin memerlukan restart untuk mempersiapkan diri untuk replikasi tergantung pada penyimpanan yang digunakan (v1/v2). Harap pertimbangkan hidupkan ulang server dan lakukan operasi ini selama jam-jam sibuk. Lihat Memulai ulang Server Sumber untuk detail selengkapnya.

Jika GTID diaktifkan di server utama (gtid_mode = AKTIF), replika yang baru dibuat juga akan mengaktifkan GTID dan menggunakan replikasi berbasis GTID. Untuk mempelajari selengkapnya, lihat Pengidentifikasi transaksi global (GTID)

Server replika baca dapat dibuat menggunakan perintah berikut:

az mysql server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup

Perintah az mysql server replica create memerlukan parameter berikut:

Pengaturan Contoh nilai Deskripsi
grup sumber daya  myresourcegroup  Grup sumber daya tempat server replika akan dibuat. 
nama mydemoreplicaserver Nama server replika baru yang dibuat.
source-server mydemoserver Nama atau ID dari server sumber yang ada untuk direplikasi.

Untuk membuat replika baca lintas wilayah, gunakan parameter --location. Contoh CLI di bawah ini membuat replika di US Barat.

az mysql server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup --location westus

Catatan

Untuk mempelajari selengkapnya tentang wilayah yang dapat digunakan untuk membuat replika, kunjungi artikel konsep replika baca.

Catatan

  • Perintah az mysql server replica create memiliki argumen --sku-name yang memungkinkan Anda menentukan sku ({pricing_tier}_{compute generation}_{vCores}) saat Anda membuat replika menggunakan Azure CLI.
  • Server utama dan replika baca harus berada pada tingkat harga yang sama (Tujuan Umum atau Memori Dioptimalkan).
  • Konfigurasi server replika juga dapat diubah setelah dibuat. Konfigurasi server replika direkomendasikan untuk disimpan dengan nilai yang setara atau lebih besar daripada sumber untuk memastikan bahwa replika dapat mengimbangi master.

Membuat daftar replika untuk server sumber

Untuk menampilkan semua replika atas server sumber tertentu, jalankan perintah berikut:

az mysql server replica list --server-name mydemoserver --resource-group myresourcegroup

Perintah az mysql server replica list memerlukan parameter berikut:

Pengaturan Contoh nilai Deskripsi
grup sumber daya  myresourcegroup  Grup sumber daya tempat server replika akan dibuat. 
nama server mydemoserver Nama atau ID server sumber.

Menghentikan replikasi ke server replika

Penting

Menghentikan replikasi ke server tidak dapat dibatalkan. Setelah replikasi berhenti antara sumber dan replika, penghentian tersebut tidak dapat dibatalkan. Server replika kemudian menjadi server mandiri dan sekarang mendukung baca dan tulis. Server ini tidak dapat dijadikan replika lagi.

Replikasi ke server replika baca dapat dihentikan menggunakan perintah berikut:

az mysql server replica stop --name mydemoreplicaserver --resource-group myresourcegroup

Perintah az mysql server replica stop memerlukan parameter berikut:

Pengaturan Contoh nilai Deskripsi
grup sumber daya  myresourcegroup  Grup sumber daya tempat server replika berada. 
nama mydemoreplicaserver Nama server replika untuk menghentikan replikasi.

Menghapus server replika

Menghapus server replika baca dapat dilakukan dengan menjalankan perintah az mysql server delete.

az mysql server delete --resource-group myresourcegroup --name mydemoreplicaserver

Menghapus server sumber

Penting

Menghapus server sumber akan menghentikan replikasi untuk semua server replika dan menghapus server sumber itu sendiri. Server replika menjadi server mandiri yang kini mendukung baca dan tulis.

Untuk menghapus server sumber, Anda dapat menjalankan perintah az mysql server delete.

az mysql server delete --resource-group myresourcegroup --name mydemoserver

REST API

Anda dapat membuat dan mengelola replika baca menggunakan Azure REST API.

Buat replika baca

Anda dapat membuat replika baca dengan menggunakan buat API:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/servers/{replicaName}?api-version=2017-12-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Replica",
    "sourceServerId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/servers/{masterServerName}"
  }
}

Catatan

Untuk mempelajari selengkapnya tentang wilayah yang dapat digunakan untuk membuat replika, kunjungi artikel konsep replika baca.

Replika dibuat dengan menggunakan pengaturan komputasi dan penyimpanan yang sama dengan master. Setelah replika dibuat, beberapa pengaturan dapat diubah secara independen dari server sumber: pembuatan komputasi, vCore, penyimpanan, dan periode retensi cadangan. Tingkat harga juga dapat diubah secara independen, kecuali ke atau dari tingkat Dasar.

Penting

Sebelum pengaturan server sumber diperbarui ke nilai baru, perbarui pengaturan replika ke nilai yang sama atau lebih besar. Tindakan ini membantu replika mengikuti perubahan yang dibuat pada master.

Daftar replika

Anda dapat menampilkan daftar replika server sumber menggunakan API daftar replika:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/servers/{masterServerName}/Replicas?api-version=2017-12-01

Menghentikan replikasi ke server replika

Anda dapat menghentikan replikasi antara server sumber dan replika baca menggunakan API pembaruan.

Setelah Anda menghentikan replikasi ke server sumber dan replika baca, ini tidak dapat dibatalkan. Replika baca menjadi server mandiri yang mendukung operasi baca dan tulis. Server mandiri tidak dapat dibuat menjadi replika lagi.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/servers/{masterServerName}?api-version=2017-12-01

{
  "properties": {
    "replicationRole":"None"  
   }
}

Menghapus server replika atau sumber

Untuk menghapus server replika atau sumber, gunakan API penghapusan:

Saat Anda menghapus server sumber, replikasi ke semua replika baca dihentikan. Replika baca menjadi server mandiri yang sekarang mendukung baca dan tulis.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/servers/{serverName}?api-version=2017-12-01

Masalah yang diketahui

Ada dua generasi penyimpanan yang digunakan server dalam penggunaan tingkat Tujuan Umum dan Memori yang Dioptimalkan, Penyimpanan tujuan umum v1 (Mendukung hingga 4-TB) & Penyimpanan tujuan umum v2 (Mendukung penyimpanan hingga 16-TB). Server sumber dan server replika harus memiliki jenis penyimpanan yang sama. Karena Penyimpanan tujuan umum v2 tidak tersedia di semua wilayah, pastikan Anda memilih wilayah replika yang benar saat Anda menggunakan lokasi dengan CLI atau REST API untuk pembuatan replika baca. Tentang cara mengidentifikasi jenis penyimpanan server sumber Anda, lihat tautan Bagaimana cara menentukan jenis penyimpanan tempat server saya berjalan.

Jika Anda memilih wilayah di mana Anda tidak dapat membuat replika baca untuk server sumber Anda, Anda akan mengalami masalah di mana penerapan akan terus berjalan seperti yang ditunjukkan pada gambar di bawah dan kemudian akan habis waktu dengan kesalahan "Operasi penyediaan sumber daya tidak selesai dalam batas waktu yang diizinkan.”

Read replica cli error.

Langkah berikutnya