Membuat dan melakukan kueri database AlloyDB menggunakan Google Cloud konsol

Membuat dan melakukan kueri database AlloyDB menggunakan Google Cloud konsol

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 melakukan 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 dengan AlloyDB. Google Cloud

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

1. Pilih cara menghubungkan ke AlloyDB.

Peran yang diperlukan

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

• Compute Network Admin (roles/compute.networkAdmin)
• AlloyDB Admin (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.

Membuat cluster dan instance utama AlloyDB-nya

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

1. Di Google Cloud konsol, buka halaman Clusters.

   Buka Cluster

2. Klik Create cluster.

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 menu drop-down Region pada Location, pilih region us-central1 (Iowa).

4. Di 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 menu 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 membuat cluster. Jika tidak, klik Set up connection dan ikuti langkah-langkah berikut:

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

      2. Klik Continue , lalu klik Create connection.

   5. Pertahankan setelan default di bagian Network security.

5. Klik Create cluster. Mungkin perlu waktu beberapa menit agar AlloyDB membuat cluster dan menampilkannya di halaman Overview cluster utama.

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 Google Cloud konsol, buka halaman Clusters.

   Buka Cluster

2. Klik nama cluster Anda, my-cluster, di kolom Resource name.

3. Di panel navigasi, klik AlloyDB Studio.

4. Di halaman Sign in to AlloyDB Studio, ikuti langkah-langkah berikut:

   1. Pilih metode autentikasi database.

   2. Pilih database postgres.

   3. Klik Authenticate. Panel Explorer menampilkan daftar objek di database postgres.

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

   CREATE DATABASE guestbook;
   

   Anda akan mengetahui bahwa database Anda telah dibuat saat pesan Statement executed successfully ditampilkan di panel Results.

Menghubungkan ke database guestbook

1. Di Google Cloud konsol, buka halaman Clusters.

   Buka Cluster

2. Klik nama cluster Anda, my-cluster, di kolom Resource name.

3. Di panel navigasi, klik AlloyDB Studio.

4. Di halaman Sign in to 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 Authenticate. Panel Explorer menampilkan daftar objek di 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 kode 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 Results menunjukkan bahwa data telah disisipkan ke dalam database Anda.

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

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 ini akan muncul di panel Results:

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

Pembersihan

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

1. Di Google Cloud konsol, buka halaman Clusters.

   Buka Cluster

2. Klik nama cluster Anda, my-cluster, di kolom Resource name.

3. Klik Delete cluster.

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

5. Klik Delete.

6. Jika Anda membuat koneksi pribadi saat Anda membuat cluster, buka Google Cloud konsol halaman Networking dan klik Delete VPC network.

Langkah berikutnya

• Pelajari cara lain untuk terhubung ke AlloyDB.

• Mengaktifkan akses project ke AlloyDB.

• Memberikan akses kepada pengguna lain.

• Mengaktifkan akses layanan pribadi.

• Memilih jenis mesin AlloyDB.

• Membuat cluster AlloyDB dan instance utamanya.

• Pelajari rekomendasi ukuran.

• Menghubungkan klien psql ke instance.