Memigrasikan database ke Cloud SQL untuk PostgreSQL menggunakan Database Migration Service

MySQL   |  PostgreSQL   |  PostgreSQL ke AlloyDB

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

1. 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.

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

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

   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

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Database Migration Service API.

   Enable the API

7. 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 dan IP allowlist sebagai metode jaringan.

Membuat profil koneksi sumber

Dengan membuat profil koneksi, Anda membuat data 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 Layanan Migrasi Database

2. Klik BUAT PROFIL.

3. Di halaman Buat profil koneksi, dari daftar Profile role, pilih Source.

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

   • Instance PostgreSQL mandiri (PostgreSQL)
   • Instance Cloud SQL untuk PostgreSQL yang ada (Cloud SQL untuk PostgreSQL)
   • Instance Amazon RDS for 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.
   • Simpan ID profil koneksi yang dibuat secara 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 mengautentikasi 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.

Membuat 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. Simpan ID tugas migrasi yang dibuat secara otomatis.

5. Buka menu 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 Anda menyelesaikan prasyarat tersebut pada langkah ini, tetapi Anda dapat menyelesaikannya kapan saja sebelum menguji tugas migrasi atau memulainya. Untuk 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 diisi otomatis 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 memulai cepat ini, Anda menggunakan daftar IP yang diizinkan sebagai metode jaringan. Metode ini berfungsi dengan mengonfigurasi server database sumber agar dapat menerima koneksi dari alamat IP keluar instance Cloud SQL.

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

6. Pilih Machine type 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 CREATE & CONTINUE untuk membuat instance baru.

9. Klik CREATE DESTINATION & CONTINUE 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 dipilih.
   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 memulai cepat ini, gunakan daftar Metode konektivitas untuk memilih Daftar IP yang diizinkan 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 tepercaya. 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, lalu gunakan untuk mengonfigurasi firewall jaringan agar server database sumber 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 Inbound (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.

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 "Pengujian berhasil".

   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 Tugas migrasi, pastikan tugas migrasi Anda berstatus "Dimulai". 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 Instance SQL di konsol Google Cloud.
2. Klik entri replika baca tugas migrasi Anda.
3. Klik ikon Aktifkan Cloud Shell yang muncul di area kanan atas halaman.
4. Pada prompt Google Cloud Shell, tekan Enter.
5. Opsional: Jika kotak dialog Izinkan Cloud Shell muncul, klik Izinkan.
6. Hubungkan ke instance database Cloud SQL tujuan.
7. Pada prompt 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 prompt 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 untuk 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 kecenderungan 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 penundaan replikasi nol.

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

7. Klik PROMOTE untuk mempromosikan tugas migrasi.

8. Klik PROMOTE lagi di kotak dialog berikutnya.

9. Verifikasi bahwa tugas migrasi memiliki status "Promosi 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 di halaman ini, ikuti langkah-langkah berikut.

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

Langkah selanjutnya

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