Membuat tugas migrasi ke instance tujuan yang ada

MySQL   |  PostgreSQL   |  PostgreSQL ke AlloyDB

Ringkasan

Database Migration Service menggunakan tugas migrasi untuk memigrasikan data dari instance database sumber ke instance database tujuan. Membuat tugas migrasi untuk instance tujuan yang ada mencakup:

• Menentukan setelan untuk tugas migrasi
• Memilih profil koneksi database sumber
• Memilih instance database tujuan yang ada
• Mendemosikan instance yang ada untuk mengonversinya menjadi replika baca
• Menyiapkan konektivitas antara instance database sumber dan tujuan
• Menguji tugas migrasi untuk memastikan informasi koneksi yang Anda berikan untuk tugas tersebut valid

Ada batasan tertentu yang harus Anda pertimbangkan saat ingin bermigrasi ke instance tujuan yang dibuat di luar Database Migration Service. Untuk mengetahui informasi selengkapnya, lihat Batasan Umum.

Membuat tugas migrasi menggunakan konsol Google Cloud

Database Migration Service dilengkapi dengan wizard untuk membantu Anda membuat tugas migrasi. Wizard ini terdiri dari lima panel: Mulai, Tentukan sumber, Buat tujuan, Tentukan metode konektivitas, dan Uji dan buat tugas migrasi. Informasi tentang cara mengisi setiap panel diberikan di berbagai bagian halaman ini.

Anda dapat menjeda pembuatan tugas migrasi dengan mengklik Simpan dan keluar. Semua data yang diisi hingga saat itu disimpan dalam tugas migrasi draf, dan Anda dapat mengakses tugas ini di tab Draf.

Untuk menyelesaikan pembuatan tugas migrasi, buka tab, lalu klik tugas. Alur pembuatan akan dilanjutkan dari bagian terakhir yang Anda kerjakan. Tugas akan tetap berupa draf hingga Anda mengklik Buat atau Buat dan mulai.

Menentukan setelan untuk tugas migrasi

1. Buka Tugas migrasi di konsol Google Cloud .

2. Klik Buat tugas migrasi di bagian atas halaman.

3. Berikan nama untuk tugas migrasi. Pilih nama yang mudah diingat untuk membantu Anda mengidentifikasi tugas migrasi. Jangan sertakan informasi sensitif atau informasi identitas pribadi dalam nama tugas.

4. Simpan ID tugas migrasi yang dibuat secara otomatis.

5. Pilih mesin database sumber.

6. Pilih AlloyDB untuk PostgreSQL sebagai mesin tujuan.

7. Pilih region tujuan untuk migrasi Anda. Region ini harus sama dengan region tempat database tujuan Anda berada. Setelah Anda memilih region tujuan, pilihan ini tidak dapat diubah.

8. Pilih Continuous (snapshot + perubahan yang sedang berlangsung) sebagai jenis tugas migrasi.

9. Di bagian Sebelum melanjutkan, tinjau prasyarat, klik Buka untuk melihat petunjuk yang dibuat secara otomatis yang dapat membantu memandu Anda menyiapkan database sumber untuk migrasi. Sebaiknya Anda menyelesaikan prasyarat tersebut pada langkah ini, tetapi Anda dapat menyelesaikannya kapan saja sebelum menguji, atau memulai, tugas migrasi. Untuk informasi selengkapnya, lihat Mengonfigurasi sumber.

10. Klik Simpan dan lanjutkan.

Menentukan informasi tentang profil koneksi sumber

1. Jika Anda telah membuat profil koneksi, pilih dari daftar profil koneksi yang ada.

   Jika Anda belum membuat profil koneksi, buat profil koneksi dengan mengklik Buat profil koneksi di bagian bawah menu drop-down, lalu lakukan langkah-langkah yang sama seperti dalam Membuat profil koneksi sumber.

   Sebaiknya buat profil koneksi yang ditetapkan untuk migrasi AlloyDB Anda.

2. Di bagian Sesuaikan konfigurasi dump data, klik Tampilkan konfigurasi dump data.

   Kecepatan paralelisme pembuangan data terkait dengan jumlah beban di database sumber Anda. Anda dapat menggunakan setelan berikut:

   • Optimal (direkomendasikan): Performa seimbang dengan beban optimal di database sumber.
   • Maksimum: Memberikan kecepatan dump tertinggi, tetapi dapat menyebabkan peningkatan beban pada database sumber.
   • Minimum: Menggunakan jumlah resource komputasi terendah di database sumber, tetapi mungkin memiliki throughput dump yang lebih lambat.

   Jika Anda ingin menggunakan setelan paralelisme dump data yang disesuaikan, pastikan untuk meningkatkan parameter max_replication_slots, max_wal_senders, dan max_worker_processes di database sumber Anda. Anda dapat memverifikasi konfigurasi dengan menjalankan pengujian tugas migrasi di akhir pembuatan tugas migrasi.

3. Klik Simpan dan lanjutkan.

Jika database sumber Anda adalah instance Cloud SQL dan hanya mengaktifkan IP publik, pastikan untuk mengaktifkan IP pribadinya sebelum melanjutkan ke bagian berikutnya. Jangan lupa untuk memperbarui profil koneksi dengan IP pribadi.

Memilih instance tujuan

Catatan: Untuk sumber Cloud SQL: Jika Anda bermigrasi dari instance Cloud SQL yang menggunakan koneksi IP Pribadi ke instance Cloud SQL yang menggunakan rentang IP alamat non-RFC 1918, tambahkan rentang non-RFC 1918 ke konfigurasi jaringan instance Cloud SQL sumber Anda. Lihat Mengonfigurasi jaringan yang diizinkan dalam dokumentasi Cloud SQL.

1. Dari menu Jenis cluster tujuan, pilih Cluster yang ada.

1. Di bagian Select destination cluster, pilih cluster tujuan Anda.

2. Tinjau informasi tentang cluster Anda, lalu klik Select and continue.

3. Untuk bermigrasi ke database tujuan yang ada, Database Migration Service akan mendemosikan instance target dan mengonversinya menjadi replika. Untuk menunjukkan bahwa penurunan dapat dilakukan dengan aman, di jendela konfirmasi, masukkan ID instance tujuan.

4. Klik Konfirmasi dan lanjutkan.

Menyiapkan konektivitas antara instance database sumber dan tujuan

Jika Anda menggunakan kembali profil koneksi sumber yang sebelumnya digunakan untuk migrasi heterogen (misalnya, dari Oracle ke Cloud SQL PostgreSQL), pada langkah ini, Anda harus memilih metode konektivitas. Metode ini akan digunakan untuk migrasi homogen dari database Cloud SQL untuk PostgreSQL ke AlloyDB. Anda harus memilih metode konektivitas karena metode konektivitas heterogen tidak relevan untuk tugas migrasi ini.

1. Dari menu drop-down Metode konektivitas, pilih metode konektivitas jaringan. Metode ini menentukan cara cluster AlloyDB yang baru dibuat akan terhubung ke database sumber. Metode konektivitas jaringan saat ini mencakup daftar yang diizinkan IP, peering VPC, tunnel SSH terbalik, dan proxy TCP melalui VM yang dihosting di cloud.

2. Jika memilih metode konektivitas jaringan daftar IP yang diizinkan, Anda harus menentukan alamat IP keluar dari instance tujuan. Salin alamat IP keluar untuk instance utama dan sekunder, lalu gunakan untuk mengonfigurasi firewall jaringan untuk server database sumber Anda dan di file pg_hba.conf, sehingga sumber dapat menerima koneksi dari alamat ini.

3. Jika Anda memilih metode konektivitas jaringan tunnel SSH terbalik, pilih instance VM Compute Engine yang akan menghosting tunnel.

   Setelah menentukan instance, Google akan memberikan skrip yang menjalankan langkah-langkah untuk menyiapkan tunnel antara database sumber dan tujuan. Anda harus menjalankan skrip di Google Cloud CLI.

   Jalankan perintah dari mesin yang memiliki konektivitas ke database sumber dan ke Google Cloud.

4. Jika Anda memilih metode konektivitas jaringan peering VPC, pilih jaringan VPC tempat database sumber berada. Instance Cloud SQL akan diupdate untuk terhubung ke jaringan ini.

5. Jika Anda memilih TCP Proxy melalui metode konektivitas VM yang dihosting cloud, masukkan detail yang diperlukan untuk instance VM Compute Engine baru yang akan menghosting proxy TCP.

   Setelah menentukan detailnya, konsol Google Cloud akan menyediakan skrip yang melakukan langkah-langkah untuk menyiapkan proxy antara database sumber dan tujuan. Anda harus menjalankan skrip di komputer dengan Google Cloud CLI yang telah diupdate.

   Setelah dijalankan, skrip akan menampilkan IP pribadi VM yang baru dibuat. Masukkan IP dan klik Configure & continue.

6. Pelajari lebih lanjut cara Mengonfigurasi konektivitas.
   Catatan: Jika sumber Anda adalah Cloud SQL untuk PostgreSQL, bergantung pada apakah instance sumber Cloud SQL Anda berada di arsitektur jaringan lama atau arsitektur jaringan baru, opsi konektivitas terbatas pada VPC Peering dan Proxy TCP melalui VM yang dihosting cloud.

7. Setelah memilih metode konektivitas jaringan dan memberikan informasi tambahan untuk metode tersebut, klik KONFIGURASI & LANJUTKAN.

Menguji dan membuat tugas migrasi

Pada langkah terakhir ini, tinjau ringkasan setelan tugas migrasi, sumber, tujuan, dan metode konektivitas, lalu uji validitas penyiapan tugas migrasi. Jika ada masalah, Anda dapat mengubah setelan tugas migrasi. Tidak semua setelan dapat diedit.

1. Klik UJI TUGAS untuk memverifikasi bahwa:

   • Database sumber telah dikonfigurasi dengan benar, berdasarkan prasyarat.
   • Instance sumber dan tujuan dapat saling berkomunikasi.
   • Semua pembaruan pada alamat IP pribadi yang diperlukan di tujuan telah dilakukan.
   • Tugas migrasi valid, dan versi sumber dan tujuan kompatibel.

   Jika pengujian gagal, Anda dapat mengatasi masalah tersebut di bagian alur yang sesuai, dan kembali untuk menguji ulang.

   Untuk mengetahui informasi selengkapnya tentang alasan pengujian mungkin gagal dan cara memecahkan masalah apa pun yang terkait dengan kegagalan pengujian, lihat Mendiagnosis masalah untuk AlloyDB.

   Tugas migrasi dapat dibuat meskipun pengujian gagal, tetapi setelah tugas dimulai, tugas tersebut mungkin gagal pada suatu saat selama proses berjalan.

2. Klik BUAT & MULAI TUGAS untuk membuat tugas migrasi dan langsung memulainya, atau klik BUAT TUGAS untuk membuat tugas migrasi tanpa langsung memulainya.

   Jika tidak dimulai pada saat dibuat, tugas dapat dimulai dari halaman Tugas migrasi dengan mengklik MULAI.

   Terlepas dari kapan tugas migrasi dimulai, organisasi Anda akan dikenai biaya untuk keberadaan instance tujuan.

   Saat Anda memulai tugas migrasi, Database Migration Service akan memulai dump penuh, yang mengunci database sumber untuk sementara. Jika sumber Anda berada di Amazon RDS atau Amazon Aurora, Database Migration Service juga memerlukan periode nonaktif operasi tulis singkat (sekitar kurang dari satu menit) pada awal migrasi. Untuk informasi selengkapnya, lihat Pertimbangan paralelisme dump data.

3. Tugas migrasi ditambahkan ke daftar tugas migrasi dan dapat dilihat secara langsung.

4. Lanjutkan ke Meninjau tugas migrasi.

Membuat tugas migrasi menggunakan Google Cloud CLI

Saat bermigrasi ke instance yang ada menggunakan Google Cloud CLI, Anda harus membuat profil koneksi untuk instance tujuan secara manual. Hal ini tidak diperlukan saat Anda menggunakan konsol Google Cloud , karena Database Migration Service akan membuat dan menghapus profil koneksi tujuan untuk Anda.

Sebelum memulai

Sebelum menggunakan gcloud CLI untuk membuat tugas migrasi ke instance database tujuan yang ada, pastikan Anda:

• Buat instance database tujuan Anda.
• Siapkan instance database sumber Anda. Lihat:
  • Mengonfigurasi sumber
  • Buat profil koneksi sumber (ID profil koneksi sumber diperlukan untuk membuat tugas migrasi.)
  • Mengonfigurasi konektivitas

Membuat profil koneksi tujuan

Buat profil koneksi tujuan untuk instance tujuan yang ada dengan menjalankan perintah gcloud database-migration connection-profiles create:

Contoh ini menggunakan flag --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati flag --no-async untuk menjalankan perintah secara asinkron. Jika ya, Anda harus menggunakan perintah gcloud database-migration operations describe untuk memverifikasi apakah operasi Anda berhasil.

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

• CONNECTION_PROFILE_ID dengan ID yang dapat dibaca mesin untuk profil koneksi Anda.
• REGION dengan ID region tempat Anda ingin menyimpan profil koneksi.
• DESTINATION_INSTANCE_ID dengan ID instance instance tujuan Anda.
• (Opsional) CONNECTION_PROFILE_NAME dengan nama yang mudah dibaca untuk profil koneksi Anda. Nilai ini ditampilkan di konsol Google Cloud .

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 connection-profiles \
create postgresql CONNECTION_PROFILE_ID \
  --no-async \
  --alloydb-cluster=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

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 connection-profiles `
create postgresql CONNECTION_PROFILE_ID `
  --no-async `
  --alloydb-cluster=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

Windows (cmd.exe)

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

gcloud database-migration connection-profiles ^
create postgresql CONNECTION_PROFILE_ID ^
  --no-async ^
  --alloydb-cluster=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

Anda akan melihat respons seperti berikut:

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

Membuat tugas migrasi

Catatan: Contoh berikut menunjukkan skenario migrasi saat Anda menggunakan konektivitas IP Pribadi antara database sumber dan tujuan. Jika Anda menggunakan jenis konektivitas yang berbeda (misalnya peering VPC atau tunnel SSH terbalik), pastikan untuk menambahkan flag yang diperlukan, seperti --peer-vpc, atau --vm, --vm-ip, --vm-port, --vpc. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi konektivitas dan Contoh Google Cloud CLI.

Catatan: Hanya jenis migrasi berkelanjutan yang didukung untuk migrasi ke AlloyDB.

Contoh ini menggunakan flag --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati flag --no-async untuk menjalankan perintah secara asinkron. Jika ya, Anda harus menggunakan perintah gcloud database-migration operations describe untuk memverifikasi apakah operasi Anda berhasil.

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

• MIGRATION_JOB_ID dengan ID yang dapat dibaca mesin untuk tugas migrasi Anda. Anda menggunakan nilai ini untuk menangani tugas migrasi menggunakan perintah atau API Google Cloud CLI Database Migration Service.
• REGION dengan ID region tempat Anda ingin menyimpan tugas migrasi.
• MIGRATION_JOB_NAME dengan nama yang dapat dibaca manusia untuk tugas migrasi Anda. Nilai ini ditampilkan di Database Migration Service di konsol Google Cloud .
• SOURCE_CONNECTION_PROFILE_ID dengan ID profil koneksi sumber yang dapat dibaca mesin.
• DESTINATION_CONNECTION_PROFILE_ID dengan ID yang dapat dibaca mesin dari profil koneksi tujuan.

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 \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --type=CONTINUOUS \

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 `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --type=CONTINUOUS `

Windows (cmd.exe)

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

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --type=CONTINUOUS ^

Anda akan melihat respons seperti berikut:

Waiting for migration job [MIGRATION_JOB_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created migration job MIGRATION_JOB_ID [OPERATION_ID]

Mendemosikan database tujuan

Database Migration Service mengharuskan instance database tujuan berfungsi sebagai replika baca selama migrasi. Sebelum memulai tugas migrasi, jalankan perintah gcloud database-migration migration-jobs demote-destination untuk mendemosikan instance database tujuan.

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

• MIGRATION_JOB_ID dengan ID tugas migrasi Anda.

  Jika tidak mengetahui ID-nya, 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 \
demote-destination 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 `
demote-destination 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 ^
demote-destination MIGRATION_JOB_ID ^
  --region=REGION

Hasil

Tindakan dilakukan secara asinkron. Dengan demikian, perintah ini menampilkan Entitas 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: demote-destination
name: OPERATION_ID

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

• Gunakan perintah gcloud database-migration migration-jobs describe untuk melihat status tugas migrasi.
• Gunakan gcloud database-migration operations describe dengan OPERATION_ID untuk melihat status operasi itu sendiri.

Mengelola tugas migrasi

Pada tahap ini, tugas migrasi Anda dikonfigurasi dan terhubung ke instance database tujuan. Anda dapat mengelolanya menggunakan operasi verify,start, stop, restart, dan resume.

Memverifikasi tugas migrasi

Sebaiknya verifikasi tugas migrasi Anda terlebih dahulu, dengan menjalankan perintah gcloud database-migration migration-jobs verify.

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

• MIGRATION_JOB_ID dengan ID tugas migrasi Anda.

  Jika tidak mengetahui ID-nya, 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 \
verify 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 `
verify 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 ^
verify MIGRATION_JOB_ID ^
  --region=REGION

Hasil

Tindakan dilakukan secara asinkron. Dengan demikian, perintah ini menampilkan Entitas 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: verify
name: OPERATION_ID

Untuk melihat apakah operasi berhasil, Anda dapat membuat kueri 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.

Memulai tugas migrasi

Mulai tugas migrasi dengan menjalankan perintah gcloud database-migration migration-jobs start.

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

• MIGRATION_JOB_ID dengan ID tugas migrasi Anda.

  Jika tidak mengetahui ID-nya, 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 \
start 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 `
start 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 ^
start MIGRATION_JOB_ID ^
  --region=REGION

Hasil

Tindakan dilakukan secara asinkron. Dengan demikian, perintah ini menampilkan Entitas 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 berhasil, Anda dapat membuat kueri 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.

Mempromosikan tugas migrasi

Setelah migrasi mencapai fase Change Data Capture (CDC), Anda dapat mempromosikan instance database target dari replika baca ke instance mandiri. Jalankan perintah gcloud database-migration migration-jobs promote:

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

• MIGRATION_JOB_ID dengan ID tugas migrasi Anda.

  Jika tidak mengetahui ID-nya, 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 dilakukan secara asinkron. Dengan demikian, perintah ini menampilkan Entitas 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 berhasil, Anda dapat membuat kueri 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.