Mengelola tugas migrasi

Anda dapat melakukan tindakan dari daftar tugas migrasi, dari halaman detail tugas migrasi tunggal, atau langsung dari halaman instance tujuan di Cloud SQL. Di konsol Google Cloud , Anda dapat melakukan tindakan pada beberapa tugas secara bersamaan jika semuanya memiliki status yang sama. Anda dapat melakukan tindakan pada satu tugas migrasi di konsol Google Cloud dan menggunakan Google Cloud CLI.

Anda dapat melakukan beberapa tindakan pada tugas migrasi secara keseluruhan, sementara tindakan lain (seperti memulai ulang, mempromosikan, atau melihat detail) juga dapat dilakukan pada database individual yang dipilih dalam tugas migrasi.

Anda dapat melakukan tindakan berikut pada tugas migrasi:

Tindakan	Deskripsi
Edit	Untuk melakukan perubahan berikut, edit tugas migrasi: Ubah antara memigrasikan semua database dan database tertentu. Tambahkan atau hapus database dalam status atau fase migrasi apa pun, sebanyak yang Anda perlukan. Saat Anda menghapus database, Database Migration Service akan menghentikan proses replikasi pada database tersebut, tetapi tidak menghapusnya dari instance tujuan. Untuk mengetahui informasi selengkapnya, lihat Menambahkan atau menghapus database. Edit tingkat paralelisme dump data dari tugas migrasi yang sedang berjalan. Anda harus menyimpan dan memulai ulang tugas setelah melakukan perubahan. Memperbarui nama tampilan tugas migrasi dengan gcloud CLI. Untuk mengetahui informasi selengkapnya, lihat Mengedit tugas migrasi non-draf.
Mulai	Memulai tugas migrasi yang dibuat tanpa dimulai. Anda dapat memulai tugas yang tidak dalam status Running atau Starting. Lihat Status tugas migrasi.
Berhenti	Menghentikan tugas migrasi yang sedang berjalan kapan saja. Migrasi data dihentikan, dan status tugas migrasi berubah menjadi Stopping, lalu menjadi Stopped. Jika tugas migrasi dihentikan selama fase dump penuh awal, Anda dapat menghapus atau memulai ulang tugas. Namun, log WAL akan terus terakumulasi di slot replikasi pada database sumber, yang pada akhirnya dapat menyebabkan database sumber kehabisan kapasitas disk. Selain itu, Database Migration Service terus melakukan polling untuk metrik penundaan replikasi, sehingga terus menggunakan traffic jaringan. Jika tugas migrasi dihentikan selama fase change data capture (CDC), Anda dapat melanjutkan, mempromosikan, atau menghapus tugas. Pantau slot replikasi dan kapasitas disk server database sumber Anda. Menghapus tugas migrasi akan membersihkan semua slot replikasi di sumber dan menghentikan traffic jaringan.
Resume	Jika tugas migrasi berkelanjutan dihentikan selama fase CDC, tugas tersebut dapat dilanjutkan. Melanjutkan tugas migrasi akan memulai ulang replikasi peristiwa dan perubahan data yang terakumulasi selama waktu berhenti.
Mulai ulang	Jika tugas migrasi gagal dan tidak dapat dipulihkan, atau dihentikan selama fase dump penuh awal, Anda dapat memulai ulang tugas tersebut dari awal. Memulai ulang migrasi akan menghapus total semua data dari database tujuan yang terpengaruh oleh error, dan mengambil dump penuh baru. Jika database baru dibuat di server PostgreSQL sumber sejak migrasi dimulai, memulai ulang migrasi juga akan mereplikasi database baru tersebut ke instance tujuan. Anda dapat memulai ulang semua database dalam tugas migrasi atau hanya database yang dipilih.
Hapus	Menghapus tugas migrasi. Anda dapat menghapus tugas migrasi dalam status apa pun. Namun, Anda hanya dapat menghapus tugas migrasi yang sedang berjalan di konsol Google Cloud . Hasilnya bergantung pada status tugas: Jika status tugas migrasi adalah Completed, data akan dihapus dari daftar tugas migrasi. Jika tugas migrasi berada dalam status lain, ada opsi di konsol Google Cloud untuk memilih apakah akan menghapus instance Cloud SQL tujuan. Menghapus tugas migrasi akan menghapus slot replikasi yang dialokasikan di database sumber dan menghentikan traffic jaringan. Menghapus tugas migrasi tidak akan menghapus database sumber.
Promosikan	Promosikan instance tujuan dari replika ke instance database utama mandiri, dan putuskan koneksi instance tujuan dari sumber. Anda dapat mempromosikan seluruh tugas migrasi atau mempromosikan database individual yang dipilih. Untuk mengetahui informasi selengkapnya, lihat Mempromosikan migrasi.
Melihat database tertentu	Melihat detail migrasi untuk database tertentu yang dikonfigurasi untuk migrasi.
Lihat semua database	Melihat detail migrasi untuk semua database yang dikonfigurasi untuk migrasi.

Memulai tugas migrasi

Setelah tugas migrasi dibuat sepenuhnya (yaitu, tidak disimpan dalam status draf), Anda dapat memulainya kapan saja untuk mulai memigrasikan data.

Untuk memulai tugas migrasi, lakukan langkah-langkah berikut:

Konsol

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

   Buka Migration jobs

2. Di tab Tugas, klik nama tampilan tugas migrasi yang ingin Anda mulai.

   Halaman detail tugas migrasi akan terbuka.

3. Klik Mulai.
4. Dalam dialog, klik Start.

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 \
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 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.

Menghentikan tugas migrasi

Anda dapat menghentikan tugas migrasi yang berjalan kapan saja. Saat Anda menghentikan tugas migrasi, migrasi data akan dihentikan, dan status tugas migrasi berubah menjadi Stopping, lalu menjadi Stopped.

Perhatian: Saat tugas migrasi dihentikan, log WAL akan terus terakumulasi di slot replikasi di server database sumber. Hal ini pada akhirnya dapat menyebabkan database sumber Anda kehabisan kapasitas disk. Selain itu, Database Migration Service terus melakukan polling untuk metrik penundaan replikasi, sehingga terus menggunakan traffic jaringan. Pantau slot replikasi dan kapasitas disk server database sumber Anda. Jika Anda tidak berencana untuk melanjutkan migrasi, hapus tugas migrasi untuk membersihkan slot replikasi dan menghentikan traffic jaringan.

Untuk menghentikan tugas migrasi, lakukan langkah-langkah berikut:

Konsol

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

   Buka Migration jobs

2. Di tab Tugas, klik nama tampilan tugas migrasi yang ingin Anda hentikan.

   Halaman detail tugas migrasi akan terbuka.

3. Klik Stop.
4. Pada dialog, klik Stop.

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 \
stop 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 `
stop 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 ^
stop 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: stop
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 untuk melihat status tugas migrasi.
• Gunakan gcloud database-migration operations describe dengan OPERATION_ID untuk melihat status operasi itu sendiri.

Melanjutkan tugas migrasi

Jika tugas migrasi berkelanjutan dihentikan selama fase change data capture (CDC), Anda dapat melanjutkannya. Melanjutkan tugas migrasi akan memulai ulang replikasi peristiwa dan perubahan data yang terakumulasi di database sumber saat tugas dihentikan.

Untuk melanjutkan tugas migrasi yang dihentikan, lakukan langkah-langkah berikut:

Konsol

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

   Buka Migration jobs

2. Di tab Tugas, klik nama tampilan tugas migrasi yang ingin Anda lanjutkan.

   Halaman detail tugas migrasi akan terbuka.

3. Klik Lanjutkan.
4. Pada dialog, klik Lanjutkan.

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 \
resume 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 `
resume 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 ^
resume 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: resume
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 untuk melihat status tugas migrasi.
• Gunakan gcloud database-migration operations describe dengan OPERATION_ID untuk melihat status operasi itu sendiri.

Memulai ulang tugas migrasi

Jika tugas migrasi gagal dan tidak dapat dipulihkan, atau dihentikan selama fase dump penuh awal, Anda dapat memulai ulang tugas tersebut dari awal.

Memulai ulang migrasi akan menghapus semua data dari database tujuan yang terpengaruh oleh error, dan memulai dump penuh baru. Jika database baru dibuat di server PostgreSQL sumber sejak migrasi dimulai, memulai ulang migrasi juga akan mereplikasi database baru tersebut ke instance tujuan.

Anda dapat memulai ulang semua database dalam tugas migrasi, atau memulai ulang database tertentu saja.

Untuk memulai ulang tugas migrasi, lakukan langkah-langkah berikut:

Konsol

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

   Buka Migration jobs

2. Di tab Tugas, klik nama tampilan tugas migrasi yang ingin Anda mulai ulang.

   Halaman detail tugas migrasi akan terbuka.

3. Lakukan salah satu tindakan mulai ulang berikut:

   • Jika Anda ingin memulai ulang semua database yang disertakan dalam migrasi, klik Mulai ulang di toolbar tugas migrasi.

     Dialog restart migration job akan muncul.

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

     Dialog dengan sejumlah database yang ingin Anda mulai ulang akan muncul.

4. Dalam dialog, klik Restart.

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 tugas migrasi Anda disimpan.

• Opsional: Database Migration Service memigrasikan semua database di sumber Anda secara default. Jika Anda hanya ingin memigrasikan database tertentu, gunakan flag --databases-filter dan tentukan ID-nya sebagai daftar yang dipisahkan koma.

  Contoh: --databases-filter=my-business-database,my-other-database

  Anda dapat mengedit tugas migrasi yang dibuat dengan flag --databases-filter nanti menggunakan perintah gcloud database-migration migration-jobs update.

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 \
restart 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 `
restart 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 ^
restart 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: restart
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 untuk melihat status tugas migrasi.
• Gunakan gcloud database-migration operations describe dengan OPERATION_ID untuk melihat status operasi itu sendiri.

Memperbarui draf tugas migrasi

Untuk menyelesaikan pembuatan tugas migrasi, lakukan langkah-langkah berikut:

Konsol

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

   Buka Migration jobs

2. Di tab Drafts, klik nama tampilan tugas migrasi yang ingin Anda selesaikan pembuatannya.

   Wizard pembuatan tugas migrasi akan terbuka.

3. Selesaikan pembuatan tugas migrasi. Lihat Membuat tugas migrasi.

gcloud

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.
• REGION dengan ID region tempat Anda ingin menyimpan profil koneksi.
• 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.
• COMMA_SEPARATED_DATABASE_ID_LIST dengan daftar ID database PostgreSQL yang dipisahkan koma yang ingin Anda migrasikan.

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 \
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST \
  --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 `
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST `
  --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 ^
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST ^
  --type=CONTINUOUS

Anda akan melihat respons seperti berikut:

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

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

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

Menambahkan atau menghapus database dari tugas migrasi

Anda dapat menambahkan atau menghapus database dalam status atau fase migrasi apa pun, sebanyak yang Anda perlukan. Saat Anda menghapus database, Database Migration Service akan menghentikan proses replikasi pada database tersebut, tetapi tidak akan menghapusnya dari instance Cloud SQL tujuan.

Catatan: Anda harus menyimpan tugas migrasi setelah setiap perubahan.

Untuk menambahkan atau menghapus database dari tugas migrasi, lakukan langkah-langkah berikut:

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

   Buka Migration jobs

2. Di tab Jobs, klik nama tampilan tugas migrasi Anda. Halaman detail tugas migrasi akan terbuka.
3. Klik Edit.
4. Di bagian Select databases to migrate, gunakan kotak centang untuk memilih database baru yang ingin Anda tambahkan ke tugas migrasi atau hapus centang pada database yang ingin Anda hapus.
5. Klik Simpan.

Mengedit tugas migrasi non-draf

Untuk mengedit tingkat paralelisme dump data dari tugas migrasi yang sedang berjalan, lihat Pertimbangan paralelisme. Anda harus menyimpan dan memulai ulang tugas migrasi setelah mengubah setelan paralelisme.

Untuk tugas migrasi non-draf, Anda dapat menggunakan Google Cloud CLI untuk mengubah nama tampilan tugas migrasi:

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 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.
• MIGRATION_JOB_NAME dengan nama yang dapat dibaca manusia untuk tugas migrasi Anda. Nilai ini ditampilkan di Database Migration Service 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 migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --display-name=MIGRATION_JOB_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 migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --display-name=MIGRATION_JOB_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 migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME

Anda akan melihat respons seperti berikut:

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

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

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

Menguji tugas migrasi

Sebelum menjalankan tugas migrasi, Anda dapat melakukan operasi pengujian untuk memeriksa apakah Database Migration Service dapat menjangkau semua entitas sumber dan tujuan yang diperlukan. Di konsol Google Cloud , Anda hanya dapat menguji draf tugas migrasi yang Anda buat di wizard pembuatan tugas migrasi (lihat Membuat tugas migrasi).

Dengan gcloud CLI, Anda dapat menguji tugas migrasi yang dibuat, tetapi belum dimulai.

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 \
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 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: verify
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.

Melihat detail migrasi untuk database tertentu

Setelah tugas migrasi dibuat sepenuhnya (yaitu, tidak disimpan dalam status draf), Anda dapat menggunakan Google Cloud CLI untuk melihat detail tentang database tertentu dalam tugas migrasi tersebut.

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 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.
• DATABASE_NAME dengan nama database.

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 objects lookup --migration-job=MIGRATION_JOB_ID \
  --region=REGION --database=DATABASE_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 objects lookup --migration-job=MIGRATION_JOB_ID `
  --region=REGION --database=DATABASE_NAME

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 objects lookup --migration-job=MIGRATION_JOB_ID ^
  --region=REGION --database=DATABASE_NAME

Hasil

Outputnya mirip dengan hal berikut ini:

createTime: '2025-03-21T17:05:19.211441641Z'
name: PROJECT_ID
phase: FULL_DUMP
sourceObject:
  database: DATABASE_NAME
  type: DATABASE
state: RUNNING

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 untuk melihat status tugas migrasi.
• Gunakan gcloud database-migration operations describe dengan OPERATION_ID untuk melihat status operasi itu sendiri.

Melihat detail migrasi untuk database tertentu

Setelah tugas migrasi dibuat sepenuhnya (yaitu, tidak disimpan dalam status draf), Anda dapat menggunakan Google Cloud CLI untuk mencantumkan semua database yang Anda pilih untuk tugas migrasi tersebut dan melihat detailnya.

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 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 objects list --migration-job=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 objects list --migration-job=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 objects list --migration-job=MIGRATION_JOB_ID ^
  --region=REGION

Hasil

Outputnya mirip dengan hal berikut ini:

Waiting for migration job MIGRATION_JOB_ID
to fetch source objects with OPERATION_ID

Waiting for operation OPERATION_ID to complete...done.

SOURCE_OBJECT                            STATE    PHASE      ERROR
{'database': 'db1', 'type': 'DATABASE'}  RUNNING  FULL_DUMP
{'database': 'db2', 'type': 'DATABASE'}  STOPPED  CDC        {'code': 1, 'message': 'Internal error'}

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 untuk melihat status tugas migrasi.
• Gunakan gcloud database-migration operations describe dengan OPERATION_ID untuk melihat status operasi itu sendiri.