Memigrasikan database ke AlloyDB untuk PostgreSQL menggunakan Database Migration Service

MySQL   |  PostgreSQL   |  PostgreSQL ke AlloyDB

Memigrasikan database ke AlloyDB untuk PostgreSQL

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Mengaktifkan API Database Migration Service.

   Peran yang diperlukan untuk mengaktifkan API

   Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

   Mengaktifkan API

2. Pastikan Anda memiliki peran Admin Migrasi Database yang ditetapkan ke akun pengguna Anda.

   Buka halaman IAM

Persyaratan

Database Migration Service menawarkan berbagai opsi database sumber dan metode konektivitas. Sumber yang berbeda akan berfungsi lebih baik dengan beberapa metode konektivitas dibandingkan dengan yang lain. Dalam panduan memulai ini, kami berasumsi bahwa Anda menggunakan database PostgreSQL mandiri di lingkungan tempat Anda dapat mengonfigurasi jaringan untuk menambahkan aturan firewall masuk. Database sumber dapat berada di lokal atau di penyedia cloud. Karena kami tidak dapat mengetahui secara spesifik lingkungan Anda, kami tidak dapat memberikan langkah-langkah mendetail mengenai konfigurasi jaringan Anda.

Dalam panduan memulai ini, Anda akan memilih PostgreSQL untuk Source database engine, AlloyDB for PostgreSQL untuk Destination database engine, dan VPC peering sebagai metode jaringan.

Membuat profil koneksi sumber

Dengan membuat profil koneksi, Anda membuat catatan yang berisi informasi tentang database sumber. Database Migration Service menggunakan informasi dalam profil koneksi untuk memigrasikan data dari database sumber ke instance database AlloyDB tujuan.

1. Buka halaman Profil koneksi Database Migration Service di konsol Google Cloud .

   Buka Halaman Profil Koneksi Database Migration Service

2. Klik CREATE PROFILE.

3. Di halaman Create a connection profile, dari daftar Profile role, pilih Source.

4. Dari daftar Database engine, pilih salah satu jenis klasifikasi berikut dari database sumber Anda:

   • Instance PostgreSQL mandiri (PostgreSQL)
   • Instance Cloud SQL untuk PostgreSQL yang ada (Cloud SQL untuk PostgreSQL)
   • Instance Amazon RDS untuk PostgreSQL (Amazon RDS untuk PostgreSQL)

   Untuk panduan memulai ini, pilih PostgreSQL.

4. Berikan informasi berikut:
   • Di kolom Connection profile name, masukkan nama profil koneksi untuk database sumber Anda, seperti My Connection Profile.
   • Gunakan Connection profile ID yang dihasilkan secara otomatis.
   • Masukkan Connectivity information:
     • Jika Anda mereplikasi dari database yang dihosting sendiri, masukkan Hostname or IP address (domain atau IP) dan Port untuk mengakses host. (Port PostgreSQL default adalah 5432.)
     • Jika Anda mereplikasi dari database Cloud SQL, pilih instance Cloud SQL dari daftar drop-down.
   • Masukkan Username dan Password untuk melakukan autentikasi ke instance sumber Anda.

5. Di bagian Connection profile region pada halaman, pilih region tempat Anda ingin menyimpan profil koneksi.

   Seperti halnya semua resource, profil koneksi disimpan di region. Pemilihan region tidak memengaruhi tugas migrasi mana yang dapat menggunakannya, atau region mana yang dapat terhubung ke lokasi data itu sendiri, tetapi dapat berdampak pada ketersediaan jika terjadi periode nonaktif regional.

6. Klik CREATE.

Membuat tugas migrasi

Database Migration Service menggunakan tugas migrasi untuk memigrasikan data dari instance database sumber ke instance database AlloyDB tujuan.

Pembuatan tugas migrasi mencakup:

• Menentukan setelan untuk tugas
• Memilih profil koneksi yang Anda buat untuk database sumber (profil koneksi sumber)
• Menentukan setelan untuk instance database AlloyDB tujuan
• Menyiapkan konektivitas antara instance database sumber dan tujuan
• Menguji tugas migrasi untuk memastikan informasi koneksi yang Anda berikan untuk tugas tersebut valid

Menentukan setelan untuk tugas migrasi

1. Buka halaman Tugas migrasi Database Migration Service di konsol Google Cloud .

   Buka Halaman Tugas Migrasi Database Migration Service

2. Klik CREATE MIGRATION JOB.

3. Pada kolom Migration job name, masukkan nama untuk tugas migrasi, seperti My Migration Job.

4. Gunakan Migration job ID yang dihasilkan secara otomatis.

5. Buka daftar drop-down Source database engine dan pilih jenis klasifikasi database sumber Anda. Dalam panduan memulai ini, pilih AlloyDB for PostgreSQL.

6. Pilih Destination region tempat instance tujuan akan dibuat.

7. Tetapkan Migration job type ke "Continuous" karena Anda ingin perubahan yang sedang berlangsung di database sumber dimigrasikan ke instance database AlloyDB tujuan.

8. Tinjau prasyarat yang diperlukan yang dibuat secara otomatis guna mencerminkan cara lingkungan harus disiapkan untuk tugas migrasi. Prasyarat ini dapat mencakup cara mengonfigurasi database sumber dan cara menghubungkannya ke instance database AlloyDB tujuan. Sebaiknya Anda menyelesaikan prasyarat tersebut pada langkah ini, tetapi Anda dapat menyelesaikannya kapan saja sebelum menguji atau memulai tugas migrasi. Untuk mengetahui informasi selengkapnya tentang prasyarat ini, lihat Mengonfigurasi sumber.

9. Klik SAVE &CONTINUE.

Menentukan informasi tentang profil koneksi sumber

1. Buka daftar drop-down Select source connection profile dan pilih profil koneksi yang Anda buat.

2. Klik SAVE &CONTINUE.

Membuat cluster AlloyDB tujuan

Cluster adalah resource tingkat atas di AlloyDB. Untuk membuat cluster tujuan:

1. Pilih jenis cluster. Database Migration Service saat ini mendukung cluster AlloyDB Highly available. Cluster ini dapat menyajikan data dari lebih dari satu zona di suatu region, tanpa kumpulan baca.
2. Klik CONTINUE.
3. Konfigurasi cluster Anda:
   1. Di kolom Cluster ID, masukkan ID untuk cluster Anda.
   2. Di kolom Password, masukkan sandi untuk pengguna postgres default. Anda akan memerlukan sandi untuk login ke database.
   3. Di kolom Network, pilih jalur jaringan untuk menentukan resource mana yang tersedia saat menetapkan konektivitas migrasi. Cluster hanya dapat dikonfigurasi dengan jalur jaringan IP pribadi. Jika Anda berencana untuk terhubung ke database sumber melalui peering VPC, pilih VPC tempat database tersebut berada.
   4. Secara opsional, pilih nama rentang IP yang dialokasikan untuk menentukan alamat IP yang dapat terhubung dengan instance Anda.
   5. Klik CONTINUE.
4. Konfigurasi instance utama Anda. Instance utama menentukan kapasitas komputasi cluster dan mendukung operasi baca dan tulis:
1. Di kolom Instance ID, masukkan ID untuk instance utama Anda.
2. Pilih jenis mesin.
3. Opsional: Tetapkan flag untuk instance Anda. Anda dapat menggunakan flag untuk menyesuaikan instance. Untuk mengetahui informasi tentang flag yang didukung, lihat dokumentasi AlloyDB. Untuk setiap flag:
   1. Klik ADD FLAG.
   2. Pilih flag dari daftar New database flag.
   3. Berikan nilai untuk flag.
   4. Klik DONE.
5. Klik SAVE &CONTINUE.
6. Konfirmasi pilihan Anda dengan mengklik CREATE DESTINATION &CONTINUE.
7. Tunggu hingga pembuatan instance tujuan selesai.

Cluster AlloyDB Anda akan berada dalam status "Bootstrapping" saat dikelola oleh Database Migration Service. Saat dalam status "Bootstrapping", Anda tidak akan dapat melakukan operasi apa pun pada cluster. Jika masih ingin menghapus cluster, Anda dapat melakukannya menggunakan gcloud dengan opsi --force.

Menyiapkan konektivitas

1. Pilih metode jaringan yang ingin Anda gunakan untuk membangun konektivitas antara database sumber dan tujuan. Untuk panduan memulai ini, gunakan daftar Connectivity method untuk memilih VPC peering sebagai metode jaringan.
2. Tinjau jaringan VPC database sumber Anda. Klik CONFIGURE &CONTINUE untuk menyelesaikan konfigurasi profil koneksi.

Mengonfigurasi database migrasi

Anda dapat memilih database yang ingin dimigrasikan.

1. Dari daftar Databases to migrate, pilih All databases.

   Semua database yang ada di sumber dipilih untuk migrasi.

2. Klik Save and continue.

Menguji dan membuat tugas migrasi

1. Tinjau setelan yang Anda pilih untuk tugas migrasi.

2. Klik TEST JOB untuk memverifikasi bahwa sumber telah dikonfigurasi dengan benar, sehingga instance sumber dan tujuan dapat berkomunikasi satu sama lain, dan tugas migrasi valid.

3. Pastikan Anda melihat status "Tests passed successfully!".

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

4. Klik CREATE &START JOB untuk membuat tugas migrasi dan langsung memulainya.

5. Klik START di kotak dialog berikutnya.

6. Di halaman Migration jobs, pastikan tugas migrasi Anda berstatus "Starting". Setelah beberapa menit, konfirmasi bahwa statusnya berubah menjadi "Running".

Memverifikasi tugas migrasi

Di bagian ini, Anda mengonfirmasi bahwa Database Migration Service menggunakan tugas migrasi untuk memigrasikan data dari instance database sumber ke instance database AlloyDB tujuan.

1. Buka halaman Clusters AlloyDB di Google Cloud konsol.

   Buka halaman Cluster AlloyDB

2. Klik entri replika baca tugas migrasi Anda.
3. Klik ikon Activate Cloud Shell yang muncul di bagian kanan atas halaman.
4. Pada perintah Cloud Shell, tekan Enter.
5. Opsional: Jika kotak dialog Authorize Cloud Shell muncul, klik Authorize.
6. Pada perintah Enter password, masukkan sandi yang Anda berikan atau yang dihasilkan Database Migration Service untuk Anda di Menentukan dan membuat instance AlloyDB tujuan.

7. Pada perintah postgres, masukkan \list untuk mencantumkan database dan memverifikasi bahwa Anda melihat instance database sumber.
8. Pada perintah postgres, masukkan \connect SOURCE_DB_NAME karena Anda ingin melihat tabel yang terkait dengan instance database ini. Nama dari perintah berubah dari postgres menjadi SOURCE_DB_NAME.
9. Pada perintah SOURCE_DB_NAME, masukkan \dt untuk melihat tabel instance ini.
10. Pada perintah SOURCE_DB_NAME, masukkan GRANT alloydbexternalsync to USER; karena Anda ingin memberikan izin kepada pengguna ini agar dapat mengakses data dalam tabel instance ini.

    Ganti USER dengan nama pengguna yang Anda gunakan untuk terhubung ke instance database tujuan.

11. Pada perintah SOURCE_DB_NAME, masukkan SELECT * from TABLE_NAME; untuk melihat informasi yang direplikasi dari tabel dalam instance database sumber Anda.
12. Pastikan Anda melihat informasi yang benar dalam tabel.

Hal ini mengonfirmasi bahwa Database Migration Service memigrasikan data.

Mempromosikan tugas migrasi

Anda siap mempromosikan tugas migrasi. Akibatnya, instance database AlloyDB tujuan menggantikan instance database sumber sebagai database utama.

1. Kembali ke halaman Migration jobs.

2. Klik tugas migrasi yang ingin Anda promosikan. Halaman Migration job details akan muncul.

3. Tunggu hingga penundaan replikasi cenderung nol.

4. Hentikan semua penulisan ke database sumber.

   Anda harus menghentikan semua penulisan ke database sumber karena, dengan mempromosikan tugas migrasi, database AlloyDB tujuan akan menjadi database utama Anda.

5. Tunggu hingga penundaan replikasi menjadi nol.

6. Klik tugas migrasi yang ingin Anda promosikan. Tugas ini harus berstatus "Running".

7. Klik PROMOTE untuk mempromosikan tugas migrasi.

8. Klik PROMOTE lagi di kotak dialog berikutnya.

9. Verifikasi bahwa tugas migrasi berstatus "Promote in progress". Setelah beberapa menit, konfirmasi bahwa statusnya berubah menjadi "Completed".

Instance database AlloyDB baru Anda siap digunakan.

Pembersihan

Agar akunAnda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut. Google Cloud

1. Gunakan Google Cloud konsol untuk menghapus tugas migrasi, profil koneksi, cluster AlloyDB, dan project jika Anda tidak memerlukannya.

Langkah berikutnya

• Baca selengkapnya tentang cara mengelola profil koneksi.
• Baca selengkapnya tentang status tugas migrasi.
• Baca selengkapnya tentang metrik tugas migrasi.