Menghubungkan ke Cloud SQL untuk PostgreSQL dari Cloud Shell

Halaman ini menunjukkan cara membuat dan menghubungkan ke instance PostgreSQL serta menjalankan operasi SQL dasar menggunakan konsol Google Cloud dan klien. Resource yang dibuat dalam panduan memulai ini biasanya berbiaya lebih rendah dari satu dolar, dengan asumsi bahwa Anda menyelesaikan langkah-langkahnya, termasuk pembersihan, secara tepat waktu.

Sebelum memulai

  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. Make sure 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. Make sure that billing is enabled for your Google Cloud project.

  6. Mengaktifkan Google Cloud API yang diperlukan.

    Konsol

    Di konsol Google Cloud, buka halaman APIs.

    Buka API

    Mengaktifkan Cloud SQL Admin API.

    gcloud

    Klik tombol berikut untuk membuka Cloud Shell, yang menyediakan akses command line ke resource Google Cloud langsung dari browser. Cloud Shell dapat digunakan untuk menjalankan perintah gcloud yang disajikan di seluruh panduan memulai ini.

    Buka Cloud Shell

    Jalankan perintah gcloud services enable sebagai berikut menggunakan Cloud Shell untuk mengaktifkan API yang diperlukan untuk panduan memulai ini.:

    gcloud services enable sqladmin.googleapis.com

    Perintah ini mengaktifkan API berikut:

    • Cloud SQL Admin API

Membuat instance Cloud SQL

Dalam panduan memulai ini, Anda akan menggunakan Konsol Google Cloud. Untuk menggunakan gcloud CLI, cURL, atau PowerShell, lihat Membuat instance.

  1. Di konsol Google Cloud, buka halamanInstance Cloud SQL.

    Buka Instance Cloud SQL

  2. Klik Buat instance.
  3. Klik Pilih PostgreSQL.
  4. Di kolom Instance ID, masukkan myinstance.
  5. Di kolom Sandi, masukkan sandi untuk pengguna postgres.

  6. Klik Create instance.

    Anda akan kembali ke daftar instance. Anda dapat langsung mengklik instance baru untuk melihat detailnya, tetapi instance tidak akan tersedia untuk operasi lain sampai instance melakukan inisialisasi dan dimulai.

Menghubungkan ke instance

Dalam panduan memulai ini, kita akan menggunakan klien psql di Cloud Shell untuk terhubung ke instance Anda. Cloud Shell adalah lingkungan sandbox jarak jauh.

  1. Opsional: Jika Anda menjalankan instance PostgreSQL lokal, hentikan sebelum terhubung ke instance Cloud SQL. Jika tidak, Anda mungkin akan mengalami error seperti address already in use.

  2. Di Konsol Google Cloud, klik ikon Cloud Shell (Ikon Cloud Shell.) di pojok kanan atas.

    Setelah Cloud Shell selesai melakukan inisialisasi, pesan, seperti yang berikut ini, akan muncul: 

    Welcome to Cloud Shell! Type "help" to get started.
Your Cloud Platform project in this session is set to sample-project.
Use "gcloud config set project [PROJECT_ID]" to change to a different project.
username@sample-project:~ (sample-project)$

  3. Opsional: Jika Anda belum memberikan otorisasi kepada gcloud CLI untuk mengakses Google Cloud Platform dengan kredensial pengguna Google Anda, gunakan perintah gcloud auth login.

  4. Pada layar perintah Cloud Shell, hubungkan ke instance Cloud SQL. Gunakan perintah gcloud sql connect sebagai berikut. Ganti nama instance jika nama instance Anda berbeda.

    gcloud sql connect myinstance --user=postgres
  5. Dalam dialog, klik Authorize untuk memberikan otorisasi kepada Cloud Shell agar dapat melakukan panggilan API.

    Pesan berikut akan muncul:

    Allowlisting your IP for incoming connection for 5 minutes...done.

    Pesan ini menunjukkan bahwa alamat IP publik instance Cloud SQL Anda diizinkan untuk memiliki koneksi masuk. Setelah pesan ini, Anda akan diminta untuk memasukkan sandi.

  6. Masukkan sandi postgres Anda.

    Perintah psql akan muncul.

Membuat database dan mengupload data

  1. Buat database SQL pada instance Cloud SQL Anda: 
    CREATE DATABASE guestbook;
  2. Hubungkan ke database dengan memasukkan perintah berikut dan menentukan sandi Anda. 
    \connect guestbook;
  3. Sisipkan data sampel ke dalam database: 
    CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
                        entryID SERIAL PRIMARY KEY);
INSERT INTO entries (guestName, content) values ('first guest', 'I got here!');
INSERT INTO entries (guestName, content) values ('second guest', 'Me too!');
  4. Mengambil data: 
    SELECT * FROM entries;
     Hasilnya adalah: 
      guestname   |   content   | entryid
--------------+-------------+---------
 first guest  | I got here! |       1
 second guest | Me too!     |       2
(2 rows)
postgres=>

Pembersihan

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

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Pilih instance myinstance untuk membuka halaman Instance details.
  3. Pada panel ikon di bagian atas halaman, klik Hapus.
  4. Di jendela Hapus instance, ketik nama instance, lalu klik Hapus.

Langkah-langkah pembersihan opsional

Jika tidak menggunakan API yang diaktifkan sebagai bagian dari panduan memulai ini, Anda dapat menonaktifkannya.

  • API yang diaktifkan dalam panduan memulai ini:
    • Cloud SQL Admin API

  1. Di konsol Google Cloud, buka halaman APIs.

    Buka API

  2. Pilih Cloud SQL Admin API, lalu klik tombol Disable API.

Langkah berikutnya