Mempromosikan tugas migrasi

Untuk migrasi berkelanjutan, Anda dapat memulai proses promosi setelah tiba waktunya untuk memindahkan pembacaan dan penulisan ke database tujuan. Promosi berarti database Cloud SQL yang dimigrasikan kini dapat diakses untuk semua operasi baca dan tulis.

Anda dapat mempromosikan tugas migrasi atau mempromosikan database yang dipilih dari tugas migrasi.

1. Hentikan semua penulisan, skrip yang berjalan, dan koneksi klien ke database sumber. Periode nonaktif dimulai di sini.
2. Pastikan semua data yang tersedia dari file log transaksi direplikasi ke instance tujuan Cloud SQL.
3. Tunggu hingga metrik penundaan replikasi berada pada atau mendekati nol. Artinya, tugas migrasi telah memproses semua perubahan yang belum selesai.

   Anda dapat mempromosikan migrasi meskipun penundaan replikasi tidak nol. Hal ini dapat mengurangi periode nonaktif database, tetapi dapat memengaruhi akurasi data di tujuan.

4. Lakukan tindakan promosi:

   Konsol

   1. Di konsol Google Cloud , buka halaman Tugas migrasi.

      Buka Migration jobs

   2. Di tab Jobs, klik nama tampilan tugas migrasi yang ingin Anda promosikan.

   Halaman detail tugas migrasi akan terbuka.

   3. Lakukan salah satu tindakan promosi berikut:

      • Jika Anda ingin mempromosikan semua database yang disertakan dalam migrasi, klik Promote di toolbar tugas migrasi.

        Dialog promote migration job akan muncul.

      • Jika Anda hanya ingin mempromosikan database tertentu, pilih database tersebut menggunakan kotak centang di samping nama database dan di tab Databases, klik Promote.

        Dialog dengan sejumlah database yang ingin Anda promosikan akan muncul.

   4. Dalam dialog, pastikan tidak ada error yang ditampilkan, lalu klik Promote.

   gcloud

   Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

   • MIGRATION_JOB_ID dengan ID tugas migrasi Anda.

     Jika tidak mengetahui ID, Anda dapat menggunakan perintah gcloud database-migration migration-jobs list untuk mencantumkan semua tugas migrasi di region tertentu dan melihat ID-nya.

   • REGION dengan ID region tempat profil koneksi Anda disimpan.

   Jalankan perintah berikut:

   Linux, macOS, atau Cloud Shell

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration migration-jobs \
   promote MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration migration-jobs `
   promote MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud database-migration migration-jobs ^
   promote MIGRATION_JOB_ID ^
     --region=REGION

   Hasil

   Tindakan ini dilakukan secara asinkron. Oleh karena itu, perintah ini menampilkan Entity operasi yang mewakili operasi yang berjalan lama:

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: start
   name: OPERATION_ID
   

   Untuk melihat apakah operasi Anda berhasil, Anda dapat mengkueri objek operasi yang ditampilkan, atau memeriksa status tugas migrasi:

   • Gunakan perintah gcloud database-migration migration-jobs describe dengan MIGRATION_JOB_ID untuk melihat status tugas migrasi.
   • Gunakan perintah gcloud database-migration operations describe dengan OPERATION_ID untuk melihat status operasi itu sendiri.
5. Instance tujuan atau database yang Anda pilih akan dipromosikan, dan database yang dimigrasikan kini dapat diakses untuk semua operasi baca dan tulis. Status tugas migrasi berubah menjadi Completed.
6. Aplikasi kini dapat dihubungkan ke instance Cloud SQL dan tugas migrasi dapat dihapus dengan aman.

Langkah berikutnya

• Verifikasi kelengkapan data migrasi.
• Opsional: Siapkan replika baca bertingkat untuk instance Cloud SQL yang dipromosikan.