GSP1084

Ringkasan

Di Google Cloud, Anda dapat menggunakan Database Migration Service untuk memigrasikan database PostgreSQL ke AlloyDB untuk PostgreSQL. Untuk melakukannya, AlloyDB memerlukan penggunaan akses layanan pribadi. Akses ini akan digunakan sebagai koneksi peering VPC antara jaringan VPC Anda dengan jaringan VPC Google Cloud tempat resource AlloyDB Anda berada.

Di lab ini, Anda akan memigrasikan database PostgreSQL mandiri (berjalan di virtual machine) ke AlloyDB untuk PostgreSQL menggunakan tugas Database Migration Service berkelanjutan melalui koneksi peering VPC.

Memigrasikan database melalui Database Migration Service memerlukan beberapa langkah penyiapan database sumber. Tugas ini telah diselesaikan untuk Anda di lingkungan sumber, dengan menyiapkan paket pglogical di instance sumber sebagai langkah terpenting.

Setelah membuat dan menjalankan tugas migrasi, pastikan salinan awal database Anda telah berhasil dimigrasikan ke instance AlloyDB untuk PostgreSQL. Anda juga akan mempelajari cara tugas migrasi berkelanjutan menjalankan pembaruan data dari database sumber ke instance AlloyDB untuk PostgreSQL.

Yang akan Anda lakukan

Di lab ini, Anda akan mempelajari cara mengonfigurasi tugas Database Migration Service berkelanjutan untuk memigrasikan database dari instance PostgreSQL ke AlloyDB untuk PostgreSQL.

• Memverifikasi Data di Instance Sumber untuk migrasi
• Membuat profil untuk koneksi sumber ke instance PostgreSQL (misalnya, PostgreSQL mandiri)
• Membuat dan memulai tugas migrasi berkelanjutan
• Mengonfirmasi pemuatan data di Instance AlloyDB untuk PostgreSQL
• Mendistribusikan pembaruan real-time ke Instance AlloyDB

Penyiapan dan persyaratan

Sebelum mengklik tombol Start Lab

Baca petunjuk ini. Lab memiliki timer dan Anda tidak dapat menjedanya. Timer yang dimulai saat Anda mengklik Start Lab akan menampilkan durasi ketersediaan resource Google Cloud untuk Anda.

Lab interaktif ini dapat Anda gunakan untuk melakukan aktivitas lab di lingkungan cloud sungguhan, bukan di lingkungan demo atau simulasi. Untuk mengakses lab ini, Anda akan diberi kredensial baru yang bersifat sementara dan dapat digunakan untuk login serta mengakses Google Cloud selama durasi lab.

Untuk menyelesaikan lab ini, Anda memerlukan:

• Akses ke browser internet standar (disarankan browser Chrome).

Catatan: Gunakan jendela Samaran (direkomendasikan) atau browser pribadi untuk menjalankan lab ini. Hal ini akan mencegah konflik antara akun pribadi Anda dan akun siswa yang dapat menyebabkan tagihan ekstra pada akun pribadi Anda.

• Waktu untuk menyelesaikan lab. Ingat, setelah dimulai, lab tidak dapat dijeda.

Catatan: Hanya gunakan akun siswa untuk lab ini. Jika Anda menggunakan akun Google Cloud yang berbeda, Anda mungkin akan dikenai tagihan ke akun tersebut.

Cara memulai lab dan login ke Google Cloud Console

1. Klik tombol Start Lab. Jika Anda perlu membayar lab, dialog akan terbuka untuk memilih metode pembayaran. Di sebelah kiri ada panel Lab Details yang berisi hal-hal berikut:

   • Tombol Open Google Cloud console
   • Waktu tersisa
   • Kredensial sementara yang harus Anda gunakan untuk lab ini
   • Informasi lain, jika diperlukan, untuk menyelesaikan lab ini

2. Klik Open Google Cloud console (atau klik kanan dan pilih Open Link in Incognito Window jika Anda menjalankan browser Chrome).

   Lab akan menjalankan resource, lalu membuka tab lain yang menampilkan halaman Sign in.

   Tips: Atur tab di jendela terpisah secara berdampingan.

   Catatan: Jika Anda melihat dialog Choose an account, klik Use Another Account.

3. Jika perlu, salin Username di bawah dan tempel ke dialog Sign in.

   {{{user_0.username | "Username"}}}

   Anda juga dapat menemukan Username di panel Lab Details.

4. Klik Next.

5. Salin Password di bawah dan tempel ke dialog Welcome.

   {{{user_0.password | "Password"}}}

   Anda juga dapat menemukan Password di panel Lab Details.

6. Klik Next.

   Penting: Anda harus menggunakan kredensial yang diberikan lab. Jangan menggunakan kredensial akun Google Cloud Anda. Catatan: Menggunakan akun Google Cloud sendiri untuk lab ini dapat dikenai biaya tambahan.

7. Klik halaman berikutnya:

   • Setujui persyaratan dan ketentuan.
   • Jangan tambahkan opsi pemulihan atau autentikasi 2 langkah (karena ini akun sementara).
   • Jangan mendaftar uji coba gratis.

Setelah beberapa saat, Konsol Google Cloud akan terbuka di tab ini.

Catatan: Untuk mengakses produk dan layanan Google Cloud, klik Navigation menu atau ketik nama layanan atau produk di kolom Search.

Mengaktifkan Cloud Shell

Cloud Shell adalah mesin virtual yang dilengkapi dengan berbagai alat pengembangan. Mesin virtual ini menawarkan direktori beranda persisten berkapasitas 5 GB dan berjalan di Google Cloud. Cloud Shell menyediakan akses command-line untuk resource Google Cloud Anda.

1. Klik Activate Cloud Shell di bagian atas Konsol Google Cloud.

2. Klik jendela berikut:

   • Lanjutkan melalui jendela informasi Cloud Shell.
   • Beri otorisasi ke Cloud Shell untuk menggunakan kredensial Anda guna melakukan panggilan Google Cloud API.

Setelah terhubung, Anda sudah diautentikasi, dan project ditetapkan ke Project_ID, . Output berisi baris yang mendeklarasikan Project_ID untuk sesi ini:

Project Cloud Platform Anda dalam sesi ini disetel ke {{{project_0.project_id | "PROJECT_ID"}}}

gcloud adalah alat command line untuk Google Cloud. Alat ini sudah terinstal di Cloud Shell dan mendukung pelengkapan command line.

3. (Opsional) Anda dapat menampilkan daftar nama akun yang aktif dengan perintah ini:

gcloud auth list

4. Klik Authorize.

Output:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} Untuk menetapkan akun aktif, jalankan: $ gcloud config set account `ACCOUNT`

5. (Opsional) Anda dapat menampilkan daftar ID project dengan perintah ini:

gcloud config list project

Output:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Catatan: Untuk mendapatkan dokumentasi gcloud yang lengkap di Google Cloud, baca panduan ringkasan gcloud CLI.

Tugas 1. Memverifikasi Data di Instance Sumber untuk migrasi

Memverifikasi Data di Instance Sumber

Pada langkah ini, hubungkan dan verifikasi data dalam database postgres di Instance VM pg14-source.

1. Pada Navigation menu (), di bagian Compute Engine, klik VM instances.

2. Untuk instance bernama pg14-source, di kolom Connect, klik SSH untuk membuka jendela terminal.

3. Gunakan perintah berikut untuk meluncurkan klien PostgreSQL (psql).

sudo -u postgres psql

4. Anda akan melihat perintah terminal psql, mirip dengan yang di bawah ini.

psql (14.5 (Debian 14.5-1.pgdg110+1)) Type "help" for help.

5. Masukkan dan jalankan perintah SQL berikut untuk melihat tabel terkait HR di database postgres.

\dt

6. Jalankan kueri berikut guna menentukan jumlah baris untuk tiap tabel.

select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;

7. Jumlah baris tabel sumber adalah sebagai berikut.

Nama	Baris
countries	25
departments	27
employees	107
jobs	19
locations	23
regions	4

8. Ketik \q untuk keluar dari klien psql.

9. Ketik exit untuk menutup jendela terminal.

Tugas 2. Membuat profil koneksi Database Migration Service untuk database PostgreSQL mandiri

Dalam tugas ini, Anda akan membuat profil koneksi untuk instance sumber PostgreSQL.

Mendapatkan informasi koneksi dan deployment untuk instance sumber PostgreSQL

Pada langkah ini, Anda akan mencari tahu alamat IP internal instance database sumber yang akan Anda migrasikan ke AlloyDB.

1. Pada Navigation menu (), di bagian Compute Engine, klik VM instances.

2. Temukan baris untuk instance pg14-source.

3. Salin nilai Internal IP (misalnya, 10.128.15.208).

Membuat profil koneksi baru untuk instance sumber PostgreSQL

Profil koneksi menyimpan informasi tentang instance database sumber (misalnya, PostgreSQL mandiri) dan digunakan oleh Database Migration Service untuk memigrasikan data dari sumber ke instance AlloyDB untuk PostgreSQL tujuan. Setelah dibuat, profil koneksi dapat digunakan ulang untuk tugas migrasi lainnya.

Pada langkah ini, Anda akan membuat profil koneksi baru untuk instance sumber PostgreSQL.

1. Di Konsol Google Cloud, pada Navigation menu (), klik View All products di bagian Databases, lalu klik Database Migration > Connection profiles.

2. Klik + Create Profile.

3. Untuk Profile Role, pilih Source.

4. Untuk Database engine, pilih PostgreSQL.

5. Untuk Connection profile name, masukkan pg14-source.

6. Untuk Region, pilih .

7. Di bagian Define connection configurations, klik DEFINE

8. Untuk Hostname or IP address, masukkan IP internal untuk instance sumber PostgreSQL yang Anda salin di tugas sebelumnya (misalnya, 10.128.15.208)

9. Untuk Port, masukkan 5432.

10. Untuk Username, masukkan postgres.

11. Untuk Password, masukkan Change3Me.

12. Untuk semua setelan lainnya, gunakan nilai default.

13. Klik Save

14. Klik Buat.

Profil koneksi baru bernama pg14-source akan muncul dalam daftar profil Koneksi.

12. Klik Periksa progres saya untuk memverifikasi tujuan. Membuat profil koneksi untuk instance sumber PostgreSQL

Tugas 3. Membuat dan memulai tugas migrasi berkelanjutan

Saat membuat tugas migrasi baru, Anda harus menentukan terlebih dahulu instance database sumber menggunakan profil koneksi yang telah dibuat sebelumnya. Kemudian, buat instance database tujuan baru dan atur konfigurasi koneksi antara instance sumber dan tujuan.

Dalam tugas ini, Anda akan memakai antarmuka tugas migrasi guna membuat cluster AlloyDB untuk PostgreSQL baru dan menetapkannya sebagai tujuan untuk tugas migrasi berkelanjutan dari instance sumber PostgreSQL.

Membuat tugas migrasi berkelanjutan baru

Pada langkah ini, Anda akan membuat tugas migrasi berkelanjutan baru.

1. Di Konsol Google Cloud, pada Navigation menu (), klik View All products. Di bagian Databases, klik Database Migration > Migration jobs.

2. Klik + Create Migration Job.

3. Untuk Migration job name, masukkan postgres-to-alloydb.

4. Untuk Source database engine, pilih PostgreSQL.

5. Untuk Destination database engine, pilih AlloyDB for PostgreSQL.

6. Untuk Destination region, pilih .

7. Saat ini, Continuous adalah satu-satunya opsi Migration job type yang tersedia untuk PostgreSQL ke AlloyDB.

8. Gunakan opsi default untuk setelan lainnya.

9. Klik Save & Continue.

Menentukan instance sumber

Pada langkah ini, Anda akan menentukan instance sumber untuk migrasi.

1. Untuk Select source connection profile, pilih profil koneksi pg14-source yang Anda buat pada salah satu langkah sebelumnya.

2. Klik Save & Continue.

Membuat instance tujuan

Pada langkah ini, wizard DMS akan membuat cluster dan instance AlloyDB untuk Anda.

1. Untuk Type of destination cluster, opsi yang sudah dipilih adalah New cluster.

2. Klik Continue untuk Review the cluster configuration.

3. Untuk Cluster ID, masukkan alloydb-target-cluster.

4. Untuk Password, masukkan Change3Me.

5. Untuk Network, pilih peering-network.

6. Klik Continue.

7. Untuk Instance ID, masukkan alloydb-target-instance.

8. Pilih 2 vCPU, 16 GB sebagai machine type Anda.

9. Klik Save & Continue.

10. Di jendela pop-up, klik Create Destination & Continue untuk melanjutkan.

11. Saat instance dan cluster AlloyDB sedang dibuat, Anda dapat memilih VPC peering dari daftar opsi Connectivity method.

12. Harap tunggu hingga cluster dan instance selesai dibuat. Link Configure & Continue akan tersedia setelah database tersedia.

13. Klik Configure & Continue.

14. Di halaman Select objects to migrate, di bagian Databases to migrate, pilih All databases.

15. Klik Save & Continue.

Menguji dan memulai tugas migrasi berkelanjutan

Pada langkah ini, Anda akan menguji dan memulai tugas migrasi.

1. Wizard Database Migration Service sekarang akan berada di langkah Test and create your migration job.

2. Klik Test Job.

3. Setelah pengujian berhasil, klik Create & Start Job.

Catatan: Anda harus mengklik Create & Start Job agar tugas Anda dapat dimulai. Link yang satunya hanya akan membuat dan menyimpan detail pekerjaan.

Jika diminta untuk mengonfirmasi, klik Create & Start.

Meninjau status tugas migrasi berkelanjutan

Pada langkah ini, Anda akan mengonfirmasi bahwa tugas migrasi berkelanjutan sedang berjalan.

1. Di Konsol Google Cloud, pada Navigation menu (), klik View All products. Di bagian Databases, klik Database Migration > Migration jobs.

2. Klik tugas migrasi postgres-to-alloydb untuk melihat halaman detail.

3. Periksa status tugas migrasi.

• Jika tugas belum dimulai, statusnya akan ditunjukkan sebagai Not started. Anda dapat memilih untuk memulai atau menghapus tugas.
• Begitu tugas dimulai, statusnya akan menunjukkan Starting, lalu berubah menjadi Running Full dump in progress untuk menandakan bahwa dump database awal sedang diproses.
• Status tugas akan berubah menjadi Running CDC in progress setelah pemuatan awal selesai dan DMS tersedia untuk operasi berkelanjutan.

Setelah status tugas menjadi Running CDC in progress, Anda dapat beralih ke langkah berikutnya.

Tugas 4. Mengonfirmasi pemuatan data di Instance AlloyDB untuk PostgreSQL

Memeriksa Instance AlloyDB untuk PostgreSQL

1. Di Navigation menu () Konsol Cloud, klik View All products, lalu di bagian Databases, klik AlloyDB untuk PostgreSQL, lalu Clusters untuk memeriksa detail cluster.

2. Cluster diberi nama alloydb-target-cluster dan instance diberi nama alloydb-target-cluster-primary.

3. Harap catat alamat Private IP di bagian instance. Salin alamat Private IP ke file teks agar Anda dapat menyalinnya pada langkah berikutnya.

4. Pada Navigation menu (), di bagian Compute Engine, klik VM instances.

5. Untuk instance bernama alloydb-client, di kolom Connect, klik SSH untuk membuka jendela terminal.

6. Tentukan variabel lingkungan berikut dengan mengganti ALLOYDB_ADDRESS dengan alamat Private IP instance AlloyDB.

export ALLOYDB=ALLOYDB_ADDRESS

7. Jalankan perintah berikut untuk menyimpan alamat Private IP instance AlloyDB di VM klien AlloyDB agar tetap ada selama lab.

echo $ALLOYDB > alloydbip.txt

8. Hubungkan klien psql dan jalankan kueri berikut untuk memverifikasi bahwa kelima tabel sumber kini berada di instance AlloyDB. Anda akan diminta untuk memberikan sandi pengguna postgres (Change3Me) yang ditetapkan saat cluster dibuat.

psql -h $ALLOYDB -U postgres \dt List of relations Schema | Name | Type | Owner --------+-------------+-------+--------------------- public | countries | table | alloydbexternalsync public | departments | table | alloydbexternalsync public | employees | table | alloydbexternalsync public | jobs | table | alloydbexternalsync public | locations | table | alloydbexternalsync public | regions | table | alloydbexternalsync (6 rows)

9. Jalankan kueri berikut untuk menentukan jumlah baris untuk tabel yang dimigrasikan. Nilai akan cocok dengan output kueri di instance sumber.

select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;

10. Jumlah baris tabel target adalah sebagai berikut.

Nama	Baris
countries	25
departments	27
employees	107
jobs	19
locations	23
regions	4

11. Jalankan kueri berikut untuk memverifikasi data di tabel regions.

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa (4 rows) .

Tugas 5. Mendistribusikan pembaruan real-time ke Instance AlloyDB

1. Karena tugas Database Migration Service dikonfigurasi untuk pembaruan berkelanjutan, setiap pembaruan yang Anda lakukan pada instance sumber akan diterapkan ke target AlloyDB terkait.

2. Pada Navigation menu (), di bagian Compute Engine, klik VM instances.

3. Untuk instance bernama pg14-source, di kolom Connect, klik SSH untuk membuka jendela terminal.

4. Gunakan perintah berikut untuk meluncurkan klien PostgreSQL (psql).

sudo -u postgres psql

5. Anda akan melihat prompt terminal psql. Masukkan dan jalankan perintah SQL berikut untuk menambahkan satu baris data ke tabel regions.

insert into regions values (5, 'Oceania');

6. Konfirmasi bahwa baris telah disisipkan secara lokal.

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa 5 | Oceania (5 rows)

Meninjau data di instance AlloyDB untuk PostgreSQL

1. Kembali ke shell terminal untuk alloydb-client. Klien psql akan tetap terbuka. Jalankan kueri berikut untuk memverifikasi bahwa baris Oceania telah ditambahkan ke instance AlloyDB target.

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa 5 | Oceania (5 rows)

2. Klik Periksa progres saya untuk memverifikasi tujuan. Menguji migrasi data berkelanjutan

Selamat!

Anda telah berhasil memigrasikan database PostgreSQL mandiri (berjalan di virtual machine) ke AlloyDB untuk PostgreSQL menggunakan tugas Database Migration Service berkelanjutan.

Manual Terakhir Diperbarui pada 14 Februari 2025

Lab Terakhir Diuji pada 14 Februari 2025

Hak cipta 2025 Google LLC. Semua hak dilindungi undang-undang. Google dan logo Google adalah merek dagang dari Google LLC. Semua nama perusahaan dan produk lain mungkin adalah merek dagang masing-masing perusahaan yang bersangkutan.