Membuat dan mengkueri database AlloyDB menggunakan konsol Google Cloud

Membuat dan mengkueri database AlloyDB menggunakan konsol Google Cloud

Di AlloyDB untuk PostgreSQL, database Anda disimpan dalam cluster yang berisi instance. Dalam panduan memulai ini, Anda akan menyiapkan cluster, terhubung ke instance-nya, serta menyisipkan dan mengirimkan kueri data sampel. Untuk mengetahui informasi selengkapnya tentang arsitektur, cluster, dan instance AlloyDB, lihat Ringkasan AlloyDB.

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs.

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 APIs

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs.

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 APIs

Service Networking API diperlukan jika Anda berencana mengonfigurasi konektivitas jaringan ke AlloyDB menggunakan jaringan VPC yang berada di project yang sama Google Cloud dengan AlloyDB.

Compute Engine API dan Cloud Resource Manager API diperlukan jika Anda berencana mengonfigurasi konektivitas jaringan ke AlloyDB menggunakan jaringan VPC yang berada di project Google Cloud lain.

1. Pilih cara terhubung ke AlloyDB.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna membuat dan menghubungkan ke database AlloyDB, minta administrator untuk memberi Anda peran IAM berikut pada project Anda:

• Compute Network Admin (roles/compute.networkAdmin)
• Admin AlloyDB (roles/alloydb.admin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk membuat dan terhubung ke database AlloyDB. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat dan terhubung ke database AlloyDB:

• compute.networks.list
• compute.networks.addPeering
• compute.addresses.create
• servicenetworking.services.addPeering
• alloydb.clusters.create
• alloydb.instances.create
• alloydb.instances.login

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Buat cluster dan instance AlloyDB utamanya

Catatan: Untuk menyiapkan cluster, instance, dan jaringan dengan cepat untuk lingkungan pengembangan menggunakan antarmuka web, ikuti langkah-langkah dalam codelab ini.

1. Di konsol Google Cloud , buka halaman Clusters.

   Buka Cluster

2. Klik Buat kluster.

3. Di Configure your cluster, ikuti langkah-langkah berikut:

   1. Di kolom Cluster ID, masukkan my-cluster.

   2. Masukkan sandi. Catat sandi ini karena Anda akan menggunakannya dalam panduan memulai ini.

   3. Pertahankan versi database default.

   4. Di drop-down Region pada Lokasi, pilih region us-central1 (Iowa).

4. Di bagian Configure your primary instance, ikuti langkah-langkah berikut:

   1. Di kolom Instance ID, masukkan my-cluster-primary.

   2. Di Zonal availability, klik Single zone.

      Catatan: Meskipun kami tidak merekomendasikan instance zona tunggal untuk produksi, Anda dapat menggunakan zona tunggal dalam panduan memulai ini untuk meminimalkan biaya. Untuk mengetahui informasi selengkapnya, lihat Mengurangi biaya menggunakan instance dasar.

   3. Di drop-down Machine type, pilih jenis mesin 2 vCPU, 16 GB.

   4. Di menu drop-down Network pada Connectivity, pilih jaringan default.

      Jika Anda memiliki koneksi akses pribadi, lanjutkan ke langkah pembuatan cluster. Atau, klik Siapkan koneksi dan ikuti langkah-langkah berikut:

      1. Di Allocate an IP range, klik Use automatically assigned IP range.

      2. Klik Lanjutkan, lalu klik Buat koneksi.

   5. Pertahankan setelan default di bagian Network security.

5. Klik Buat kluster. Mungkin perlu waktu beberapa menit bagi AlloyDB untuk membuat cluster dan menampilkannya di halaman Ringkasan cluster primer.

Menghubungkan ke instance dan membuat database di AlloyDB Studio

Catatan: Untuk menghubungkan klien psql ke instance, ikuti langkah-langkah di Menghubungkan klien psql ke instance.

1. Di konsol Google Cloud , buka halaman Clusters.

   Buka Cluster

2. Klik nama cluster Anda, my-cluster, di kolom Nama resource.

3. Di panel navigasi, klik AlloyDB Studio.

4. Di halaman Login ke AlloyDB Studio, ikuti langkah-langkah berikut:

   1. Pilih metode autentikasi database.

   2. Pilih database postgres.

   3. Klik Autentikasi. Panel Explorer menampilkan daftar objek dalam database postgres.

5. Untuk membuat database, masukkan pernyataan berikut di tab Editor 1, lalu klik Run:

   CREATE DATABASE guestbook;
   

   Anda akan tahu bahwa database Anda telah dibuat saat pesan Statement executed successfully muncul di panel Results.

Terhubung ke database guestbook

1. Di konsol Google Cloud , buka halaman Clusters.

   Buka Cluster

2. Klik nama cluster Anda, my-cluster, di kolom Nama resource.

3. Di panel navigasi, klik AlloyDB Studio.

4. Di halaman Login ke AlloyDB Studio, ikuti langkah-langkah berikut:

   1. Pilih database guestbook.

   2. Pilih pengguna postgres.

   3. Masukkan sandi yang Anda buat di Membuat cluster dan instance utamanya.

   4. Klik Autentikasi. Panel Explorer menampilkan daftar objek dalam database guestbook.

Memverifikasi koneksi database Anda

1. Ikuti langkah-langkah di Menghubungkan ke database guestbook.

2. Untuk menyisipkan data sampel ke dalam database guestbook, masukkan perintah berikut di tab Editor 1:

   CREATE TABLE entries (guestName VARCHAR(255),
                         content VARCHAR(255),
                         entryID SERIAL PRIMARY KEY);
   INSERT INTO entries (guestName, content) values ('Alex', 'I got here!');
   INSERT INTO entries (guestName, content) values ('Kai', 'Me too!');
   

3. Klik Run. Pesan Statement executed successfully di panel Hasil menunjukkan bahwa data disisipkan ke dalam database Anda.

4. Untuk menghapus teks dari tab Editor 1 agar Anda dapat menjalankan perintah lain, klik Hapus.

5. Untuk memilih semua entri dalam database, masukkan kueri berikut di tab Editor 1:

   SELECT * FROM entries;
   

6. Klik Run. Output yang mirip dengan berikut akan muncul di panel Hasil:

       guestname     | content     | entryid
       --------------+-------------+---------
       Alex          | I got here! | 1
       Kai           | Me too!     | 2
   

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

1. Di konsol Google Cloud , buka halaman Clusters.

   Buka Cluster

2. Klik nama cluster Anda, my-cluster, di kolom Nama resource.

3. Klik Hapus cluster.

4. Di Delete cluster my-cluster, masukkan my-cluster untuk mengonfirmasi bahwa Anda ingin menghapus cluster Anda.

5. Klik Hapus.

6. Jika Anda membuat koneksi pribadi saat membuat cluster, buka Google Cloud konsol halaman Jaringan dan klik Hapus jaringan VPC.

Langkah berikutnya

• Pelajari cara lain untuk terhubung ke AlloyDB.

• Aktifkan akses project ke AlloyDB.

• Memberikan akses kepada pengguna lain.

• Aktifkan akses layanan pribadi.

• Pilih jenis mesin AlloyDB.

• Buat cluster AlloyDB dan instance utamanya.

• Pelajari rekomendasi ukuran.

• Hubungkan klien psql ke instance.