Menghubungkan psql ke database dialek PostgreSQL

Halaman ini menjelaskan cara menghubungkan psql ke database dialek PostgreSQL di Spanner. psql adalah frontend command line untuk PostgreSQL.

Anda dapat menghubungkan psql ke Spanner dengan dua cara:

  • Menggunakan Spanner PG Connector (spgc): spgc adalah wrapper CLI mandiri yang menggabungkan PGAdapter dan runtime Java minimal. PGAdapter akan dimulai dan dihentikan di latar belakang saat Anda menjalankan psql.
  • Menggunakan instance PGAdapter yang sedang berjalan: memulai dan mengelola proses proxy PGAdapter secara terpisah. Kemudian, hubungkan psql ke localhost.

Terhubung menggunakan Spanner PG Connector (spgc)

spanner-pg-connector (dengan alias spgc) memungkinkan Anda menjalankan psql tanpa menginstal Java atau Docker atau mengelola proses PGAdapter terpisah secara manual.

  1. Instal psql di PATH, dan instal spgc dengan mengikuti petunjuk di Memulai PGAdapter.

  2. Konfigurasikan Kredensial Default Aplikasi (ADC), misalnya, dengan menjalankan gcloud auth application-default login atau menetapkan GOOGLE_APPLICATION_CREDENTIALS.

  3. Jalankan psql melalui spgc dengan menentukan nama resource database lengkap:

    spgc psql -d "projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID"
    

    Atau, tetapkan GOOGLE_CLOUD_PROJECT dan SPANNER_INSTANCE (dan opsional SPANNER_DATABASE):

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    export SPANNER_INSTANCE=INSTANCE_ID
    
    spgc psql -d DATABASE_ID
    
  4. Opsional: Pastikan psql terhubung ke database dialek PostgreSQL dengan menjalankan kueri berikut:

    SELECT 1::bigint;
    

    Kueri ini tidak kompatibel dengan database dialek GoogleSQL.

Menghubungkan ke instance PGAdapter yang sedang berjalan

Jika Anda menjalankan PGAdapter sebagai proses atau container terpisah:

  1. Mulai PGAdapter di mesin yang sama dengan perintah psql.

    Untuk mengetahui informasi selengkapnya, lihat Mulai PGAdapter.

  2. Di jendela terminal, mulai psql dan tentukan localhost sebagai host server database.

    • Tentukan nomor port secara opsional jika PGAdapter dikonfigurasi untuk memproses port selain port PostgreSQL default (5432).
    • Secara opsional, tentukan satu atau beberapa perintah untuk dikirim ke database atau driver (misalnya, driver JDBC). Untuk setiap kemunculan opsi -c, Anda dapat menentukan satu perintah atau sekumpulan perintah yang dipisahkan dengan titik koma (;). Untuk informasi selengkapnya, lihat alat command line psql.

    psql -h localhost [-p PORT] [-c "COMMAND; ..."] ...

  3. Opsional: Pastikan psql berhasil terhubung ke database dialek PostgreSQL dengan mengirimkan kueri berikut:

    SELECT 1::bigint;

    Kueri ini tidak kompatibel dengan database dialek GoogleSQL.

Langkah berikutnya