GSP1085

Ringkasan
AlloyDB untuk PostgreSQL adalah layanan database yang kompatibel dengan PostgreSQL dan terkelola sepenuhnya untuk workload database perusahaan Anda yang paling berat. AlloyDB menggabungkan fitur-fitur terbaik Google dengan salah satu mesin database open source terpopuler, PostgreSQL, untuk memberikan performa, skala, dan ketersediaan yang unggul.
Di lab ini, Anda akan memigrasikan database PostgreSQL mandiri (yang berjalan di virtual machine) ke AlloyDB untuk PostgreSQL menggunakan alat bawaan PostgreSQL. Salah satu opsi migrasi database yang didukung oleh AlloyDB adalah impor file DMP. File DMP harus dibuat menggunakan alat pg_dump dengan setelan format direktori atau kustom. DMP harus diimpor menggunakan alat pg_restore.
Yang akan Anda lakukan
Di lab ini, Anda akan mempelajari cara melakukan tugas berikut:
- Memverifikasi Data di Instance Sumber untuk Migrasi
- Membuat file DMP database menggunakan pg_dump
- Mengimpor file DMP menggunakan pg_restore
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
-
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
-
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.
-
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.
-
Klik Next.
-
Salin Password di bawah dan tempel ke dialog Welcome.
{{{user_0.password | "Password"}}}
Anda juga dapat menemukan Password di panel Lab Details.
-
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.
-
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.
-
Klik Activate Cloud Shell
di bagian atas Konsol Google Cloud.
-
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.
- (Opsional) Anda dapat menampilkan daftar nama akun yang aktif dengan perintah ini:
gcloud auth list
- Klik Authorize.
Output:
ACTIVE: *
ACCOUNT: {{{user_0.username | "ACCOUNT"}}}
Untuk menetapkan akun aktif, jalankan:
$ gcloud config set account `ACCOUNT`
- (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
-
Pada Navigation menu (
), di bagian Compute Engine, klik VM instances.
-
Untuk instance bernama pg14-source, di kolom Connect, klik SSH untuk membuka jendela terminal.
-
Gunakan perintah berikut untuk meluncurkan klien PostgreSQL (psql).
sudo -u postgres psql
- 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.
- Masukkan dan jalankan perintah SQL berikut untuk melihat tabel terkait HR di database postgres.
\dt
List of relations
Schema | Name | Type | Owner
--------+-------------+-------+----------
public | countries | table | postgres
public | departments | table | postgres
public | employees | table | postgres
public | jobs | table | postgres
public | locations | table | postgres
public | regions | table | postgres
(6 rows)
- 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;
- Jumlah baris tabel sumber adalah sebagai berikut.
| Nama |
Baris |
| countries |
25 |
| departments |
27 |
| employees |
107 |
| jobs |
19 |
| locations |
23 |
| regions |
4 |
- Ketik \q untuk keluar dari klien psql.
Tugas 2. Membuat file DMP database menggunakan pg_dump
- Alat pg_dump diinstal secara default dengan setiap penginstalan PostgreSQL. Di terminal pg14-source, buat file DMP database postgres yang berisi tabel HR yang telah Anda periksa sebelumnya. Jalankan perintah berikut di prompt shell. Catatan: Flag '-Fc' menunjukkan file DMP format kustom.
sudo -u postgres pg_dump -Fc postgres > pg14_source.DMP
- Jelajahi direktori untuk mengonfirmasi ukuran dan detail lain file DMP tersebut.
ls -l -h pg14_source.DMP
-rw-r--r-- 1 student-03-171e0d8475af google-sudoers 13K Aug 27 21:19 pg14_source.DMP
- Untuk menyimulasikan ekspor/impor database rutin, migrasikan file DMP ke bucket Cloud Storage. Bucket yang dinamai sesuai dengan Project ID Qwiklabs Anda dibuat saat lab dimulai.
gsutil cp pg14_source.DMP gs://{{{primary_project.project_id|Project ID}}}/pg14_source.DMP
- Klik Periksa progres saya untuk memverifikasi tujuan.
Mengupload file DMP database ke Cloud Storage
Tugas 3. Mengimpor file DMP menggunakan pg_restore
-
Cluster dan instance AlloyDB telah disediakan saat Anda memulai lab. Di bagian Databases pada Navigation menu (
) Konsol Cloud, klik AlloyDB for PostgreSQL, lalu Clusters untuk memeriksa detail cluster.
-
Cluster diberi nama lab-cluster dan instance diberi nama lab-instance.
-
Harap catat alamat Private IP di bagian instance. Salin alamat Private IP ke file teks agar Anda dapat menyalinnya pada langkah berikutnya. Perlu waktu beberapa saat untuk membuat dan menginisialisasi instance sepenuhnya. Tunggu hingga Anda melihat Ready di Status untuk melanjutkan ke langkah berikutnya.
-
VM bernama alloydb-client yang berisi klien PostgreSQL telah disediakan untuk Anda di awal lab. Penginstalan ini mencakup alat pemulihan database pg_restore.
-
Pada Navigation menu (
), di bagian Compute Engine, klik VM instances.
-
Untuk instance bernama alloydb-client, di kolom Connect, klik SSH untuk membuka jendela terminal.
-
Tentukan variabel lingkungan berikut dengan mengganti ALLOYDB_ADDRESS dengan alamat Private IP instance AlloyDB.
export ALLOYDB=ALLOYDB_ADDRESS
- Jalankan perintah berikut untuk menyimpan alamat Private IP instance AlloyDB di VM klien AlloyDB agar tetap ada selama lab.
echo $ALLOYDB > alloydbip.txt
- Gunakan perintah berikut untuk meluncurkan klien PostgreSQL (psql). Anda akan diminta memberikan sandi pengguna postgres (Change3Me) yang ditetapkan saat cluster dibuat.
psql -h $ALLOYDB -U postgres
- Jalankan perintah berikut untuk mengonfirmasi bahwa database postgres saat ini kosong.
\dt
Did not find any relations.
-
Ketik \q untuk keluar dari klien psql.
-
Download file DMP dari bucket Cloud Storage ke direktori lokal.
gsutil cp gs://{{{primary_project.project_id|Project ID}}}/pg14_source.DMP pg14_source.DMP
- Jalankan perintah berikut untuk membuat file TOC yang menjadikan semua pernyataan extension sebagai komentar.
pg_restore -l pg14_source.DMP | sed -E 's/(.* EXTENSION )/; \1/g' > pg14_source_toc.toc
- Sekarang jalankan perintah restore untuk memuat tabel HR. Anda akan diminta memasukkan sandi pengguna postgres - Change3Me.
pg_restore -h $ALLOYDB -U postgres \
-d postgres \
-L pg14_source_toc.toc \
pg14_source.DMP
- Luncurkan klien PostgreSQL (psql) lagi. Anda akan diminta memasukkan sandi pengguna postgres - Change3Me.
psql -h $ALLOYDB -U postgres
- Jalankan perintah berikut untuk mengonfirmasi bahwa tabel telah dimuat.
\dt
List of relations
Schema | Name | Type | Owner
--------+-------------+-------+----------
public | countries | table | postgres
public | departments | table | postgres
public | employees | table | postgres
public | jobs | table | postgres
public | locations | table | postgres
public | regions | table | postgres
(6 rows)
- 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;
- Klik Periksa progres saya untuk memverifikasi tujuan.
Memverifikasi impor file DMP database
Selamat!
Anda telah berhasil memigrasikan database PostgreSQL mandiri (yang berjalan di virtual machine) ke AlloyDB untuk PostgreSQL menggunakan alat bawaan PostgreSQL.
Manual Terakhir Diperbarui pada 26 April 2024
Lab Terakhir Diuji pada 2 Agustus 2023
Hak cipta 2026 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.