Memigrasikan database ke Cloud SQL untuk PostgreSQL

MySQL   |  PostgreSQL   |  PostgreSQL ke AlloyDB

Memigrasikan database ke Cloud SQL untuk PostgreSQL

Panduan memulai ini menunjukkan cara menggunakan Database Migration Service untuk memigrasikan data ke Cloud SQL untuk PostgreSQL. Resource yang dibuat dalam panduan memulai ini biasanya berharga kurang dari satu dolar (USD), dengan asumsi bahwa Anda menyelesaikan langkah-langkahnya, termasuk pembersihannya, secara tepat waktu.

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 dan IP allowlist 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 Cloud SQL 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.
   • (Opsional) Jika Anda berencana mentransfer informasi sensitif melalui jaringan publik (dengan menggunakan daftar IP yang diizinkan), sebaiknya gunakan enkripsi SSL/TLS untuk koneksi antara database sumber dan tujuan. Jika tidak, pertahankan nilai default None.

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 Cloud SQL 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 Cloud SQL 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.

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 Cloud SQL 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 Cloud SQL 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.

Menentukan setelan untuk instance Cloud SQL tujuan

1. Berikan ID Instance Tujuan untuk instance Cloud SQL. Secara default, ID tugas migrasi sudah diisi sebelumnya di kolom ini. Anda dapat mempertahankan nama ini atau memasukkan nama lain.

2. Berikan sandi alfanumerik untuk instance Cloud SQL tujuan. Ini akan menjadi sandi untuk akun administrator postgres dalam instance.

   Anda dapat memasukkan sandi secara manual atau mengklik BUAT agar Database Migration Service membuat sandi untuk Anda secara otomatis.

   Tips: Untuk melihat sandi dalam teks yang jelas, klik ikon Tampilkan. Ikon ini terlihat seperti mata.

3. Pilih Versi database untuk instance tujuan dari daftar versi Cloud SQL yang didukung untuk mesin database yang ditentukan.

4. Pilih Google Cloud Zona yang diinginkan untuk instance Cloud SQL baru (atau biarkan sebagai "Any").

5. Centang kotak Public IP karena, untuk panduan memulai cepat ini, Anda menggunakan daftar IP yang diizinkan sebagai metode jaringan. Metode ini berfungsi dengan mengonfigurasi server database sumber agar menerima koneksi dari alamat IP keluar instance Cloud SQL.

   Untuk metode jaringan lainnya, seperti tunnel SSH terbalik, peering VPC, atau VPN, centang kotak IP Pribadi.

6. Pilih Jenis mesin untuk instance Cloud SQL. Ukuran disk harus sama dengan atau lebih besar dari ukuran database sumber.

7. Tentukan Jenis penyimpanan dan Kapasitas penyimpanan untuk instance Cloud SQL.

8. Klik BUAT & LANJUTKAN untuk membuat instance baru.

9. Klik BUAT TUJUAN & LANJUTKAN di kotak dialog berikutnya. Mungkin perlu waktu beberapa menit untuk membuat instance.

   Penting: Prosedur ini akan membuat instance Cloud SQL. Anda akan ditagih sesuai dengan konfigurasi yang Anda pilih.
   Catatan: Setelah instance tujuan dibuat, beberapa setelan tugas migrasi tidak dapat lagi diedit. Anda tidak dapat mengubah mesin database atau jenis migrasi.

Menyiapkan konektivitas

1. Pilih metode jaringan yang ingin Anda gunakan untuk membangun konektivitas antara database sumber dan tujuan. Untuk panduan memulai cepat ini, gunakan daftar Connectivity method untuk memilih IP allowlist sebagai metode jaringan.

   Daftar IP yang diizinkan adalah fitur keamanan yang sering digunakan untuk membatasi dan mengontrol akses ke data di database sumber dan tujuan Anda hanya untuk pengguna terpercaya. Anda dapat menggunakan daftar IP yang diizinkan untuk membuat daftar alamat IP atau rentang IP terpercaya yang dapat digunakan oleh pengguna untuk mengakses data ini. Selain itu, untuk menggunakan daftar IP yang diizinkan, Anda harus membuka database sumber atau firewall ke koneksi masuk dari instance Cloud SQL tujuan.

   Mungkin perlu waktu beberapa menit agar alamat IP muncul di kolom Alamat IP keluar tujuan.

2. Jika alamat IP sumber tidak diisi otomatis di kolom ini, salin alamat IP keluar instance Cloud SQL dari konsol, dan gunakan untuk mengonfigurasi firewall jaringan untuk server database sumber agar menerima koneksi dari alamat IP ini.
   
   1. Perbarui file pg_hba.conf atau grup keamanan Amazon RDS untuk menerima koneksi dari alamat IP ini.
   2. Dalam aturan firewall, buat aturan Masuk (atau Ingress) untuk mengizinkan koneksi di port 5432 dari alamat IP konektivitas instance Cloud SQL tujuan.
3. 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 Cloud SQL tujuan.

1. Buka halaman SQL Instances di Google Cloud console.
2. Klik entri replika baca tugas migrasi Anda.
3. Klik ikon Activate Cloud Shell yang muncul di area kanan atas halaman.
4. Pada prompt Google Cloud Shell, tekan Enter.
5. Opsional: Jika kotak dialog Authorize Cloud Shell muncul, klik Authorize.
6. Hubungkan ke instance database Cloud SQL tujuan.
7. Pada perintah Masukkan sandi, masukkan sandi yang Anda berikan atau yang dibuat oleh Database Migration Service untuk Anda di Tentukan setelan untuk instance Cloud SQL tujuan.

8. Pada perintah postgres, masukkan \list untuk mencantumkan database dan memverifikasi bahwa Anda melihat instance database sumber.
9. 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.
10. Pada perintah SOURCE_DB_NAME, masukkan \dt untuk melihat tabel instance ini.
11. Pada perintah SOURCE_DB_NAME, masukkan GRANT cloudsqlexternalsync 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.

12. Pada perintah SOURCE_DB_NAME, masukkan SELECT * from TABLE_NAME; untuk melihat informasi yang direplikasi dari tabel dalam instance database sumber Anda.
13. 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 Cloud SQL tujuan akan 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 Cloud SQL 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 Cloud SQL 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, instance Cloud SQL, 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.