Mengelola tugas migrasi

Di konsol Google Cloud , Anda dapat melakukan tindakan secara massal untuk tugas migrasi yang memiliki status yang sama. Anda dapat melakukan tindakan pada satu tugas migrasi di konsol Google Cloud dan menggunakan Google Cloud CLI.

Anda dapat melakukan tindakan berikut pada tugas migrasi:

Tindakan	Deskripsi
Edit	Anda dapat mengedit tugas migrasi non-draf untuk melakukan perubahan berikut: Perbarui nama tampilan tugas migrasi dengan gcloud CLI. Untuk mengetahui informasi selengkapnya, lihat Mengedit tugas migrasi non-draf. Tambahkan atau hapus database dari tugas migrasi Anda. Untuk mengetahui informasi selengkapnya, lihat Menambahkan atau menghapus database.
Awal	Mulai tugas migrasi yang tidak dalam status Berjalan atau Memulai. Lihat Status tugas migrasi.
Berhenti	Menghentikan tugas migrasi yang sedang berjalan. Perpindahan data dijeda. Status tugas migrasi akan berubah terlebih dahulu menjadi Stopping lalu menjadi Stopped. Anda dapat melanjutkan, menghapus, atau mempromosikan tugas migrasi yang dihentikan.
Lanjutkan	Jika menghentikan tugas migrasi selama pemuatan inkremental, Anda dapat melanjutkannya nanti. Saat Anda melanjutkan tugas migrasi, Database Migration Service akan mengambil semua file log transaksi yang terakumulasi saat tugas migrasi dihentikan.
Mulai ulang	Anda dapat memulai ulang tugas migrasi yang mengalami error dan tidak dapat melanjutkan replikasi data. Hasil memulai ulang tugas migrasi bergantung pada salah satu alasan kegagalannya berikut: Tugas migrasi yang gagal dan tidak dapat dipulihkan dari error akan mencoba ulang seluruh proses migrasi, termasuk pemuatan awal file cadangan lengkap. Jika replikasi gagal karena error pada satu atau beberapa database sumber atau tujuan, memulai ulang migrasi akan menghapus semua data dari database tujuan. Jika Anda membuat folder baru untuk database lain setelah memulai migrasi dan menambahkannya ke database yang dipilih untuk migrasi, maka memulai ulang migrasi juga akan mereplikasi database baru ke instance tujuan.
Hapus	Tugas migrasi dapat dihapus. Hasilnya bergantung pada status tugas: Jika tugas migrasi berstatus Completed, maka data akan dihapus dari daftar tugas migrasi. Jika tugas migrasi berada dalam status lain, ada opsi untuk memilih untuk menghapus pasangan primer/instance Cloud SQL tujuan.
Promosikan	Selama proses migrasi, database Cloud SQL for SQL Server tujuan Anda akan diaktifkan dalam mode pemulihan yang dikelola sepenuhnya oleh Database Migration Service. Anda tidak dapat melakukan operasi baca atau tulis apa pun pada database tujuan hingga Anda mempromosikan tugas migrasi atau database yang dipilih. Untuk mengetahui informasi selengkapnya, lihat Mempromosikan migrasi.
Lihat	Anda dapat melihat detail database tertentu dalam tugas migrasi atau semua database yang Anda pilih 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 Tugas migrasi

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

   Halaman detail tugas migrasi akan terbuka.

3. Klik Mulai.
4. Di dialog, klik Mulai.

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 dilakukan secara asinkron. Oleh karena itu, 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 Anda 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.

Menghentikan tugas migrasi

Anda dapat menghentikan tugas migrasi yang sedang berjalan kapan saja dengan melakukan langkah-langkah berikut:

Konsol

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

   Buka Tugas migrasi

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

   Halaman detail tugas migrasi akan terbuka.

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

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 dilakukan secara asinkron. Oleh karena itu, 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: stop
name: OPERATION_ID

Untuk melihat apakah operasi Anda 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.

Melanjutkan tugas migrasi

Anda dapat melanjutkan tugas migrasi yang dihentikan dengan melakukan langkah-langkah berikut:

Konsol

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

   Buka Tugas migrasi

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

   Halaman detail tugas migrasi akan terbuka.

3. Klik Lanjutkan.
4. Dalam 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 dilakukan secara asinkron. Oleh karena itu, 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: resume
name: OPERATION_ID

Untuk melihat apakah operasi Anda 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.

Memulai ulang tugas migrasi

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

Konsol

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

   Buka Tugas migrasi

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, di toolbar tugas migrasi, klik Mulai Ulang.

     Dialog mulai ulang tugas migrasi akan muncul.

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

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

4. Pada dialog, klik Mulai Ulang.

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.

• Opsional: Database Migration Service memigrasikan semua database di sumber Anda secara default. Jika Anda hanya ingin memigrasikan database tertentu, gunakan tanda --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 --database-filter flag 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 dilakukan secara asinkron. Oleh karena itu, 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: restart
name: OPERATION_ID

Untuk melihat apakah operasi Anda 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.

Memperbarui tugas migrasi draf

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

Konsol

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

   Buka Tugas migrasi

2. Di tab Draf, 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 tanda --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati tanda --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 mudah 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 profil koneksi tujuan yang dapat dibaca mesin.
• Konfigurasi pencadangan diferensial: Anda dapat mengonfigurasi apakah tugas migrasi dapat menggunakan file pencadangan diferensial dari bucket Cloud Storage. Tambahkan salah satu flag berikut ke perintah Anda:
  • --sqlserver-diff-backup untuk mengaktifkan file pencadangan diferensial untuk migrasi Anda
  • --no-sqlserver-diff-backup untuk menonaktifkan file cadangan diferensial untuk migrasi Anda

  Untuk mengetahui informasi selengkapnya tentang file cadangan yang didukung, lihat Jenis file cadangan yang didukung.

• COMMA_SEPARATED_DATABASE_ID_LIST dengan daftar ID database yang dipisahkan koma dari SQL Server yang ingin Anda migrasikan dari file cadangan Anda.

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 \
  --sqlserver-databases=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 `
  --sqlserver-databases=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 ^
  --sqlserver-databases=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

Untuk menambahkan database baru ke tugas migrasi, Anda harus membuat folder khusus baru terlebih dahulu di bucket Cloud Storage dan mengupload file cadangan ke sana. Lihat Mengonfigurasi bucket Cloud Storage.

Setelah Anda memiliki file cadangan yang diperlukan di bucket Cloud Storage, lakukan langkah-langkah berikut:

Konsol

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

   Buka Tugas migrasi

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

   Halaman detail tugas migrasi akan terbuka.

3. Klik Edit.
4. Di bagian Pilih database yang akan dimigrasikan, gunakan kotak centang untuk memilih database baru yang ingin Anda tambahkan ke tugas migrasi atau hapus database yang ingin Anda hapus.
5. (Opsional) Jika Anda menggunakan cadangan terenkripsi, berikan kunci enkripsi untuk cadangan Anda. Untuk mengetahui detail selengkapnya tentang penggunaan cadangan terenkripsi, lihat Menggunakan cadangan terenkripsi.

   Melakukan tindakan berikut:

   • Klik Edit detail di samping database yang Anda pilih untuk migrasi.

     Panel samping Enkripsi akan terbuka.

   • Gunakan menu Kunci enkripsi untuk memilih kunci Anda.
   • Di kolom Password, masukkan sandi kunci enkripsi.
   • Klik Simpan dan keluar.

gcloud

Contoh ini menggunakan tanda --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati tanda --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.
• COMMA_SEPARATED_DATABASE_ID_LIST dengan daftar ID database yang dipisahkan koma dari SQL Server yang ingin Anda migrasikan dari file cadangan Anda. ID ini harus sama dengan nama folder database di Cloud Storage Anda.

  Contoh: --sqlserver-databases=my-business-database,my-other-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 migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

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 `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

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 ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

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]

Mengedit tugas migrasi non-draf

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

Contoh ini menggunakan tanda --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati tanda --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 mudah 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 tugas migrasi draf 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 dilakukan secara asinkron. Oleh karena itu, 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 Anda 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.

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 tanda --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati tanda --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 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.

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 tanda --no-async opsional sehingga semua operasi dilakukan secara sinkron. Artinya, beberapa perintah mungkin memerlukan waktu beberapa saat untuk diselesaikan. Anda dapat melewati tanda --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 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.