Membuat dan menghubungkan ke database

Halaman ini memandu Anda melalui proses pembuatan dan koneksi ke database pertama Anda di AlloyDB untuk PostgreSQL.

Petunjuk yang diberikan di akhir panduan memulai ini akan memandu Anda membersihkan database baru ini. Halaman ini diakhiri dengan langkah-langkah berikutnya untuk mempelajari lebih lanjut cara menggunakan AlloyDB dengan aplikasi Anda sendiri.

Sebelum memulai

Konsol

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Aktifkan Cloud API yang diperlukan untuk membuat dan menghubungkan ke AlloyDB untuk PostgreSQL.

    Aktifkan API

    1. Pada langkah Confirm project, klik Next untuk mengonfirmasi nama project yang akan Anda ubah.

    2. Pada langkah Enable APIs, klik Enable untuk mengaktifkan berikut ini:

      • AlloyDB API
      • Compute Engine API
      • Cloud Resource Manager API
      • Service Networking API

      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.

gcloud

  1. Buat project Google Cloud atau gunakan project yang sudah ada:

    gcloud projects create PROJECT_ID --set-as-default
    # For an existing project
    gcloud config set project PROJECT_ID
    

    Ganti kode berikut:

    • PROJECT_ID: ID permanen untuk project.
  2. Pastikan penagihan diaktifkan untuk Google Cloud project Anda. Pelajari cara mengonfirmasi bahwa penagihan diaktifkan untuk project Anda.

  3. Aktifkan AlloyDB, Compute Engine, dan Resource Manager API:

    gcloud services enable alloydb.googleapis.com
    gcloud services enable compute.googleapis.com
    gcloud services enable cloudresourcemanager.googleapis.com
    
  4. Jika Anda berencana mengonfigurasi konektivitas jaringan ke AlloyDB menggunakan jaringan VPC yang berada di Google Cloud project yang sama dengan AlloyDB, aktifkan Service Networking API di project tersebut.

    gcloud services enable servicenetworking.googleapis.com
    
  5. Jika Anda berencana mengonfigurasi konektivitas jaringan ke AlloyDB menggunakan jaringan VPC yang berada di project Google Cloud lain, konfirmasi bahwa Compute Engine dan Service Networking API di project tersebut telah diaktifkan sehingga Anda dapat mengonfigurasi VPC Bersama dan akses layanan pribadi di project tersebut.

    gcloud services list
    

Membuat cluster dan instance utamanya

CATATAN : Jika Anda berencana menggunakan jaringan pribadi, Anda dapat men-deploy penyiapan jaringan pribadi pilihan Anda dan instance AlloyDB beserta klien seperti VM Compute Engine menggunakan Terraform. Untuk mengetahui informasi selengkapnya, lihat Solusi Konfigurasi Jaringan Cloud yang Disederhanakan.

  1. Di konsol Google Cloud , buka halaman Clusters.

    Buka Cluster

  2. Klik Buat kluster.

  3. Di Cluster ID, masukkan my-cluster.

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

  5. Pertahankan versi database default.

  6. Di bagian Lokasi, pilih region us-central1 (Iowa).

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

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

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

    2. Klik Lanjutkan, lalu klik Buat koneksi.

  8. Pertahankan ID instance default, my-cluster-primary.

  9. Di Zonal availability, pertahankan Single zone sebagai opsi yang dipilih. 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.

  10. Pilih jenis mesin 2 vCPU, 16 GB.

  11. Pertahankan setelan default di bagian Connectivity dan Network security.

  12. Jangan membuat perubahan di Tampilkan opsi lanjutan.

  13. Klik Buat kluster. Mungkin perlu waktu beberapa menit agar AlloyDB membuat cluster dan menampilkannya di halaman Overview cluster utama.

Menghubungkan ke instance dan membuat database

  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 ini 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.

  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