GSP1083

Ringkasan
AlloyDB untuk PostgreSQL adalah layanan database yang kompatibel dengan PostgreSQL dan terkelola sepenuhnya untuk workload database perusahaan Anda yang paling rumit. AlloyDB menggabungkan fitur-fitur terbaik Google dengan salah satu mesin database open source terpopuler, PostgreSQL, untuk performa, skala, dan ketersediaan yang lebih unggul.
Di lab ini, Anda akan melakukan beberapa tugas dasar utama untuk membuat serta mengelola instance dan database AlloyDB untuk PostgreSQL.
Yang akan Anda lakukan
Di lab ini, Anda akan mempelajari cara melakukan tugas berikut:
- Membuat cluster dan instance.
- Membuat tabel dan memasukkan data ke database Anda
- Menggunakan Google Cloud CLI dengan AlloyDB.
- Menghapus Instance.
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. Membuat cluster dan instance
-
Pertama, buat cluster AlloyDB. Di Navigation menu (
) Konsol Cloud, klik View all products, scroll ke bawah ke bagian Databases, lalu pilih AlloyDB for PostgreSQL.
-
Klik Create cluster di bagian atas halaman.
-
Di bagian Configure your cluster, isi kolom berikut. Pastikan untuk memilih nilai Region yang tercantum di bawah. Biarkan yang lain pada nilai defaultnya.
| Item |
Nilai |
| Cluster ID |
lab-cluster |
| Password |
Change3Me |
| Region |
|
| Network |
peering-network |
-
Opsi koneksi akses layanan pribadi telah dikonfigurasi untuk project ini saat Anda memulai lab. Langkah ini diperlukan untuk mengizinkan akses ke cluster AlloyDB.
-
Di bagian Configure your primary instance, tetapkan ID instance sebagai lab-instance.
-
Pilih Multiple zones (Highly Available) di bagian Zonal availability.
-
Pilih 2 vCPU, 16 GB sebagai machine type Anda.
-
Scroll ke bagian bawah halaman, lalu klik Create Cluster.
Catatan: Pembuatan cluster akan memerlukan waktu sekitar 9 hingga 13 menit.
-
Anda sekarang berada di halaman Overview untuk cluster baru yang Anda buat. Bagian bawah berisi detail tentang instance Anda. Klik View connectivity configuration di bagian lab-instance. Harap catat alamat Private IP di bagian instance. Salin alamat Private IP ke file teks agar Anda dapat menyalinnya pada langkah berikutnya. Jangan sertakan nomor port.
-
Klik Periksa progres saya untuk memverifikasi tujuan.
Membuat cluster dan instance
Tugas 2. Membuat tabel dan memasukkan data ke database Anda
-
VM bernama alloydb-client yang berisi klien PostgreSQL telah disediakan untuk Anda di awal lab.
-
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 untuk memberikan sandi pengguna postgres (Change3Me) yang Anda masukkan saat membuat cluster.
psql -h $ALLOYDB -U postgres
- Anda akan melihat prompt terminal psql seperti yang ditunjukkan di bawah.
psql (14.5 (Debian 14.5-1.pgdg110+1), server 14.4)
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
Type "help" for help.
postgres=>
- Masukkan dan jalankan perintah SQL berikut untuk membuat tabel baru bernama regions.
CREATE TABLE regions (
region_id bigint NOT NULL,
region_name varchar(25)
) ;
ALTER TABLE regions ADD PRIMARY KEY (region_id);
- Selanjutnya, tambahkan beberapa baris data ke tabel regions. Masukkan dan jalankan perintah SQL berikut.
INSERT INTO regions VALUES ( 1, 'Europe' );
INSERT INTO regions VALUES ( 2, 'Americas' );
INSERT INTO regions VALUES ( 3, 'Asia' );
INSERT INTO regions VALUES ( 4, 'Middle East and Africa' );
- Jalankan kueri sederhana berikut untuk memverifikasi bahwa Anda telah memasukkan kumpulan data tersebut.
SELECT region_id, region_name from regions;
-
Ketik \q untuk keluar dari klien psql.
-
Opsi lain untuk membuat tabel dan/atau memuat data adalah dengan menggunakan file SQL (.sql). File SQL dapat berisi DDL, DML, atau sintaksis SQL yang didukung. Anda akan mendownload serta menjalankan file yang berisi DDL dan DML, menjalankan file tersebut, lalu memverifikasi pemuatan.
-
Jalankan perintah berikut untuk mendownload file yang berisi DDL dan DML untuk tiga tabel: countries, departments, dan jobs.
gsutil cp gs://spls/gsp1083/hrm_load.sql hrm_load.sql
- Hubungkan kembali ke klien PostgreSQL (psql). Anda akan diminta untuk memberikan sandi pengguna postgres (Change3Me).
psql -h $ALLOYDB -U postgres
- Jalankan perintah berikut untuk memproses file sql.
\i hrm_load.sql
- Jalankan perintah berikut untuk melihat tabel yang dimuat ke dalam database Anda.
\dt
List of relations
Schema | Name | Type | Owner
--------+-------------+-------+----------
public | countries | table | postgres
public | departments | table | postgres
public | jobs | table | postgres
public | regions | table | postgres
(4 rows)
- Jalankan kueri pemeriksaan cepat untuk memeriksa data di salah satu tabel yang baru saja Anda buat dan muat.
select job_title, max_salary
from jobs
order by max_salary desc;
-
Ketik \q untuk keluar dari klien psql.
-
Ketik exit untuk menutup jendela terminal.
-
Klik Periksa progres saya untuk memverifikasi tujuan.
Membuat dan memuat tabel
Tugas 3. Menggunakan Google Cloud CLI dengan AlloyDB
Konsol Cloud sangat berguna, tetapi dalam beberapa kasus penggunaan, Anda ingin mengelola database AlloyDB menggunakan metode lain. Layanan Google Cloud juga dapat dikelola melalui alat command line yang bernama gcloud. Cara termudah untuk menggunakan gcloud CLI adalah melalui Cloud Shell, tetapi CLI ini juga dapat diinstal di berbagai sistem operasi.
Membuat cluster dan instance dengan CLI
-
Membuat instance cluster AlloyDB melalui gcloud sangatlah mudah. Klik Activate Cloud Shell
di bagian atas Konsol Google Cloud.
-
Di Cloud Shell, buat cluster AlloyDB baru menggunakan perintah di bawah.
gcloud alloydb clusters create gcloud-lab-cluster \
--password=Change3Me \
--network=peering-network \
--region={{{primary_project.default_region|Default Region}}} \
--project={{{primary_project.project_id|Project ID}}}
- Setelah cluster dibuat, jalankan perintah berikut untuk membuat instance Primary.
Catatan: Proses pembuatan instance akan memerlukan waktu 7 hingga 9 menit.
gcloud alloydb instances create gcloud-lab-instance\
--instance-type=PRIMARY \
--cpu-count=2 \
--region={{{primary_project.default_region|Default Region}}} \
--cluster=gcloud-lab-cluster \
--project={{{primary_project.project_id|Project ID}}}
- Setelah prosesnya selesai, Anda dapat menjalankan perintah berikut untuk menampilkan daftar instance cluster AlloyDB yang tersedia di project Anda. Instance yang Anda buat sebelumnya, lab-cluster, dan yang baru saja Anda buat, gcloud-lab-cluster, akan ditampilkan dalam daftar tersebut.
gcloud alloydb clusters list
- Klik Periksa progres saya untuk memverifikasi tujuan.
Membuat cluster dan instance dengan CLI
Tugas 4. Menghapus cluster
- Cara yang sangat cepat untuk menghapus cluster adalah dengan menggunakan CLI. Jalankan perintah berikut. Opsi force juga akan menghapus instance bawahan. Opsi lain untuk menghapus cluster adalah menggunakan Konsol Cloud.
Catatan: Proses penghapusan akan memerlukan waktu 5 hingga 8 menit.
gcloud alloydb clusters delete gcloud-lab-cluster \
--force \
--region={{{primary_project.default_region|Default Region}}} \
--project={{{primary_project.project_id|Project ID}}}
- Untuk mengonfirmasi bahwa gcloud-lab-cluster telah dihapus, jalankan perintah berikut:
Jika diminta Do you want to continue (Y/n)?, tekan Y untuk melanjutkan.
gcloud alloydb clusters list
Selamat!
Anda kini memiliki pemahaman yang kuat tentang beberapa tugas utama saat menggunakan database AlloyDB untuk PostgreSQL.
Manual Terakhir Diperbarui pada 15 September 2025
Lab Terakhir Diuji pada 15 September 2025
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.