Tutorial: Bermigrasi dari Azure Database for PostgreSQL - Server Tunggal ke Server Fleksibel dengan layanan migrasi

BERLAKU UNTUK: Azure Database for PostgreSQL - Server Fleksibel

Dengan menggunakan portal Azure, Anda dapat memigrasikan instans Azure Database for PostgreSQL – Server Tunggal ke Azure Database for PostgreSQL – Server Fleksibel. Dalam tutorial ini, kami melakukan migrasi database sampel dari server tunggal Azure Database for PostgreSQL ke server fleksibel PostgreSQL menggunakan portal Azure.

• Mengonfigurasi Server Fleksibel Azure Database for PostgreSQL Anda
• Mengonfigurasi tugas migrasi
• Memantau migrasi
• Membatalkan migrasi
• Pascamigrasi

Portal

Anda dapat bermigrasi menggunakan portal Azure.

Luring

Prasyarat (offline)

Sebelum memulai migrasi dengan layanan migrasi di Azure Database for PostgreSQL, Anda harus memenuhi prasyarat berikut, yang berlaku untuk skenario migrasi offline.

Memverifikasi versi sumber

Versi PostgreSQL sumber harus >= 9.5. Jika versi PostgreSQL sumber kurang dari 9.5, tingkatkan versi PostgreSQL sumber ke 9.5 atau yang lebih tinggi sebelum migrasi.

Penyiapan target

• Server fleksibel Azure Database for PostgreSQL harus disebarkan dan dikonfigurasi dengan benar di Azure sebelum Anda memulai proses migrasi.

• SKU yang dipilih untuk Azure Database for PostgreSQL harus sesuai dengan spesifikasi database sumber untuk memastikan kompatibilitas dan performa yang memadai.

• Untuk instruksi terperinci tentang membuat Azure Database for PostgreSQL baru, lihat tautan berikut: Mulai Cepat: Membuat server.

Penyiapan jaringan

Penyiapan jaringan sangat penting agar layanan migrasi berfungsi dengan benar. Pastikan bahwa server PostgreSQL sumber dapat berkomunikasi dengan server Azure Database for PostgreSQL target. Konfigurasi jaringan berikut sangat penting untuk keberhasilan migrasi.

Untuk informasi tentang penyiapan jaringan, kunjungi Panduan jaringan untuk layanan migrasi.

Mengaktifkan ekstensi

Untuk memastikan keberhasilan migrasi dengan layanan migrasi di Azure Database for PostgreSQL, Anda mungkin perlu memverifikasi ekstensi ke instans PostgreSQL sumber Anda. Ekstensi menyediakan fungsionalitas dan fitur tambahan yang mungkin diperlukan untuk aplikasi Anda. Pastikan untuk memverifikasi ekstensi pada instans PostgreSQL sumber sebelum memulai proses migrasi.

Aktifkan ekstensi yang didukung yang diidentifikasi dalam instans PostgreSQL sumber pada server fleksibel Azure Database for PostgreSQL target.

Untuk informasi selengkapnya tentang ekstensi, kunjungi Ekstensi di Azure Database for PostgreSQL.

Catatan

Hidupkan ulang diperlukan ketika ada perubahan pada shared_preload_libraries parameter .

Periksa parameter server

Parameter ini tidak secara otomatis dimigrasikan ke lingkungan target dan harus dikonfigurasi secara manual.

• Cocokkan nilai parameter server dari database PostgreSQL sumber ke Azure Database for PostgreSQL dengan mengakses bagian Parameter server di portal Azure dan memperbarui nilai secara manual yang sesuai.

• Simpan perubahan parameter dan, jika perlu, mulai ulang server fleksibel Azure Database for PostgreSQL untuk menerapkan konfigurasi baru.

Nonaktifkan ketersediaan tinggi (keandalan) dan replika baca dalam target

• Menonaktifkan ketersediaan tinggi (keandalan) dan replika baca di lingkungan target sangat penting. Fitur-fitur ini harus diaktifkan hanya setelah migrasi selesai.

• Dengan mengikuti panduan ini, Anda dapat membantu memastikan proses migrasi yang lancar tanpa variabel tambahan yang diperkenalkan oleh ketersediaan tinggi dan replika baca. Setelah migrasi selesai dan database stabil, Anda dapat melanjutkan untuk mengaktifkan fitur-fitur ini untuk meningkatkan ketersediaan dan skalabilitas lingkungan database Anda di Azure.

Mengonfigurasi server fleksibel Azure Database for PostgreSQL Anda

• Buat server fleksibel target. Untuk langkah-langkah terpandu, lihat mulai cepat Membuat server fleksibel Azure Database for PostgreSQL menggunakan portal.

• Ekstensi daftar izin yang pustakanya harus dimuat pada awal server. Sangat penting bahwa ekstensi ada di daftar yang diizinkan sebelum Anda memulai migrasi.

• Periksa apakah distribusi data di antara tabel database condong, dengan sebagian besar data ada dalam satu (atau beberapa) tabel. Jika miring, kecepatan migrasi bisa lebih lambat dari yang diharapkan. Dalam hal ini, kecepatan migrasi dapat ditingkatkan dengan memigrasikan tabel besar secara paralel.

Mengonfigurasi tugas migrasi

Layanan migrasi dilengkapi dengan pengalaman sederhana berbasis wizard pada portal Azure. Berikut cara untuk memulainya:

1. Buka browser web Anda, dan buka portal. Untuk masuk, masukkan kredensial Anda. Tampilan default adalah dasbor layanan Anda.

2. Buka target Server Fleksibel Azure Database for PostgreSQL Anda.

3. Di tab Gambaran Umum Server Fleksibel, di menu sebelah kiri, gulir ke bawah ke Migrasi dan pilih.

   

4. Pilih tombol Buat untuk memulai migrasi dari satu server ke server fleksibel. Jika ini pertama kalinya Anda menggunakan layanan migrasi, kisi kosong muncul dengan perintah untuk memulai migrasi pertama Anda.

   

   Jika Anda telah membuat migrasi ke target Server Fleksibel, kisi berisi informasi tentang migrasi yang dicoba ke target ini dari Server Tunggal.

5. Anda melalui serangkaian tab berbasis wizard untuk membuat migrasi ke target Server Fleksibel ini dari berbagai sumber yang mungkin. Secara default, Jenis server sumber diatur ke Server Tunggal Azure Database for PostgreSQL, yang merupakan salah satu yang kami minati dalam skenario ini.

Atau, Anda dapat memulai proses migrasi dari Server Tunggal Azure Database for PostgreSQL.

1. Buka browser web Anda, dan buka portal. Untuk masuk, Anda harus memasukkan kredensial Anda. Tampilan default adalah dasbor layanan Anda.

2. Setelah memilih Server Tunggal, Anda dapat mengamati banner terkait migrasi di tab Gambaran Umum. Pilih Migrasi sekarang untuk memulai.

   

3. Anda dibawa ke halaman dengan dua opsi. Jika Anda telah membuat Server Fleksibel dan ingin menggunakannya sebagai target, pilih Pilih yang sudah ada, dan pilih detail Langganan, Grup sumber daya, dan Nama server yang sesuai. Setelah pilihan dibuat, pilih Buka wizard migrasi dan ikuti instruksi di bawah bagian Penyetelan .

   

4. Jika Anda memilih untuk membuat Server Fleksibel baru, pilih Buat baru dan pilih Buka untuk membuat wizard. Tindakan ini membawa Anda melalui proses pembuatan Server Fleksibel dan menyebarkan Server Fleksibel.

   

Setelah menyebarkan Server Fleksibel, ikuti langkah 3 hingga 5 di bawah Konfigurasikan tugas migrasi.

Siapkan

Tab pertama adalah Penyetelan. Jika Anda melewatkannya, izinkan ekstensi yang diperlukan seperti yang dijelaskan dalam Mengonfigurasi server fleksibel Azure Database for PostgreSQL Anda, sebelum Anda memulai migrasi.

Nama migrasi adalah pengidentifikasi unik untuk setiap migrasi ke Server Fleksibel ini. Bidang ini hanya menerima karakter alfanumerik dan tidak menerima karakter khusus kecuali garis bawah (_) dan tanda hubung (-). Nama harus dimulai dengan karakter alfanumerik. Nama ini juga harus unik untuk server target, karena tidak ada dua migrasi ke target Server Fleksibel yang sama yang dapat memiliki nama yang sama.

Jenis server sumber menunjukkan sumbernya. Dalam hal ini, ini adalah Server Tunggal Azure Database for PostgreSQL

Opsi migrasi memungkinkan Anda melakukan validasi sebelum memicu migrasi. Anda dapat memilih salah satu opsi berikut.

• Validasi - Memeriksa kesiapan server dan database Anda untuk migrasi ke target.
• Migrasi - Melewati validasi dan memulai migrasi.
• Validasi dan Migrasi - Melakukan validasi sebelum memicu migrasi. Migrasi dipicu hanya jika tidak ada kegagalan validasi.

Selalu merupakan praktik yang baik untuk memilih opsi Validasi atau Validasi dan Migrasi untuk melakukan validasi pramigrasi sebelum menjalankan migrasi.

Mode migrasi memungkinkan Anda memilih antara migrasi online dan offline, dalam hal ini harus diatur ke Offline.

Pilih tombol Berikutnya: Pilih Server Runtime.

Runtime Server

Migration Runtime Server adalah fitur khusus dalam layanan migrasi di Azure Database for PostgreSQL, yang dirancang untuk bertindak sebagai server perantara selama migrasi. Ini adalah instans Azure Database for PostgreSQL - Server Fleksibel terpisah yang bukan server target tetapi digunakan untuk memfasilitasi migrasi database dari lingkungan sumber yang hanya dapat diakses melalui jaringan privat.

Untuk informasi selengkapnya tentang Server Runtime, kunjungi Server Runtime Migrasi.

Pilih tombol Berikutnya: Sambungkan ke sumber .

Sambungkan ke sumber

Bagian Sumber meminta Anda untuk memberikan detail yang terkait dengan Server Tunggal, yang merupakan sumber database.

Setelah Anda membuat pilihan Langganan dan Grup Sumber Daya, daftar dropdown untuk nama server menampilkan Server Tunggal di bawah grup sumber daya tersebut di seluruh wilayah. Pilih sumber yang ingin Anda migrasikan databasenya. Anda dapat memigrasikan database dari Server Tunggal ke Server Fleksibel target di wilayah yang sama. Migrasi lintas wilayah hanya diaktifkan untuk server India, Tiongkok, dan UEA.

Setelah Anda memilih sumber Server Tunggal, kotak Lokasi, dan versi PostgreSQL diisi secara otomatis. Pastikan Anda memberikan kredensial peran admin, karena itu diperlukan agar layanan migrasi berhasil memigrasikan database.

Setelah mengisi semua bidang, pilih tautan Sambungkan ke sumber . Ini memvalidasi bahwa detail server sumber yang dimasukkan sudah benar dan server sumber dapat dijangkau.

Pilih tombol Berikutnya: Pilih target migrasi untuk melanjutkan.

Pilih target migrasi

Bagian Pilih target migrasi menampilkan metadata untuk target Server Fleksibel, seperti Langganan, Grup sumber daya, Nama server, Lokasi, dan versi PostgreSQL.

Pilih nilai yang sesuai untuk metode Autentikasi dan semua bidang terkait autentikasi. Pastikan bahwa identitas yang disediakan adalah pengguna administrator di server target. Setelah mengisi semua informasi yang diperlukan, pilih tautan Sambungkan ke target . Ini memvalidasi bahwa detail server target yang dimasukkan sudah benar dan server target dapat dijangkau.

Pilih tombol Berikutnya: Pilih database untuk migrasi untuk memilih database yang akan dimigrasikan.

Pilih database untuk migrasi

Di bawah tab ini, ada daftar database pengguna di dalam Server Tunggal. Anda dapat memilih dan memigrasikan hingga delapan database dalam satu upaya migrasi. Jika ada lebih dari delapan database pengguna, proses migrasi diulang antara server sumber dan target untuk kumpulan database berikutnya. Database yang dipilih yang ada di server target dengan nama yang sama persis ditimpa.

Pilih tombol Berikutnya: Ringkasan untuk meninjau detailnya.

Ringkasan

Tab Ringkasan meringkas semua detail untuk membuat validasi atau migrasi. Tinjau detail dan pilih tombol Mulai Validasi dan Migrasi .

Memantau portal migrasi

Setelah Anda memulai migrasi, pemberitahuan tampaknya mengatakan bahwa validasi atau pembuatan migrasi berhasil. Anda dialihkan secara otomatis ke halaman Migrasi Server Fleksibel. Ini memiliki entri baru untuk validasi atau migrasi yang baru dibuat.

Kisi yang menampilkan migrasi memiliki kolom ini: Nama, Status, Mode migrasi, Jenis migrasi, Server sumber, Jenis server sumber, Database, Waktu mulai, dan Durasi. Entri ditampilkan dalam urutan menurun dari waktu mulai dengan entri terbaru di bagian atas.

Anda dapat menggunakan tombol Refresh untuk me-refresh status validasi atau migrasi.

Anda juga dapat memilih nama satu migrasi tertentu di kisi untuk melihat detail terkait.

Saat validasi atau migrasi dibuat, validasi atau migrasi berpindah ke status InProgress dan substat PerformingPreRequisiteSteps . Alur kerja membutuhkan waktu 2-3 menit untuk menyiapkan infrastruktur migrasi dan koneksi jaringan.

Mari kita lihat cara memantau migrasi untuk setiap opsi migrasi.

Memvalidasi

Setelah substat PerformingPreRequisiteSteps selesai, validasi berpindah ke substat Validasi sedang Berlangsung di mana pemeriksaan dilakukan pada server sumber dan target untuk menilai kesiapan migrasi.

Validasi berpindah ke status Berhasil jika semua validasi berada dalam status Berhasil atau Peringatan .

Kisi validasi memiliki informasi berikut:

• Detail validasi untuk instans dan Detail validasi untuk bagian database, mewakili aturan validasi yang digunakan untuk memeriksa kesiapan migrasi.
• Nama Validasi - Nama setiap aturan validasi tertentu.
• Status Validasi - Mewakili hasil untuk setiap aturan dan dapat memiliki salah satu dari tiga nilai:
  • Berhasil - Jika tidak ada kesalahan yang ditemukan.
  • Gagal - Jika ada kesalahan validasi.
  • Peringatan - Jika ada peringatan validasi.
• Durasi - Waktu yang diperlukan untuk operasi validasi.
• Waktu mulai (UTC) dan Waktu akhir (UTC) - Waktu mulai dan berakhir dari operasi validasi di UTC.

Status Validasi berpindah ke status Gagal jika ada kesalahan dalam validasi. Pilih validasi Nama validasi atau Nama database yang gagal, dan panel fan-out memberikan detail dan tindakan korektif yang harus Anda ambil untuk menghindari kesalahan ini.

Migrate

Setelah substat PerformingPreRequisiteSteps selesai, migrasi berpindah ke substat Migrasi Data saat kloning/penyalinan database berlangsung. Waktu migrasi selesai tergantung pada ukuran dan bentuk database yang Anda migrasikan. Migrasi cepat jika data sebagian besar didistribusikan secara merata di semua tabel. Ukuran tabel condong membutuhkan waktu yang relatif lebih lama.

Saat Anda memilih salah satu database dalam migrasi, panel fan-out akan muncul. Ini memiliki semua jumlah tabel (disalin, diantrekan, disalin, dan kesalahan) dan juga status migrasi database.

Migrasi berpindah ke status Berhasil saat status Migrasi Data berhasil diselesaikan. Jika ada masalah pada status Migrasi Data, migrasi berpindah ke status Gagal.

Setelah migrasi berpindah ke status Berhasil , skema, dan migrasi data dari Server Tunggal Anda ke target Server Fleksibel Anda selesai. Anda dapat menyegarkan halaman untuk memeriksa kemajuan.

Memvalidasi dan Memigrasikan

Dalam opsi ini, validasi dilakukan terlebih dahulu sebelum migrasi dimulai. Setelah substat PerformingPreRequisiteSteps selesai, alur kerja berpindah ke substat Validasi sedang Berlangsung.

• Jika validasi memiliki kesalahan, migrasi akan berpindah ke status Gagal .
• Jika validasi selesai tanpa kesalahan apa pun, migrasi dimulai, dan alur kerja berpindah ke substat Migrasi Data.

Anda dapat melihat hasil Validasi dan Migrasi setelah operasi selesai.

Online

Prasyarat (online)

Sebelum Anda memulai migrasi dengan layanan migrasi di Azure Database for PostgreSQL, memenuhi prasyarat berikut, yang berlaku untuk skenario migrasi offline sangat penting.

Memverifikasi versi sumber

Versi PostgreSQL sumber harus >= 9.5. Jika versi PostgreSQL sumber kurang dari 9.5, tingkatkan versi PostgreSQL sumber ke 9.5 atau yang lebih tinggi sebelum migrasi.

Menyiapkan parameter migrasi online

Untuk Migrasi online, dukungan replikasi harus diatur ke Logis di bawah pengaturan replikasi server PostgreSQL sumber. Selain itu, parameter max_wal_senders dan max_replication_slots nilai server harus lebih dari jumlah Database yang perlu dimigrasikan. Parameter dapat diatur dalam portal Azure di bawah Parameter Pengaturan-Server> atau dikonfigurasi di baris perintah menggunakan perintah berikut:

• ALTER SYSTEM SET wal_level = logis;
• ALTER SYSTEM SET max_wal_senders = number of databases to migrate + 1;
• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Pastikan bahwa tidak ada transaksi yang berjalan lama. Transaksi yang berjalan lama tidak memungkinkan pembuatan slot replikasi. Pembuatan slot replikasi akan berhasil jika semua transaksi yang berjalan lama diterapkan atau digulung balik. Anda harus memulai ulang server PostgreSQL sumber setelah menyelesaikan semua prasyarat migrasi Online.

Catatan

Untuk migrasi online dengan server tunggal Azure Database for PostgreSQL, dukungan replikasi Azure diatur ke logis di bawah pengaturan replikasi halaman server tunggal di portal Azure.

Untuk mencegah migrasi Online kehabisan penyimpanan untuk menyimpan log, pastikan Anda memiliki ruang tabel yang memadai menggunakan disk terkelola yang disediakan. Untuk mencapai hal ini, nonaktifkan parameter azure.enable_temp_tablespaces_on_local_ssd server di Server Fleksibel selama durasi migrasi, dan pulihkan ke status asli setelah migrasi.

Menyiapkan target

• Azure Database for PostgreSQL harus disiapkan di Azure sebelum migrasi.

• SKU yang dipilih untuk Azure Database for PostgreSQL harus sesuai dengan spesifikasi database sumber untuk memastikan kompatibilitas dan performa yang memadai.

• Untuk instruksi terperinci tentang membuat Azure Database for PostgreSQL baru, lihat tautan berikut: Mulai Cepat: Membuat server.

• Parameter max_replication_slots server harus lebih dari jumlah Database yang perlu dimigrasikan. Ini dapat diatur dalam portal Azure di bawah Parameter Pengaturan-Server> atau dikonfigurasi di baris perintah menggunakan perintah berikut:

• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Menyiapkan Jaringan

Penyiapan jaringan sangat penting agar layanan migrasi berfungsi dengan benar. Pastikan bahwa server PostgreSQL sumber dapat berkomunikasi dengan server Azure Database for PostgreSQL target. Konfigurasi jaringan berikut sangat penting untuk keberhasilan migrasi.

Untuk informasi tentang penyiapan jaringan, kunjungi Panduan jaringan untuk layanan migrasi.

Mengaktifkan ekstensi

Untuk memastikan keberhasilan migrasi dengan layanan migrasi di Azure Database for PostgreSQL, Anda mungkin perlu memverifikasi ekstensi ke instans PostgreSQL sumber Anda. Ekstensi menyediakan fungsionalitas dan fitur tambahan yang mungkin diperlukan untuk aplikasi Anda. Pastikan untuk memverifikasi ekstensi pada instans PostgreSQL sumber sebelum memulai proses migrasi.

Aktifkan ekstensi yang didukung yang diidentifikasi dalam instans PostgreSQL sumber pada server fleksibel Azure Database for PostgreSQL target.

Untuk informasi selengkapnya tentang ekstensi, kunjungi Ekstensi di Azure Database for PostgreSQL.

Catatan

Hidupkan ulang diperlukan ketika ada perubahan pada shared_preload_libraries parameter .

Parameter server

Parameter ini tidak secara otomatis dimigrasikan ke lingkungan target dan harus dikonfigurasi secara manual.

• Cocokkan nilai parameter server dari database PostgreSQL sumber ke Azure Database for PostgreSQL dengan mengakses bagian "Parameter server" di portal Azure dan memperbarui nilai secara manual.

• Simpan perubahan parameter dan mulai ulang Azure Database for PostgreSQL untuk menerapkan konfigurasi baru jika perlu.

Nonaktifkan ketersediaan tinggi (keandalan) dan replika baca dalam target

• Menonaktifkan ketersediaan tinggi (keandalan) dan membaca replika di lingkungan target sangat penting. Fitur-fitur ini harus diaktifkan hanya setelah migrasi selesai.

• Dengan mengikuti panduan ini, Anda dapat membantu memastikan proses migrasi yang lancar tanpa variabel tambahan yang diperkenalkan oleh Ha dan Replika Baca. Setelah migrasi selesai dan database stabil, Anda dapat melanjutkan untuk mengaktifkan fitur-fitur ini untuk meningkatkan ketersediaan dan skalabilitas lingkungan database Anda di Azure.

Catatan

Batasan tertentu berlaku untuk Migrasi online yang didokumenkan di sini. Pastikan database Anda sesuai untuk menjalankan migrasi Online.

Mengonfigurasi server fleksibel Azure Database for PostgreSQL Anda

• Buat server fleksibel target. Untuk langkah-langkah terpandu, lihat mulai cepat Membuat server fleksibel Azure Database for PostgreSQL menggunakan portal.

• Ekstensi daftar izin yang pustakanya harus dimuat pada awal server. Sangat penting bahwa ekstensi ada di daftar yang diizinkan sebelum Anda memulai migrasi.

• Periksa apakah distribusi data di antara tabel database condong, dengan sebagian besar data ada dalam satu (atau beberapa) tabel. Jika miring, kecepatan migrasi bisa lebih lambat dari yang diharapkan. Dalam hal ini, kecepatan migrasi dapat ditingkatkan dengan memigrasikan tabel besar secara paralel.

Mengonfigurasi tugas migrasi

Layanan migrasi dilengkapi dengan pengalaman sederhana berbasis wizard pada portal Azure. Berikut cara untuk memulainya:

1. Buka browser web Anda, dan buka portal. Untuk masuk, masukkan kredensial Anda. Tampilan default adalah dasbor layanan Anda.

2. Buka target Server Fleksibel Azure Database for PostgreSQL Anda.

3. Di tab Gambaran Umum Server Fleksibel, di menu sebelah kiri, gulir ke bawah ke Migrasi dan pilih.

   

4. Pilih tombol Buat untuk memulai migrasi dari satu server ke server fleksibel. Jika ini pertama kalinya Anda menggunakan layanan migrasi, kisi kosong muncul dengan perintah untuk memulai migrasi pertama Anda.

   

   Jika Anda telah membuat migrasi ke target Server Fleksibel, kisi berisi informasi tentang migrasi yang dicoba ke target ini dari Server Tunggal.

5. Anda melalui serangkaian tab berbasis wizard untuk membuat migrasi ke target Server Fleksibel ini dari berbagai sumber yang mungkin. Secara default, Jenis server sumber diatur ke Server Tunggal Azure Database for PostgreSQL, yang merupakan salah satu yang kami minati dalam skenario ini.

Atau, Anda dapat memulai proses migrasi dari Server Tunggal Azure Database for PostgreSQL.

1. Buka browser web Anda, dan buka portal. Untuk masuk, Anda harus memasukkan kredensial Anda. Tampilan default adalah dasbor layanan Anda.

2. Setelah memilih Server Tunggal, Anda dapat mengamati banner terkait migrasi di tab Gambaran Umum. Pilih Migrasi sekarang untuk memulai.

   

3. Anda dibawa ke halaman dengan dua opsi. Jika Anda telah membuat Server Fleksibel dan ingin menggunakannya sebagai target, pilih Pilih yang sudah ada, dan pilih detail Langganan, Grup sumber daya, dan Nama server yang sesuai. Setelah pilihan dibuat, pilih Buka wizard migrasi dan ikuti instruksi di bawah bagian Penyetelan .

   

4. Jika Anda memilih untuk membuat Server Fleksibel baru, pilih Buat baru dan pilih Buka untuk membuat wizard. Tindakan ini membawa Anda melalui proses pembuatan Server Fleksibel dan menyebarkan Server Fleksibel.

   

Setelah menyebarkan Server Fleksibel, ikuti langkah 3 hingga 5 di bawah Konfigurasikan tugas migrasi.

Siapkan

Tab pertama adalah Penyetelan. Jika Anda melewatkannya, izinkan ekstensi yang diperlukan seperti yang dijelaskan dalam Mengonfigurasi server fleksibel Azure Database for PostgreSQL Anda, sebelum Anda memulai migrasi.

Nama migrasi adalah pengidentifikasi unik untuk setiap migrasi ke Server Fleksibel ini. Bidang ini hanya menerima karakter alfanumerik dan tidak menerima karakter khusus kecuali garis bawah (_) dan tanda hubung (-). Nama harus dimulai dengan karakter alfanumerik. Nama ini juga harus unik untuk server target, karena tidak ada dua migrasi ke target Server Fleksibel yang sama yang dapat memiliki nama yang sama.

Jenis server sumber menunjukkan sumbernya. Dalam hal ini, ini adalah Server Tunggal Azure Database for PostgreSQL

Opsi migrasi memungkinkan Anda melakukan validasi sebelum memicu migrasi. Anda dapat memilih salah satu opsi berikut.

• Validasi - Memeriksa kesiapan server dan database Anda untuk migrasi ke target.
• Migrasi - Melewati validasi dan memulai migrasi.
• Validasi dan Migrasi - Melakukan validasi sebelum memicu migrasi. Migrasi dipicu hanya jika tidak ada kegagalan validasi.

Selalu merupakan praktik yang baik untuk memilih opsi Validasi atau Validasi dan Migrasi untuk melakukan validasi pramigrasi sebelum menjalankan migrasi.

Mode migrasi memungkinkan Anda memilih antara migrasi online dan offline, dalam hal ini harus diatur ke Online.

Saat mode migrasi Online dipilih, Replikasi logis harus diaktifkan di server Tunggal sumber. Jika tidak diaktifkan, layanan migrasi secara otomatis mengaktifkan replikasi logis di server Tunggal sumber. Replikasi juga dapat disiapkan secara manual dengan memilih item Replikasi , di bawah Pengaturan di menu sumber daya server Tunggal, dan mengatur dukungan replikasi Azure ke LOGICAL. Salah satu pendekatan menghidupkan ulang server tunggal sumber.

Pilih tombol Berikutnya: Pilih Server Runtime.

Runtime Server

Migration Runtime Server adalah fitur khusus dalam layanan migrasi di Azure Database for PostgreSQL, yang dirancang untuk bertindak sebagai server perantara selama migrasi. Ini adalah instans Azure Database for PostgreSQL - Server Fleksibel terpisah yang bukan server target tetapi digunakan untuk memfasilitasi migrasi database dari lingkungan sumber yang hanya dapat diakses melalui jaringan privat.

Untuk informasi selengkapnya tentang Server Runtime, kunjungi Server Runtime Migrasi.

Pilih tombol Berikutnya: Sambungkan ke sumber .

Sambungkan ke sumber

Bagian Sumber meminta Anda untuk memberikan detail yang terkait dengan Server Tunggal, yang merupakan sumber database.

Setelah Anda membuat pilihan Langganan dan Grup Sumber Daya, daftar dropdown untuk nama server menampilkan Server Tunggal di bawah grup sumber daya tersebut di seluruh wilayah. Pilih sumber yang ingin Anda migrasikan databasenya. Anda dapat memigrasikan database dari Server Tunggal ke Server Fleksibel target di wilayah yang sama. Migrasi lintas wilayah hanya diaktifkan untuk server India, Tiongkok, dan UEA.

Setelah Anda memilih sumber Server Tunggal, kotak Lokasi, dan versi PostgreSQL diisi secara otomatis. Pastikan Anda memberikan kredensial peran admin, karena itu diperlukan agar layanan migrasi berhasil memigrasikan database.

Setelah mengisi semua bidang, pilih tautan Sambungkan ke sumber . Ini memvalidasi bahwa detail server sumber yang dimasukkan sudah benar dan server sumber dapat dijangkau.

Pilih tombol Berikutnya: Pilih target migrasi untuk melanjutkan.

Pilih target migrasi

Bagian Pilih target migrasi menampilkan metadata untuk target Server Fleksibel, seperti Langganan, Grup sumber daya, Nama server, Lokasi, dan versi PostgreSQL.

Pilih nilai yang sesuai untuk metode Autentikasi dan semua bidang terkait autentikasi. Pastikan bahwa identitas yang disediakan adalah pengguna administrator di server target. Setelah mengisi semua informasi yang diperlukan, pilih tautan Sambungkan ke target . Ini memvalidasi bahwa detail server target yang dimasukkan sudah benar dan server target dapat dijangkau.

Pilih tombol Berikutnya: Pilih database untuk migrasi untuk memilih database yang akan dimigrasikan.

Pilih database untuk migrasi

Di bawah tab ini, ada daftar database pengguna di dalam Server Tunggal. Anda dapat memilih dan memigrasikan hingga delapan database dalam satu upaya migrasi. Jika ada lebih dari delapan database pengguna, proses migrasi diulang antara server sumber dan target untuk kumpulan database berikutnya. Database yang dipilih yang ada di server target dengan nama yang sama persis ditimpa.

Pilih tombol Berikutnya: Ringkasan untuk meninjau detailnya.

Ringkasan

Tab Ringkasan meringkas semua detail untuk membuat validasi atau migrasi. Tinjau detail dan pilih tombol Mulai Validasi dan Migrasi .

Memantau portal migrasi

Setelah Anda memulai migrasi, pemberitahuan tampaknya mengatakan bahwa validasi atau pembuatan migrasi berhasil. Anda dialihkan secara otomatis ke halaman Migrasi Server Fleksibel. Ini memiliki entri baru untuk validasi atau migrasi yang baru dibuat.

Kisi yang menampilkan migrasi memiliki kolom ini: Nama, Status, Mode migrasi, Jenis migrasi, Server sumber, Jenis server sumber, Database, Waktu mulai, dan Durasi. Entri ditampilkan dalam urutan menurun dari waktu mulai dengan entri terbaru di bagian atas.

Anda dapat menggunakan tombol Refresh untuk me-refresh status validasi atau migrasi.

Anda juga dapat memilih nama satu migrasi tertentu di kisi untuk melihat detail terkait.

Saat validasi atau migrasi dibuat, validasi atau migrasi berpindah ke status InProgress dan substat PerformingPreRequisiteSteps . Alur kerja membutuhkan waktu 2-3 menit untuk menyiapkan infrastruktur migrasi dan koneksi jaringan.

Mari kita lihat cara memantau migrasi untuk setiap opsi migrasi.

Memvalidasi

Setelah substat PerformingPreRequisiteSteps selesai, validasi berpindah ke substat Validasi sedang Berlangsung di mana pemeriksaan dilakukan pada server sumber dan target untuk menilai kesiapan migrasi.

Validasi berpindah ke status Berhasil jika semua validasi berada dalam status Berhasil atau Peringatan .

Kisi validasi memiliki informasi berikut:

• Detail validasi untuk instans dan Detail validasi untuk bagian database, mewakili aturan validasi yang digunakan untuk memeriksa kesiapan migrasi.
• Nama Validasi - Nama setiap aturan validasi tertentu.
• Status Validasi - Mewakili hasil untuk setiap aturan dan dapat memiliki salah satu dari tiga nilai:
  • Berhasil - Jika tidak ada kesalahan yang ditemukan.
  • Gagal - Jika ada kesalahan validasi.
  • Peringatan - Jika ada peringatan validasi.
• Durasi - Waktu yang diperlukan untuk operasi validasi.
• Waktu mulai (UTC) dan Waktu akhir (UTC) - Waktu mulai dan berakhir dari operasi validasi di UTC.

Status Validasi berpindah ke status Gagal jika ada kesalahan dalam validasi. Pilih validasi Nama validasi atau Nama database yang gagal, dan panel fan-out memberikan detail dan tindakan korektif yang harus Anda ambil untuk menghindari kesalahan ini.

Migrate

Setelah substat PerformingPreRequisiteSteps selesai, migrasi berpindah ke substat Migrasi Data saat kloning/penyalinan database berlangsung. Waktu migrasi selesai tergantung pada ukuran dan bentuk database yang Anda migrasikan. Migrasi cepat jika data sebagian besar didistribusikan secara merata di semua tabel. Ukuran tabel condong membutuhkan waktu yang relatif lebih lama.

Saat Anda memilih salah satu database dalam migrasi, panel fan-out akan muncul. Ini memiliki semua jumlah tabel (disalin, diantrekan, disalin, dan kesalahan) dan juga status migrasi database.

Migrasi berpindah ke status Berhasil saat status Migrasi Data berhasil diselesaikan. Jika ada masalah pada status Migrasi Data, migrasi berpindah ke status Gagal.

Setelah migrasi berpindah ke status Berhasil , skema, dan migrasi data dari Server Tunggal Anda ke target Server Fleksibel Anda selesai. Anda dapat menyegarkan halaman untuk memeriksa kemajuan.

Memvalidasi dan Memigrasikan

Dalam opsi ini, validasi dilakukan terlebih dahulu sebelum migrasi dimulai. Setelah substat PerformingPreRequisiteSteps selesai, alur kerja berpindah ke substat Validasi sedang Berlangsung.

• Jika validasi memiliki kesalahan, migrasi akan berpindah ke status Gagal .
• Jika validasi selesai tanpa kesalahan apa pun, migrasi dimulai, dan alur kerja berpindah ke substat Migrasi Data.

Anda dapat melihat hasil Validasi dan Migrasi setelah operasi selesai.

Migrasi langsung

Untuk opsi Migrasi dan untuk migrasi Validasi dan Migrasi, penyelesaian migrasi online mengharuskan pengguna menyelesaikan langkah tambahan, yaitu memicu tindakan Cutover. Setelah salinan/klon data dasar selesai, migrasi berpindah ke status WaitingForUserAction dan substat 'WaitingForCutoverTrigger . Dalam status ini, pengguna dapat memicu cutover dari portal dengan memilih migrasi, dan memilih tombol Cutover .

Sebelum memulai cutover, penting untuk memastikan bahwa:

• Penulisan ke sumber dihentikan -Latency (minutes) parameter adalah 0 atau dekat dengan 0 Informasi Latency (minutes) dapat diperoleh dari layar detail migrasi:

Latency (minutes) parameter menunjukkan kapan target terakhir disinkronkan dengan sumbernya. Misalnya, untuk database Pesanan di atas, itu adalah 0,33333. Ini berarti bahwa perubahan yang terjadi dalam ~0,3 menit terakhir di sumber belum dikirim ke target, untuk database Pesanan . Pada titik ini, penulisan ke sumber dapat dihentikan dan cutover dimulai. Jika ada lalu lintas padat di sumbernya, disarankan untuk menghentikan penulisan terlebih dahulu sehingga Latency (minutes) dapat mendekati 0, dan hanya kemudian memulai cutover. Operasi cutover menerapkan semua perubahan yang tertunda dari sumber ke target dan menyelesaikan migrasi. Jika Anda memicu cutover bahkan dengan latensi non-nol, replikasi akan berhenti hingga titik waktu tersebut. Semua data pada sumber hingga titik cutover kemudian diterapkan ke target. Katakanlah latensi adalah 15 menit di titik cutover, sehingga semua data yang diubah dalam 15 menit terakhir diterapkan ke target. Waktu yang diambil tergantung pada backlog perubahan yang terjadi dalam 15 menit terakhir. Oleh karena itu, disarankan agar latensinya nol atau mendekati nol, sebelum memicu cutover.

Migrasi berpindah ke status Berhasil segera setelah substat Data Migrasi atau cutover (dalam mode migrasi online) berhasil diselesaikan. Jika ada masalah di substat Data Migrasi, migrasi akan berpindah ke status Gagal .

Status migrasi yang dapat muncul mencakup:

• InProgress: Penyiapan infrastruktur migrasi sedang berlangsung, atau migrasi data aktual sedang berlangsung.
• Dibatalkan: Migrasi dibatalkan atau dihapus.
• Gagal: Migrasi telah gagal.
• Validasi Gagal : Validasi gagal.
• Berhasil: Migrasi telah berhasil dan selesai.

Substatus migrasi yang dapat muncul mencakup:

• PerformingPreRequisiteSteps: Penyiapan infrastruktur sedang berlangsung untuk migrasi data.
• Validasi sedang Berlangsung: Validasi sedang berlangsung.
• MigrasiData: Migrasi data sedang berlangsung.
• CompletingMigration: Migrasi sedang dalam tahap akhir penyelesaian.
• Selesai: Migrasi berhasil diselesaikan.

Membatalkan migrasi menggunakan portal

Anda dapat membatalkan validasi atau migrasi yang sedang berlangsung. Alur kerja harus dalam status InProgress untuk dibatalkan. Anda tidak dapat membatalkan validasi atau migrasi yang berada dalam status Berhasil atau Gagal .

Membatalkan validasi akan menghentikan aktivitas validasi lebih lanjut dan validasi berpindah ke status Dibatalkan .

Membatalkan migrasi menghentikan aktivitas migrasi lebih lanjut di server target Anda dan pindah ke status Dibatalkan . Tindakan pembatalan akan mengembalikan semua perubahan yang dilakukan oleh layanan migrasi di server target Anda.

CLI

Anda dapat bermigrasi menggunakan Azure CLI.

Luring

Prasyarat (offline)

Sebelum memulai migrasi dengan layanan migrasi di Azure Database for PostgreSQL, Anda harus memenuhi prasyarat berikut, yang berlaku untuk skenario migrasi offline.

Memverifikasi versi sumber

Versi PostgreSQL sumber harus >= 9.5. Jika versi PostgreSQL sumber kurang dari 9.5, tingkatkan versi PostgreSQL sumber ke 9.5 atau yang lebih tinggi sebelum migrasi.

Penyiapan target

• Server fleksibel Azure Database for PostgreSQL harus disebarkan dan dikonfigurasi dengan benar di Azure sebelum Anda memulai proses migrasi.

• SKU yang dipilih untuk Azure Database for PostgreSQL harus sesuai dengan spesifikasi database sumber untuk memastikan kompatibilitas dan performa yang memadai.

• Untuk instruksi terperinci tentang membuat Azure Database for PostgreSQL baru, lihat tautan berikut: Mulai Cepat: Membuat server.

Penyiapan jaringan

Penyiapan jaringan sangat penting agar layanan migrasi berfungsi dengan benar. Pastikan bahwa server PostgreSQL sumber dapat berkomunikasi dengan server Azure Database for PostgreSQL target. Konfigurasi jaringan berikut sangat penting untuk keberhasilan migrasi.

Untuk informasi tentang penyiapan jaringan, kunjungi Panduan jaringan untuk layanan migrasi.

Mengaktifkan ekstensi

Untuk memastikan keberhasilan migrasi dengan layanan migrasi di Azure Database for PostgreSQL, Anda mungkin perlu memverifikasi ekstensi ke instans PostgreSQL sumber Anda. Ekstensi menyediakan fungsionalitas dan fitur tambahan yang mungkin diperlukan untuk aplikasi Anda. Pastikan untuk memverifikasi ekstensi pada instans PostgreSQL sumber sebelum memulai proses migrasi.

Aktifkan ekstensi yang didukung yang diidentifikasi dalam instans PostgreSQL sumber pada server fleksibel Azure Database for PostgreSQL target.

Untuk informasi selengkapnya tentang ekstensi, kunjungi Ekstensi di Azure Database for PostgreSQL.

Catatan

Hidupkan ulang diperlukan ketika ada perubahan pada shared_preload_libraries parameter .

Periksa parameter server

Parameter ini tidak secara otomatis dimigrasikan ke lingkungan target dan harus dikonfigurasi secara manual.

• Cocokkan nilai parameter server dari database PostgreSQL sumber ke Azure Database for PostgreSQL dengan mengakses bagian Parameter server di portal Azure dan memperbarui nilai secara manual yang sesuai.

• Simpan perubahan parameter dan, jika perlu, mulai ulang server fleksibel Azure Database for PostgreSQL untuk menerapkan konfigurasi baru.

Nonaktifkan ketersediaan tinggi (keandalan) dan replika baca dalam target

• Menonaktifkan ketersediaan tinggi (keandalan) dan replika baca di lingkungan target sangat penting. Fitur-fitur ini harus diaktifkan hanya setelah migrasi selesai.

• Dengan mengikuti panduan ini, Anda dapat membantu memastikan proses migrasi yang lancar tanpa variabel tambahan yang diperkenalkan oleh ketersediaan tinggi dan replika baca. Setelah migrasi selesai dan database stabil, Anda dapat melanjutkan untuk mengaktifkan fitur-fitur ini untuk meningkatkan ketersediaan dan skalabilitas lingkungan database Anda di Azure.

Memulai

1. Jika Anda baru mengenal Microsoft Azure, buat sebuah akun untuk mengevaluasi penawaran kami.

2. Instal Azure CLI terbaru untuk sistem operasi terkait Anda dari halaman penginstalan Azure CLI.

   Jika Azure CLI sudah diinstal, periksa versinya dengan menggunakan perintah az version. Versi harus 2.50.0 atau yang lebih baru untuk menggunakan perintah CLI migrasi. Jika tidak, perbarui versi Azure CLI Anda.

3. Jalankan az login perintah:

   az login
   

   Jendela browser terbuka dengan halaman masuk Azure. Berikan kredensial Azure Anda agar berhasil melakukan autentikasi. Untuk cara lain untuk masuk dengan Azure CLI, lihat artikel ini.

Perintah CLI migrasi (offline)

Layanan migrasi dilengkapi dengan perintah CLI yang mudah digunakan untuk melakukan tugas terkait migrasi. Semua perintah CLI dimulai dengan az postgres flexible-server migration. Penting untuk mengizinkan daftar ekstensi sebelum Anda memulai migrasi.

Untuk bantuan dalam memahami opsi yang terkait dengan perintah serta dengan pembingkaian sintaks yang tepat, Anda bisa menggunakan parameter --help:

az postgres flexible-server migration --help

Menjalankan perintah sebelumnya mengembalikan output berikut:

Output mencantumkan perintah migrasi yang didukung, bersamaan dengan tindakannya. Mari kita lihat perintah ini secara rinci.

Membuat migrasi menggunakan Azure CLI

Perintah create membantu dalam pembuatan migrasi dari server sumber ke server target:

az postgres flexible-server migration create --help

Menjalankan perintah sebelumnya mengembalikan output berikut:

Ini mencantumkan argumen yang diharapkan dan memiliki sintaks contoh untuk berhasil membuat migrasi dari server sumber ke server target. Berikut adalah perintah CLI untuk membuat migrasi baru:

az postgres flexible-server migration create [--subscription]
                                             [--resource-group]
                                             [--name]
                                             [--migration-name]
                                             [--migration-mode]
                                             [--properties]

Parameter	Deskripsi
subscription	ID langganan dari target Server Fleksibel.
resource-group	Grup sumber daya dari target Server Fleksibel.
name	Nama dari target Server Fleksibel.
migration-name	Pengidentifikasi unik untuk setiap migrasi ke target Server Fleksibel ini. Bidang ini hanya menerima karakter alfanumerik dan tidak menerima karakter khusus kecuali garis bawah (_) dan tanda hubung (-). Nama harus dimulai dan diakhir dengan karakter alfanumerik. Nama ini juga harus unik untuk server target, karena tidak ada dua migrasi ke target Server Fleksibel yang sama yang dapat memiliki nama yang sama.
migration-mode	Ini adalah parameter opsional. Nilai default: Offline. Migrasi offline melibatkan penyalinan database sumber Anda pada titik waktu tertentu, ke server target Anda.
properties	Jalur absolut ke file JSON, yang memiliki informasi tentang sumber Server Tunggal.

Contohnya:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode offline

Argumen migration-name yang create digunakan dalam perintah digunakan dalam perintah CLI lainnya, seperti update, , deletedan show. Secara unik mengidentifikasi upaya migrasi dalam tindakan yang sesuai di semua perintah tersebut.

Terakhir, create perintah memerlukan file JSON untuk diteruskan sebagai bagian dari argumennya properties .

Struktur dari JSON adalah:

{
  "properties": {
    "sourceDbServerResourceId": "/subscriptions/<subscriptionid>/resourceGroups/<sourceServerResourceGroup>/providers/Microsoft.DBforPostgreSQL/servers/<sourceServer>",
    "secretParameters": {
      "adminCredentials": {
        "sourceServerPassword": "<password>",
        "targetServerPassword": "<password>"
      }
    },
    "sourceServerUserName": "<username>@<servername>",
    "targetServerUserName": "<username>",
    "dbsToMigrate": ["<db1>", "<db2>"],
    "overwriteDbsInTarget": "true"
  }
}

Parameter create yang masuk ke format file JSON seperti yang ditunjukkan di bawah ini:

Parameter	Jenis	Deskripsi
sourceDbServerResourceId	Wajib diisi	Parameter ini adalah ID sumber daya dari sumber Server Tunggal.
adminCredentials	Wajib	Parameter ini mencantumkan kata sandi untuk pengguna admin untuk sumber Server Tunggal dan target Server Fleksibel. Kata sandi ini membantu mengautentikasi terhadap server sumber serta target.
sourceServerUserName	Wajib	Nilai default adalah pengguna admin yang ditentukan selama pembuatan satu server, dan kata sandi yang disediakan digunakan untuk autentikasi dengan pengguna ini. Jika Anda tidak menggunakan pengguna default, parameter ini adalah pengguna atau peran di server sumber untuk melakukan migrasi. Pengguna ini harus memiliki hak istimewa dan kepemilikan objek database yang diperlukan yang terlibat dalam migrasi dan harus menjadi anggota peran azure_pg_admin .
targetServerUserName	Wajib	Nilai default adalah pengguna admin yang dibuat selama pembuatan server fleksibel, dan kata sandi yang disediakan digunakan untuk autentikasi dengan pengguna ini. Jika Anda tidak menggunakan pengguna default, parameter ini adalah pengguna atau peran di server target yang digunakan untuk melakukan migrasi. Pengguna ini harus menjadi anggota peran azure_pg_admin, pg_read_all_settings, pg_read_all_stats, pg_stat_scan_tables dan harus memiliki peran Buat, Buat atribut DB .
dbsToMigrate	Wajib	Tentukan daftar database yang ingin Anda migrasikan ke Server Fleksibel. Hanya database pengguna yang dimigrasikan. Database sistem atau database templat seperti templat0 dan templat1 tidak dimigrasikan.
overwriteDbsInTarget	Wajib	Ketika diatur ke true, jika server target kebetulan memiliki database yang sudah ada dengan nama yang sama dengan yang coba Anda migrasikan, layanan migrasi secara otomatis menimpa database.
setupLogicalReplicationOnSourceDBIfNeeded	Opsional	Anda dapat secara otomatis mengaktifkan replikasi logis pada server sumber dengan mengatur properti ini ke true. Perubahan pengaturan server ini memerlukan mulai ulang server dengan waktu henti dua hingga tiga menit.
sourceDBServerFullyQualifiedDomainName	Opsional	Gunakan saat server DNS kustom digunakan untuk resolusi nama untuk sebuah jaringan virtual. Berikan FQDN sumber Server Tunggal sesuai dengan server DNS kustom untuk properti ini.
targetDBServerFullyQualifiedDomainName	Opsional	Gunakan saat server DNS kustom digunakan untuk resolusi nama di dalam sebuah jaringan virtual. Berikan FQDN dari target Server Fleksibel sesuai dengan server DNS kustom. sourceDBServerFullyQualifiedDomainName dan targetDBServerFullyQualifiedDomainName disertakan sebagai bagian dari JSON hanya dalam skenario langka bahwa server DNS kustom digunakan untuk resolusi nama alih-alih DNS yang disediakan Azure. Jika tidak, jangan sertakan parameter ini dalam file JSON.

Perhatikan poin-poin penting ini untuk respons perintah:

• create Saat perintah dipicu, migrasi berpindah ke InProgress status dan PerformingPreRequisiteSteps substat. Alur kerja migrasi membutuhkan waktu beberapa menit untuk menyebarkan infrastruktur migrasi dan menyiapkan koneksi antara sumber dan target.
• PerformingPreRequisiteSteps Setelah substat selesai, migrasi berpindah ke substat Migrating Data, tempat kloning/penyalinan database berlangsung.
• Setiap database yang dimigrasikan memiliki bagiannya sendiri dengan semua detail migrasi, seperti jumlah tabel, sisipan bertambah bertahap, penghapusan, dan byte yang tertunda.
• Waktu yang Migrating Data dibutuhkan substat untuk menyelesaikan tergantung pada ukuran database yang dimigrasikan.
• Migrasi berpindah ke status Succeeded segera setelah Migrating Data substat berhasil diselesaikan. Jika ada masalah di sub-status Migrating Data, migrasi berpindah ke status Failed.

Mencantumkan migrasi

Perintah mencantumkan list semua upaya migrasi yang dilakukan ke target Server Fleksibel:

az postgres flexible-server migration list [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--filter]

Parameter filter memiliki dua opsi:

• Active: Mencantumkan upaya migrasi aktif saat ini (sedang berlangsung) ke server target. Ini tidak termasuk migrasi yang gagal, dibatalkan, atau berhasil.
• All: Mencantumkan semua upaya migrasi ke server target. Ini termasuk migrasi aktif dan selesai, terlepas dari statusnya.

Untuk informasi selengkapnya tentang perintah ini, gunakan parameter --help:

az postgres flexible-server migration list --help

Memantau migrasi

Perintah ini --show membantu Anda memantau migrasi yang sedang berlangsung dan memberikan status dan substat migrasi saat ini.

az postgres flexible-server migration show [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--migration-name]

Parameter migration_name adalah nama yang ditetapkan ke migrasi selama perintah create. Berikut adalah snapshot dari respons sampel dari perintah CLI untuk menampilkan detail:

Untuk informasi selengkapnya tentang perintah ini, gunakan parameter --help:

 az postgres flexible-server migration show --help

Tabel berikut ini menjelaskan status dan sub-status migrasi.

Status migrasi	Deskripsi
InProgress	Infrastruktur migrasi disiapkan, atau migrasi data aktual sedang berlangsung.
Canceled	Migrasi dibatalkan atau dihapus.
Failed	Migrasi telah gagal.
Succeeded	Migrasi telah berhasil dan selesai.
ValidationFailed	Migrasi gagal selama validasi pra-migrasi.

Sub-status migrasi	Deskripsi
PerformingPreRequisiteSteps	Infrastruktur disiapkan dan disiapkan untuk migrasi data.
MigratingData	Migrasi data sedang berlangsung.
CompletingMigration	Menyelesaikan proses migrasi.
Completed	Migrasi selesai, baik dalam status berhasil atau tidak.
CancelingRequestedDBMigrations	Membatalkan migrasi.
ValidationInProgress	Validasi dalam proses.

Online

Prasyarat (online)

Sebelum Anda memulai migrasi dengan layanan migrasi di Azure Database for PostgreSQL, memenuhi prasyarat berikut, yang berlaku untuk skenario migrasi offline sangat penting.

Memverifikasi versi sumber

Versi PostgreSQL sumber harus >= 9.5. Jika versi PostgreSQL sumber kurang dari 9.5, tingkatkan versi PostgreSQL sumber ke 9.5 atau yang lebih tinggi sebelum migrasi.

Menyiapkan parameter migrasi online

Untuk Migrasi online, dukungan replikasi harus diatur ke Logis di bawah pengaturan replikasi server PostgreSQL sumber. Selain itu, parameter max_wal_senders dan max_replication_slots nilai server harus lebih dari jumlah Database yang perlu dimigrasikan. Parameter dapat diatur dalam portal Azure di bawah Parameter Pengaturan-Server> atau dikonfigurasi di baris perintah menggunakan perintah berikut:

• ALTER SYSTEM SET wal_level = logis;
• ALTER SYSTEM SET max_wal_senders = number of databases to migrate + 1;
• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Pastikan bahwa tidak ada transaksi yang berjalan lama. Transaksi yang berjalan lama tidak memungkinkan pembuatan slot replikasi. Pembuatan slot replikasi akan berhasil jika semua transaksi yang berjalan lama diterapkan atau digulung balik. Anda harus memulai ulang server PostgreSQL sumber setelah menyelesaikan semua prasyarat migrasi Online.

Catatan

Untuk migrasi online dengan server tunggal Azure Database for PostgreSQL, dukungan replikasi Azure diatur ke logis di bawah pengaturan replikasi halaman server tunggal di portal Azure.

Untuk mencegah migrasi Online kehabisan penyimpanan untuk menyimpan log, pastikan Anda memiliki ruang tabel yang memadai menggunakan disk terkelola yang disediakan. Untuk mencapai hal ini, nonaktifkan parameter azure.enable_temp_tablespaces_on_local_ssd server di Server Fleksibel selama durasi migrasi, dan pulihkan ke status asli setelah migrasi.

Menyiapkan target

• Azure Database for PostgreSQL harus disiapkan di Azure sebelum migrasi.

• SKU yang dipilih untuk Azure Database for PostgreSQL harus sesuai dengan spesifikasi database sumber untuk memastikan kompatibilitas dan performa yang memadai.

• Untuk instruksi terperinci tentang membuat Azure Database for PostgreSQL baru, lihat tautan berikut: Mulai Cepat: Membuat server.

• Parameter max_replication_slots server harus lebih dari jumlah Database yang perlu dimigrasikan. Ini dapat diatur dalam portal Azure di bawah Parameter Pengaturan-Server> atau dikonfigurasi di baris perintah menggunakan perintah berikut:

• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Menyiapkan Jaringan

Penyiapan jaringan sangat penting agar layanan migrasi berfungsi dengan benar. Pastikan bahwa server PostgreSQL sumber dapat berkomunikasi dengan server Azure Database for PostgreSQL target. Konfigurasi jaringan berikut sangat penting untuk keberhasilan migrasi.

Untuk informasi tentang penyiapan jaringan, kunjungi Panduan jaringan untuk layanan migrasi.

Mengaktifkan ekstensi

Untuk memastikan keberhasilan migrasi dengan layanan migrasi di Azure Database for PostgreSQL, Anda mungkin perlu memverifikasi ekstensi ke instans PostgreSQL sumber Anda. Ekstensi menyediakan fungsionalitas dan fitur tambahan yang mungkin diperlukan untuk aplikasi Anda. Pastikan untuk memverifikasi ekstensi pada instans PostgreSQL sumber sebelum memulai proses migrasi.

Aktifkan ekstensi yang didukung yang diidentifikasi dalam instans PostgreSQL sumber pada server fleksibel Azure Database for PostgreSQL target.

Untuk informasi selengkapnya tentang ekstensi, kunjungi Ekstensi di Azure Database for PostgreSQL.

Catatan

Hidupkan ulang diperlukan ketika ada perubahan pada shared_preload_libraries parameter .

Parameter server

Parameter ini tidak secara otomatis dimigrasikan ke lingkungan target dan harus dikonfigurasi secara manual.

• Cocokkan nilai parameter server dari database PostgreSQL sumber ke Azure Database for PostgreSQL dengan mengakses bagian "Parameter server" di portal Azure dan memperbarui nilai secara manual.

• Simpan perubahan parameter dan mulai ulang Azure Database for PostgreSQL untuk menerapkan konfigurasi baru jika perlu.

Nonaktifkan ketersediaan tinggi (keandalan) dan replika baca dalam target

• Menonaktifkan ketersediaan tinggi (keandalan) dan membaca replika di lingkungan target sangat penting. Fitur-fitur ini harus diaktifkan hanya setelah migrasi selesai.

• Dengan mengikuti panduan ini, Anda dapat membantu memastikan proses migrasi yang lancar tanpa variabel tambahan yang diperkenalkan oleh Ha dan Replika Baca. Setelah migrasi selesai dan database stabil, Anda dapat melanjutkan untuk mengaktifkan fitur-fitur ini untuk meningkatkan ketersediaan dan skalabilitas lingkungan database Anda di Azure.

Catatan

Batasan tertentu berlaku untuk Migrasi online yang didokumenkan di sini. Pastikan database Anda sesuai untuk menjalankan migrasi Online.

Memulai

1. Jika Anda baru mengenal Microsoft Azure, buat sebuah akun untuk mengevaluasi penawaran kami.

2. Instal Azure CLI terbaru untuk sistem operasi terkait Anda dari halaman penginstalan Azure CLI.

   Jika Azure CLI sudah diinstal, periksa versinya dengan menggunakan perintah az version. Versi harus 2.50.0 atau yang lebih baru untuk menggunakan perintah CLI migrasi. Jika tidak, perbarui versi Azure CLI Anda.

3. Jalankan az login perintah:

   az login
   

   Jendela browser terbuka dengan halaman masuk Azure. Berikan kredensial Azure Anda agar berhasil melakukan autentikasi. Untuk cara lain untuk masuk dengan Azure CLI, lihat artikel ini.

Perintah CLI migrasi (online)

Layanan migrasi dilengkapi dengan perintah CLI yang mudah digunakan untuk melakukan tugas terkait migrasi. Semua perintah CLI dimulai dengan az postgres flexible-server migration. Penting untuk mengizinkan daftar ekstensi sebelum Anda memulai migrasi.

Untuk bantuan dalam memahami opsi yang terkait dengan perintah serta dengan pembingkaian sintaks yang tepat, Anda bisa menggunakan parameter --help:

az postgres flexible-server migration --help

Menjalankan perintah sebelumnya mengembalikan output berikut:

Output mencantumkan perintah migrasi yang didukung, bersamaan dengan tindakannya. Mari kita lihat perintah ini secara rinci.

Membuat migrasi menggunakan Azure CLI

Perintah create membantu dalam pembuatan migrasi dari server sumber ke server target:

az postgres flexible-server migration create --help

Menjalankan perintah sebelumnya mengembalikan output berikut:

Ini mencantumkan argumen yang diharapkan dan memiliki sintaks contoh untuk berhasil membuat migrasi dari server sumber ke server target. Berikut adalah perintah CLI untuk membuat migrasi baru:

az postgres flexible-server migration create [--subscription]
                                             [--resource-group]
                                             [--name]
                                             [--migration-name]
                                             [--migration-mode]
                                             [--properties]

Parameter	Deskripsi
subscription	ID langganan dari target Server Fleksibel.
resource-group	Grup sumber daya dari target Server Fleksibel.
name	Nama dari target Server Fleksibel.
migration-name	Pengidentifikasi unik untuk setiap migrasi ke target Server Fleksibel ini. Bidang ini hanya menerima karakter alfanumerik dan tidak menerima karakter khusus kecuali garis bawah (_) dan tanda hubung (-). Nama harus dimulai dan diakhir dengan karakter alfanumerik. Nama ini juga harus unik untuk server target, karena tidak ada dua migrasi ke target Server Fleksibel yang sama yang dapat memiliki nama yang sama.
migration-mode	Ini adalah parameter opsional. Nilai default Offline. Untuk migrasi online, Anda harus melewati Online.
properties	Jalur absolut ke file JSON, yang memiliki informasi tentang sumber Server Tunggal.

Contohnya:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode online

Argumen migration-name yang create digunakan dalam perintah digunakan dalam perintah CLI lainnya, seperti update, , deletedan show. Secara unik mengidentifikasi upaya migrasi dalam tindakan yang sesuai di semua perintah tersebut.

Terakhir, create perintah memerlukan file JSON untuk diteruskan sebagai bagian dari argumennya properties .

Struktur dari JSON adalah:

{
  "properties": {
    "sourceDbServerResourceId": "/subscriptions/<subscriptionid>/resourceGroups/<sourceServerResourceGroup>/providers/Microsoft.DBforPostgreSQL/servers/<sourceServer>",
    "secretParameters": {
      "adminCredentials": {
        "sourceServerPassword": "<password>",
        "targetServerPassword": "<password>"
      }
    },
    "sourceServerUserName": "<username>@<servername>",
    "targetServerUserName": "<username>",
    "dbsToMigrate": ["<db1>", "<db2>"],
    "overwriteDbsInTarget": "true"
  }
}

Parameter create yang masuk ke format file JSON seperti yang ditunjukkan di bawah ini:

Parameter	Jenis	Deskripsi
sourceDbServerResourceId	Wajib diisi	Parameter ini adalah ID sumber daya dari sumber Server Tunggal.
adminCredentials	Wajib	Parameter ini mencantumkan kata sandi untuk pengguna admin untuk sumber Server Tunggal dan target Server Fleksibel. Kata sandi ini membantu mengautentikasi terhadap server sumber serta target.
sourceServerUserName	Wajib	Nilai default adalah pengguna admin yang ditentukan selama pembuatan satu server, dan kata sandi yang disediakan digunakan untuk autentikasi dengan pengguna ini. Jika Anda tidak menggunakan pengguna default, parameter ini adalah pengguna atau peran di server sumber untuk melakukan migrasi. Pengguna ini harus memiliki hak istimewa dan kepemilikan objek database yang diperlukan yang terlibat dalam migrasi dan harus menjadi anggota peran azure_pg_admin .
targetServerUserName	Wajib	Nilai default adalah pengguna admin yang dibuat selama pembuatan server fleksibel, dan kata sandi yang disediakan digunakan untuk autentikasi dengan pengguna ini. Jika Anda tidak menggunakan pengguna default, parameter ini adalah pengguna atau peran di server target yang digunakan untuk melakukan migrasi. Pengguna ini harus menjadi anggota peran azure_pg_admin, pg_read_all_settings, pg_read_all_stats, pg_stat_scan_tables dan harus memiliki peran Buat, Buat atribut DB .
dbsToMigrate	Wajib	Tentukan daftar database yang ingin Anda migrasikan ke Server Fleksibel. Hanya database pengguna yang dimigrasikan. Database sistem atau database templat seperti templat0 dan templat1 tidak dimigrasikan.
overwriteDbsInTarget	Wajib	Ketika diatur ke true, jika server target kebetulan memiliki database yang sudah ada dengan nama yang sama dengan yang coba Anda migrasikan, layanan migrasi secara otomatis menimpa database.
setupLogicalReplicationOnSourceDBIfNeeded	Opsional	Anda dapat secara otomatis mengaktifkan replikasi logis pada server sumber dengan mengatur properti ini ke true. Perubahan pengaturan server ini memerlukan mulai ulang server dengan waktu henti dua hingga tiga menit.
sourceDBServerFullyQualifiedDomainName	Opsional	Gunakan saat server DNS kustom digunakan untuk resolusi nama untuk sebuah jaringan virtual. Berikan FQDN sumber Server Tunggal sesuai dengan server DNS kustom untuk properti ini.
targetDBServerFullyQualifiedDomainName	Opsional	Gunakan saat server DNS kustom digunakan untuk resolusi nama di dalam sebuah jaringan virtual. Berikan FQDN dari target Server Fleksibel sesuai dengan server DNS kustom. sourceDBServerFullyQualifiedDomainName dan targetDBServerFullyQualifiedDomainName disertakan sebagai bagian dari JSON hanya dalam skenario langka bahwa server DNS kustom digunakan untuk resolusi nama alih-alih DNS yang disediakan Azure. Jika tidak, jangan sertakan parameter ini dalam file JSON.

Perhatikan poin-poin penting ini untuk respons perintah:

• create Saat perintah dipicu, migrasi berpindah ke InProgress status dan PerformingPreRequisiteSteps substat. Alur kerja migrasi membutuhkan waktu beberapa menit untuk menyebarkan infrastruktur migrasi dan menyiapkan koneksi antara sumber dan target.
• PerformingPreRequisiteSteps Setelah substat selesai, migrasi berpindah ke substat Migrating Data, tempat kloning/penyalinan database berlangsung.
• Setiap database yang dimigrasikan memiliki bagiannya sendiri dengan semua detail migrasi, seperti jumlah tabel, sisipan bertambah bertahap, penghapusan, dan byte yang tertunda.
• Waktu yang Migrating Data dibutuhkan substat untuk menyelesaikan tergantung pada ukuran database yang dimigrasikan.
• Migrasi berpindah ke status Succeeded segera setelah Migrating Data substat berhasil diselesaikan. Jika ada masalah di sub-status Migrating Data, migrasi berpindah ke status Failed.

Replikasi penyetelan

Untuk mode migrasi online, replikasi logis harus diaktifkan di server Tunggal sumber. Jika tidak diaktifkan, layanan migrasi secara otomatis mengaktifkan replikasi logis di server Tunggal sumber saat setupLogicalReplicationOnSourceDBIfNeeded parameter diteruskan dengan nilai true dalam file JSON yang menyertainya. Replikasi juga dapat disiapkan secara manual di sumber setelah memulai migrasi menggunakan perintah di bawah ini. Salah satu pendekatan mengaktifkan replikasi logis menghidupkan ulang server Tunggal sumber.

Contohnya:

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name CLIMigrationExample --setup-replication

Perintah ini diperlukan untuk memajukan migrasi ketika server fleksibel menunggu dalam status WaitingForLogicalReplicationSetupRequestOnSourceDB .

Untuk melakukan penggunaan migrasi online:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode online

Mencantumkan migrasi

Perintah mencantumkan list semua upaya migrasi yang dilakukan ke target Server Fleksibel:

az postgres flexible-server migration list [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--filter]

Parameter filter memiliki dua opsi:

• Active: Mencantumkan upaya migrasi aktif saat ini (sedang berlangsung) ke server target. Ini tidak termasuk migrasi yang gagal, dibatalkan, atau berhasil.
• All: Mencantumkan semua upaya migrasi ke server target. Ini termasuk migrasi aktif dan selesai, terlepas dari statusnya.

Untuk informasi selengkapnya tentang perintah ini, gunakan parameter --help:

az postgres flexible-server migration list --help

Memantau migrasi

Perintah ini show membantu Anda memantau migrasi yang sedang berlangsung dan memberikan status dan substat migrasi saat ini.

az postgres flexible-server migration show [--subscription]
                                           [--resource-group]
                                           [--name]
                                           [--migration-name]

Parameter migration_name adalah nama yang ditetapkan ke migrasi selama perintah create. Berikut adalah snapshot dari respons sampel dari perintah CLI untuk menampilkan detail:

Untuk informasi selengkapnya tentang perintah ini, gunakan parameter --help:

 az postgres flexible-server migration show --help

Tabel berikut ini menjelaskan status dan sub-status migrasi.

Status migrasi	Deskripsi
InProgress	Infrastruktur migrasi disiapkan, atau migrasi data aktual sedang berlangsung.
Canceled	Migrasi dibatalkan atau dihapus.
Failed	Migrasi telah gagal.
Succeeded	Migrasi telah berhasil dan selesai.
ValidationFailed	Migrasi gagal selama validasi pra-migrasi.

Sub-status migrasi	Deskripsi
PerformingPreRequisiteSteps	Infrastruktur disiapkan dan disiapkan untuk migrasi data.
MigratingData	Migrasi data sedang berlangsung.
WaitingForCutoverTrigger	Tugas migrasi data selesai dan menunggu pengguna memicu cutover.
CompletingMigration	Menyelesaikan proses migrasi.
Completed	Migrasi selesai, baik dalam status berhasil atau tidak.
CancelingRequestedDBMigrations	Membatalkan migrasi.
ValidationInProgress	Validasi dalam proses.

Cutover migrasi

Dalam migrasi online, setelah migrasi data dasar selesai, tugas migrasi berpindah ke WaitingForCutoverTrigger substat. Dalam status ini, pengguna dapat memicu cutover melalui CLI menggunakan perintah di bawah ini. Cutover juga dapat dipicu dari portal dengan memilih nama migrasi di kisi migrasi.

Contohnya:

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name CLIMigrationExample --cutover

Sebelum memulai cutover, penting untuk memastikan bahwa:

• Penulisan ke sumber dihentikan -latency parameter adalah 0 atau mendekati 0

latency parameter menunjukkan kapan target terakhir disinkronkan dengan sumbernya. Misalnya, di sini adalah 201 dan 202 untuk dua database seperti yang ditunjukkan pada gambar di bawah ini. Ini berarti bahwa perubahan yang terjadi dalam ~200 detik terakhir di sumber belum disinkronkan ke target. Pada titik ini, penulisan ke sumber dapat dihentikan dan cutover dimulai. Jika ada lalu lintas padat di sumbernya, disarankan untuk menghentikan penulisan terlebih dahulu sehingga Latency dapat mendekati 0, dan kemudian cutover dimulai. Operasi Cutover menerapkan semua perubahan yang tertunda dari sumber ke Target dan menyelesaikan migrasi. Jika Anda memicu "Cutover" bahkan dengan nonzero Latency, replikasi berhenti sampai titik waktu tersebut. Semua data pada sumber hingga titik cutover kemudian diterapkan ke target. Katakanlah latensi adalah 15 menit di titik cutover, sehingga semua data perubahan dalam 15 menit terakhir berlaku untuk target. Waktu yang dibutuhkan tergantung pada backlog perubahan yang terjadi dalam 15 menit terakhir. Oleh karena itu, disarankan agar latensi mencapai nol atau mendekati nol, sebelum memicu cutover. Informasi latency dapat diperoleh menggunakan perintah migrasi show.

Berikut adalah rekam jepret migrasi sebelum memulai cutover:

Setelah cutover dimulai, semua transaksi yang terjadi selama salinan dasar disalin secara berurutan ke target, dan migrasi selesai.

Jika cutover tidak berhasil, migrasi akan berpindah ke status Failed .

Untuk informasi selengkapnya tentang perintah ini, gunakan parameter --help:

 az postgres flexible-server migration update --help

Membatalkan migrasi menggunakan CLI

Anda dapat membatalkan upaya migrasi yang sedang berlangsung dengan menggunakan cancel perintah . Perintah ini menghentikan upaya migrasi tertentu dan mengembalikan semua perubahan di server target Anda. Berikut adalah perintah CLI untuk membatalkan migrasi:

az postgres flexible-server migration update cancel [--subscription]
                                                    [--resource-group]
                                                    [--name]
                                                    [--migration-name]

Contohnya:

az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1

Untuk informasi selengkapnya tentang perintah ini, gunakan parameter --help:

 az postgres flexible-server migration update cancel --help

Perintah memberi Anda output berikut:

Periksa migrasi setelah selesai

Setelah menyelesaikan database, Anda perlu memvalidasi data antara sumber dan target secara manual dan memverifikasi bahwa semua objek dalam database target berhasil dibuat.

Setelah migrasi, Anda dapat melakukan tugas berikut:

• Verifikasi data di server fleksibel Anda dan pastikan data tersebut adalah salinan instans sumber yang tepat.

• Pasca verifikasi, aktifkan opsi ketersediaan tinggi di server fleksibel Anda sesuai kebutuhan.

• Ubah SKU server fleksibel agar sesuai dengan kebutuhan aplikasi. Perubahan ini memerlukan menghidupkan ulang server database.

• Jika Anda mengubah parameter server apa pun dari nilai defaultnya di instans sumber, salin nilai parameter server tersebut di server fleksibel.

• Salin pengaturan server lain seperti tag, pemberitahuan, dan aturan firewall (jika berlaku) dari instans sumber ke server fleksibel.

• Buat perubahan pada aplikasi Anda untuk mengarahkan string koneksi ke server fleksibel.

• Pantau performa database dengan cermat untuk melihat apakah memerlukan penyetelan performa.

Konten terkait

• Layanan migrasi
• Bermigrasi dari AWS RDS
• Praktik Terbaik
• Masalah dan batasan yang diketahui
• Penyiapan jaringan
• Validasi pramigrasi