Membuat tugas migrasi

Database Migration Service menggunakan tugas migrasi untuk memigrasikan data dari database sumber ke instance tujuan Cloud SQL. Tugas migrasi membantu Anda mengatur profil koneksi sumber dan tujuan, menentukan setelan khusus untuk proses migrasi, memantau progres, dan menyelesaikan seluruh operasi dengan aman.

Membuat tugas migrasi mencakup tugas berikut:

• Memilih profil koneksi sumber dan tujuan.

• Memilih database yang terdeteksi di instance sumber yang ingin Anda migrasikan.

• Melakukan pengujian tugas migrasi untuk memastikan bahwa Database Migration Service dapat terhubung ke sumber dan tujuan data Anda.

• Memulai tugas migrasi, dan memantau progresnya.

• Mempromosikan tugas migrasi saat Anda ingin mengalihkan aplikasi ke instance baru.

Database Migration Service dilengkapi dengan wizard untuk membantu Anda membuat tugas migrasi. Wizard ini terdiri dari empat panel: Mulai, Menentukan sumber ke tujuan, Mengonfigurasi objek migrasi, dan Menguji serta membuat tugas migrasi. Informasi tentang cara mengisi setiap panel diberikan di berbagai bagian halaman ini.

Sebelum memulai

1. Pastikan Anda memenuhi persyaratan berikut:
   • Anda memiliki bucket Cloud Storage untuk file cadangan SQL Server.
   • File cadangan lengkap dan log transaksi Anda akan diupload ke bucket Cloud Storage.
   • Anda memiliki profil koneksi sumber untuk bucket Cloud Storage.
   • Anda telah membuat dan mengonfigurasi instance Cloud SQL tujuan untuk SQL Server, dan memiliki profil koneksi tujuan untuk instance tersebut.
2. Di konsol Google Cloud , pada halaman pemilih project, pilih atau buat project Google Cloud .

   Buka pemilih project

3. Aktifkan Database Migration Service, Compute Engine, Cloud Storage, dan Cloud SQL Admin API.

   Mengaktifkan API

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna membuat tugas migrasi di Database Migration Service, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

• Database Migration Admin (roles/datamigration.admin)
• Storage Admin (roles/storage.admin)
• Editor Cloud SQL (roles/cloudsql.editor)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk melakukan migrasi SQL Server homogen dengan Database Migration Service. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melakukan migrasi SQL Server homogen dengan Database Migration Service:

• datamigration.*
• resourcemanager.projects.get
• resourcemanager.projects.list
• cloudsql.instances.create
• cloudsql.instances.get
• cloudsql.instances.list
• cloudsql.databases.get
• cloudsql.databases.delete
• cloudsql.operations.get
• compute.machineTypes.list
• compute.machineTypes.get
• compute.projects.get
• storage.buckets.create
• storage.buckets.list
• storage.objects.list

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran standar lainnya.

Menentukan setelan dan membuat tugas migrasi

Untuk membuat tugas migrasi, lakukan langkah-langkah berikut:

Konsol

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

   Buka Tugas migrasi

2. Klik Buat tugas migrasi.

   Halaman wizard konfigurasi tugas migrasi akan terbuka. Wizard ini berisi beberapa panel yang memandu Anda melalui setiap langkah konfigurasi.

   Anda dapat menjeda pembuatan tugas migrasi kapan saja dengan mengklik SIMPAN & KELUAR. Semua data yang Anda masukkan hingga titik tersebut disimpan dalam tugas migrasi draf. Anda dapat menyelesaikan tugas migrasi draf nanti. Lihat Memperbarui tugas migrasi draf.

3. Di halaman Mulai, masukkan informasi berikut:
   • Nama tugas migrasi

     Ini adalah nama yang dapat dibaca manusia untuk tugas migrasi Anda. Nilai ini ditampilkan di konsol Google Cloud .

   • ID tugas migrasi

     Ini adalah 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.

   • Dari daftar Mesin database sumber, pilih SQL Server atau Amazon RDS untuk SQL Server.

   Kolom Mesin database tujuan dan Jenis tugas migrasi diisi secara otomatis dan tidak dapat diubah.

4. Klik Simpan dan lanjutkan.
5. Di halaman Tentukan sumber Anda, lakukan tindakan berikut:
   1. Gunakan menu drop-down untuk memilih profil koneksi sumber Anda.

      Jika belum memiliki profil koneksi sumber, Anda dapat mengklik Buat profil koneksi langsung di menu drop-down. Untuk informasi selengkapnya tentang cara membuat profil koneksi, lihat Membuat profil koneksi sumber.

   2. Jika Anda ingin menggunakan file pencadangan diferensial dalam migrasi, centang kotak Gunakan pencadangan diferensial di bagian Sesuaikan konfigurasi sumber.

      Pencadangan diferensial berguna jika Anda perlu mereplikasi banyak data yang muncul di database sejak pencadangan penuh dan Anda ingin menanganinya secara massal, bukan mengupload beberapa file log transaksi. Untuk informasi selengkapnya tentang jenis pencadangan yang didukung, lihat Jenis file pencadangan yang didukung.

      Jika Anda menggunakan cadangan diferensial, pastikan Anda membuat folder diff di bucket Cloud Storage. Lihat Menyimpan file cadangan di bucket Cloud Storage.

   3. Klik Simpan dan lanjutkan.
6. Di halaman Define a destination, gunakan menu drop-down untuk memilih profil koneksi tujuan Anda.

   Jika belum memiliki profil koneksi tujuan, Anda dapat mengklik Buat profil koneksi langsung di menu drop-down. Untuk informasi selengkapnya tentang cara membuat profil koneksi, lihat Membuat profil koneksi tujuan.

7. Klik Simpan dan lanjutkan.
8. Di halaman Konfigurasi database migrasi, lakukan tindakan berikut:
   1. Di bagian Select databases to migrate, gunakan kotak centang untuk memilih database yang ingin Anda sertakan dalam tugas migrasi ini. Daftar ini diisi berdasarkan folder yang Anda buat di bucket Cloud Storage untuk file cadangan Anda.

      Anda dapat menambahkan dan menghapus database dari tugas migrasi nanti. Lihat Menambahkan atau menghapus database dari tugas migrasi.

   2. (Opsional) Jika Anda menggunakan cadangan terenkripsi, berikan kunci enkripsi untuk cadangan Anda. Untuk mengetahui detail selengkapnya tentang penggunaan pencadangan terenkripsi, lihat Menggunakan pencadangan terenkripsi.

      Melakukan tindakan berikut:

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

        Panel samping Enkripsi akan terbuka.

      • Gunakan menu drop-down Kunci enkripsi untuk memilih kunci Anda.
      • Di kolom Password, masukkan sandi kunci enkripsi.
      • Klik Simpan dan keluar.
9. Klik Simpan dan lanjutkan.
10. Di Uji dan buat tugas migrasi, lakukan tindakan berikut:
    1. (Opsional) Klik Uji tugas untuk memverifikasi apakah Database Migration Service berhasil mengidentifikasi semua file cadangan dan membuat koneksi jaringan yang diperlukan.

       Jika pengujian gagal, Anda dapat melihat pesan error untuk mengatasi masalah tersebut, dan menjalankan pengujian lagi. Untuk mengetahui informasi selengkapnya tentang kemungkinan error, lihat Diagnosa masalah.

    2. Klik Buat dan mulai tugas untuk memulai migrasi.

       Jika Anda ingin menjalankan tugas migrasi pada waktu yang berbeda, klik Simpan dan kembali nanti untuk menjalankan tugas. Lihat Memulai 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. 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.
• COMMA_SEPARATED_DATABASE_ID_LIST dengan daftar ID database SQL Server yang dipisahkan koma yang ingin Anda migrasikan dari file cadangan. ID ini harus sama dengan nama folder database di Cloud Storage Anda.

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

• Konfigurasi pencadangan diferensial: Jika Anda menggunakan file pencadangan diferensial untuk migrasi, tambahkan flag --sqlserver-diff-backup ke perintah Anda. Secara default, tugas migrasi tidak menggunakan file cadangan diferensial dan mengabaikan folder diff di bucket Cloud Storage Anda.

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

• (Opsional) MAPPING_FILE_FOR_PATHS_TO_ENCRYPTION_KEYS dengan jalur disk lokal Anda ke file konfigurasi yang memetakan jalur ke kunci enkripsi di Cloud Storage dengan ID database yang relevan. Untuk informasi selengkapnya tentang cara membuat file pemetaan ini, lihat Menggunakan pencadangan terenkripsi.

  Contoh: --sqlserver-encrypted-databases=~/encryption-keys-mapping-file.json

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

Hasil

Tugas migrasi kini telah dibuat. Anda dapat melanjutkan proses migrasi:

• (Opsional) Lakukan pengujian tugas migrasi untuk memeriksa apakah Database Migration Service dapat menjangkau semua entitas sumber dan tujuan yang diperlukan.
• Mulai tugas migrasi untuk mulai memindahkan data Anda ke instance tujuan.

Langkah selanjutnya

• Mulai tugas migrasi
• Memantau tugas migrasi
• Mempromosikan tugas migrasi