Menghubungkan ke Cloud SQL untuk PostgreSQL dari Cloud Shell

Menghubungkan ke Cloud SQL untuk PostgreSQL dari Cloud Shell

MySQL   |  PostgreSQL   |  SQL Server

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

Catatan: Nama yang Anda gunakan untuk project harus terdiri dari 4 hingga 30 karakter. Saat Anda mengetik nama tersebut, formulir akan menyarankan ID project yang dapat Anda edit. ID project harus terdiri dari 6 hingga 30 karakter, dengan huruf kecil sebagai karakter pertama. Anda dapat menggunakan tanda pisah, huruf kecil, atau angka untuk karakter yang tersisa, tetapi karakter terakhir tidak boleh berupa tanda pisah.

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

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

5. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

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 Create Instance.
3. Klik Pilih PostgreSQL.
4. Masukkan myinstance untuk ID Instance.
5. Masukkan sandi untuk pengguna postgres.

6. Klik Create.

   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.

   Catatan: Dalam contoh ini, instance dibuat menggunakan setelan default, termasuk alamat IP publik.

Menghubungkan ke instance

Dalam panduan memulai ini, kita akan menggunakan klien psql di Cloud Shell untuk terhubung ke instance Anda.

Catatan: Cloud Shell tidak berfungsi dengan alamat IP pribadi. Petunjuk ini hanya untuk instance dengan alamat IP publik.

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 () di pojok kanan atas.

   Setelah Cloud Shell selesai melakukan inisialisasi, pesan, seperti yang berikut ini, akan muncul: dan 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. 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

4. Klik Authorize di kotak pesan untuk memberikan otorisasi kepada Cloud Shell agar dapat melakukan panggilan API.

   Akan muncul pesan yang menunjukkan bahwa IP Anda diizinkan untuk koneksi masuk, setelah itu Anda akan diminta untuk memasukkan sandi.

5. 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 selanjutnya

• Pelajari cara membuat instance Cloud SQL.

• Pelajari cara membuat pengguna PostgreSQL dan database untuk instance Cloud SQL Anda.

• Lihat Informasi harga Cloud SQL.

• Dalam panduan memulai ini, Anda terhubung ke instance menggunakan Cloud Shell. Pelajari semua opsi konektivitas di Cloud SQL. Cara Anda terhubung bergantung pada konfigurasi jaringan, misalnya apakah instance Cloud SQL Anda memiliki alamat IP publik atau pribadi. Lihat car mengonfigurasi instance Cloud SQL Anda dengan IP publik dan alamat private IP.

• Pelajari cara menghubungkan ke instance Cloud SQL dari aplikasi Google Cloud lainnya:

  • Dari aplikasi yang berjalan di lingkungan standar App Engine
  • Dari aplikasi yang berjalan di Compute Engine
  • Dari aplikasi yang berjalan di GKE
  • Dari Cloud Functions
  • Dari Cloud Run