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.

Pembuatan tugas migrasi mencakup pelaksanaan tugas-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 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.

Sebelum memulai

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

    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 diperlukan untuk membuat tugas migrasi di Database Migration Service, minta administrator untuk memberi Anda peran IAM berikut pada project Anda:

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, luaskan 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 bawaan 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 Migration jobs

  2. Klik Create migration job.

    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 SAVE & EXIT. Semua data yang Anda masukkan hingga saat itu akan disimpan dalam draf tugas migrasi. Anda dapat menyelesaikan tugas migrasi draf nanti. Lihat Memperbarui draf tugas migrasi.

  3. Di halaman Get started, 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 pekerjaan migrasi

      Ini adalah ID yang dapat dibaca mesin untuk tugas migrasi Anda. Anda menggunakan nilai ini untuk menangani tugas migrasi menggunakan perintah Google Cloud CLI atau API Database Migration Service.

    • Dari daftar mesin database sumber, pilih SQL Server atau Amazon RDS for SQL Server.

    Kolom mesin database tujuan dan jenis pekerjaan 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 Create connection profile langsung di menu drop-down. Untuk mengetahui informasi selengkapnya tentang cara membuat profil koneksi, lihat Membuat profil koneksi sumber.

    2. Jika Anda ingin menggunakan file cadangan diferensial dalam migrasi, di bagian Customize source configurations, centang kotak Use differential backups.

      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 mengetahui informasi selengkapnya tentang jenis cadangan yang didukung, lihat Jenis file cadangan yang didukung.

      Jika Anda menggunakan pencadangan 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 Create connection profile langsung di menu drop-down. Untuk mengetahui informasi selengkapnya tentang cara membuat profil koneksi, lihat Membuat profil koneksi tujuan.

  7. Klik Simpan dan lanjutkan.
  8. Di halaman Configure migration databases, 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 cara menggunakan cadangan terenkripsi, lihat Menggunakan cadangan terenkripsi.

      Melakukan tindakan berikut:

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

        Panel samping Enkripsi akan terbuka.

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

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

    2. Klik Create and start job untuk memulai migrasi.

      Jika Anda ingin menjalankan tugas migrasi pada waktu yang berbeda, klik Save dan kembali lagi 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 Google Cloud CLI atau API 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 comma separated list berisi ID database SQL Server 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 mengetahui 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 mengetahui informasi selengkapnya tentang cara membuat file pemetaan ini, lihat Menggunakan cadangan terenkripsi.

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

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

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)

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)

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:

Langkah berikutnya