Menghubungkan ke cluster database

Secara default, cluster database hanya mengizinkan koneksi dari dalam cluster pengguna dan project yang sama.

Untuk mengaktifkan koneksi ke semua cluster database di project Anda dari project lain, lihat Mengaktifkan koneksi lintas project.

Untuk mengaktifkan koneksi ke cluster database dari alamat IP di luar organisasi GDC Anda, lihat Mengaktifkan koneksi eksternal.

Login ke konsol GDC dengan akun yang terikat ke peran Database Project Admin untuk menemukan informasi berikut guna terhubung ke cluster database Anda. Informasi ini ada di bagian Connectivity pada halaman Database Service.

Langkah-langkah ini mencakup contoh untuk menghubungkan ke database menggunakan psql. Langkah-langkah persisnya akan bervariasi bergantung pada software klien yang Anda pilih.

Konsol

  1. Buka bagian Connectivity di halaman Database Service untuk cluster database. Halaman ini menyertakan:

    • Sandi akun administrator (nama penggunanya adalah dbsadmin)
    • Nama host dan nomor port endpoint utama cluster database
    • Apakah cluster database mengizinkan koneksi eksternal dari luar organisasi.
    • Perintah psql untuk terhubung ke cluster
    • Link untuk mendownload sertifikat certificate authority (CA) cluster database

  2. Download sertifikat CA dari konsol GDC di bagian Connectivity pada halaman Database Service untuk cluster database Anda.

  3. Konfigurasikan klien Anda untuk menggunakan sertifikat CA guna memverifikasi database. Untuk klien psql, tetapkan variabel env PGSSLROOTCERT ke jalur file sertifikat dan variabel env PGSSLMODE ke preferensi Anda:

    export PGSSLROOTCERT=path/to/accounts_cert.pem
export PGSSLMODE="verify-full"

  4. Hubungkan ke database dari software klien Anda. Jika Anda menggunakan psql, jalankan perintah berikut:

    PGPASSWORD=DB_PASSWORD psql -h DB_HOSTNAME -p PORT -U USERNAME -d postgres

Ganti variabel berikut:

  • path/to/: jalur ke sertifikat accounts_cert.pem.
  • DB_PASSWORD: sandi dari konsol.
  • DB_HOSTNAME: nama host database dari konsol.
  • DB_PORT: nomor port database dari konsol.
  • DB_USERNAME: nama pengguna database dari konsol.

API

  1. Ambil endpoint database dari status cluster database:

    kubectl get dbcluster.postgresql.dbadmin.gdc.goog DBCLUSTER_NAME -n USER_PROJECT -o=jsonpath='{.status.primary.url}'

  2. Download sertifikat CA dari secret Kubernetes:

    kubectl get secret dbs-certificates -n USER_PROJECT -o json | jq -r '.data."dbs-pg-cert-DBCLUSTER_NAME"' | base64 -d > path/to/ca.crt

  3. Konfigurasikan klien Anda untuk menggunakan sertifikat CA guna memverifikasi database. Untuk klien psql, Anda dapat menetapkan variabel env PGSSLROOTCERT ke jalur file sertifikat dan variabel env PGSSLMODE ke preferensi Anda:

    export PGSSLROOTCERT=path/to/ca.crt
export PGSSLMODE="verify-full"

  4. Hubungkan ke database dari software klien Anda. Jika Anda menggunakan psql, jalankan perintah berikut:

    PGPASSWORD=DB_PASSWORD psql -h DB_HOSTNAME -p DB_PORT -U DB_USERNAME -d postgres

Ganti variabel berikut:

  • USER_PROJECT: nama project pengguna tempat cluster database dibuat.
  • DBCLUSTER_NAME: nama cluster database.
  • path/to/: jalur ke sertifikat CA database.
  • DB_PASSWORD: sandi database untuk pengguna administrator.
  • DB_HOSTNAME: nama host dari status cluster database.
  • DB_PORT: nomor port database dari status cluster database.
  • DB_USERNAME: dengan nama pengguna database (default-nya adalah dbsadmin).