Memigrasikan database ke AlloyDB untuk PostgreSQL

MySQL   |  PostgreSQL   |  PostgreSQL ke AlloyDB

Memigrasikan database ke AlloyDB untuk PostgreSQL

Sebelum memulai

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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. Enable the Database Migration Service API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the 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 cepat ini, kami mengasumsikan bahwa Anda menggunakan database PostgreSQL mandiri di lingkungan tempat Anda dapat mengonfigurasi jaringan untuk menambahkan aturan firewall masuk. Database sumber dapat berupa database 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 BUAT PROFIL.

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

4. Dari daftar Mesin database, 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 for PostgreSQL)

   Untuk panduan memulai ini, pilih PostgreSQL.

4. Berikan informasi berikut:
   • Di kolom Nama profil koneksi, masukkan nama profil koneksi untuk database sumber Anda, seperti My Connection Profile.
   • Biarkan ID profil koneksi yang dibuat otomatis.
   • Masukkan Informasi konektivitas:
     • Jika Anda mereplikasi dari database yang dihosting sendiri, masukkan Nama host atau alamat IP (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 menu 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 memengaruhi ketersediaan jika terjadi periode nonaktif regional.

6. Klik BUAT.

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 Nama tugas migrasi, masukkan nama untuk tugas migrasi, seperti My Migration Job.

4. Pertahankan ID tugas migrasi yang dibuat otomatis.

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

6. Pilih Region tujuan tempat instance tujuan akan dibuat.

7. Tetapkan Jenis tugas migrasi ke "Berkelanjutan" 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 selesaikan prasyarat ini 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 Anda.

9. Klik SIMPAN & LANJUTKAN.

Menentukan informasi tentang profil koneksi sumber

1. Buka menu drop-down Pilih profil koneksi sumber, lalu pilih profil koneksi yang Anda buat.

2. Klik SIMPAN & LANJUTKAN.

Buat cluster AlloyDB tujuan

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

1. Pilih jenis cluster. Database Migration Service saat ini mendukung cluster AlloyDB Highly available. Layanan ini dapat menyajikan data dari lebih dari satu zona dalam suatu region, tanpa kumpulan baca.
2. Klik LANJUTKAN.
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 Anda.
   3. Di kolom Network, pilih jalur jaringan untuk menentukan resource mana yang tersedia saat menyetel 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 LANJUTKAN.
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 tanda untuk menyesuaikan instance. Untuk mengetahui informasi tentang tanda yang didukung, lihat dokumentasi AlloyDB. Untuk setiap tanda:
   1. Klik TAMBAHKAN BENDERA.
   2. Pilih tanda dari daftar Tanda database baru.
   3. Berikan nilai untuk tanda.
   4. Klik SELESAI.
5. Klik SIMPAN & LANJUTKAN.
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 KONFIGURASI & LANJUTKAN 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 Simpan dan lanjutkan.

Menguji dan membuat tugas migrasi

1. Tinjau setelan yang Anda pilih untuk tugas migrasi.

2. Klik UJI TUGAS 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 BUAT & MULAI TUGAS untuk membuat tugas migrasi dan langsung memulainya.

5. Klik START di kotak dialog berikutnya.

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

Memverifikasi tugas migrasi

Di bagian ini, Anda akan 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 konsol Google Cloud .

   Buka halaman Cluster AlloyDB

2. Klik entri replika baca tugas migrasi Anda.
3. Klik ikon Activate Cloud Shell yang muncul di area kanan atas halaman.
4. Pada prompt Cloud Shell, tekan Enter.
5. Opsional: Jika kotak dialog Authorize Cloud Shell muncul, klik Authorize.
6. Pada perintah Masukkan sandi, masukkan sandi yang Anda berikan atau yang dibuat oleh Database Migration Service untuk Anda di Tentukan dan buat instance AlloyDB tujuan.

7. Pada perintah postgres, masukkan \list untuk mencantumkan database dan memverifikasi bahwa Anda melihat instance database sumber.
8. Pada dialog 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 telah 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 Tugas migrasi.

2. Klik tugas migrasi yang ingin Anda promosikan. Halaman Detail tugas migrasi akan muncul.

3. Tunggu hingga tren penundaan replikasi mendekati 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 jeda replikasi menjadi nol.

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

7. Klik PROMOSIKAN untuk mempromosikan tugas migrasi.

8. Klik PROMOSIKAN lagi di kotak dialog berikutnya.

9. Verifikasi bahwa tugas migrasi memiliki status "Promosikan sedang berlangsung". Setelah beberapa menit, konfirmasi bahwa statusnya berubah menjadi "Selesai".

Instance database AlloyDB baru Anda siap digunakan.

Pembersihan

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

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

Langkah berikutnya

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