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):spgcadalah wrapper CLI mandiri yang menggabungkan PGAdapter dan runtime Java minimal. PGAdapter akan dimulai dan dihentikan di latar belakang saat Anda menjalankanpsql. - Menggunakan instance PGAdapter yang sedang berjalan: memulai dan mengelola proses proxy PGAdapter secara terpisah. Kemudian, hubungkan
psqlkelocalhost.
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.
Instal
psqldiPATH, dan instalspgcdengan mengikuti petunjuk di Memulai PGAdapter.Konfigurasikan Kredensial Default Aplikasi (ADC), misalnya, dengan menjalankan
gcloud auth application-default loginatau menetapkanGOOGLE_APPLICATION_CREDENTIALS.Jalankan
psqlmelaluispgcdengan menentukan nama resource database lengkap:spgc psql -d "projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID"Atau, tetapkan
GOOGLE_CLOUD_PROJECTdanSPANNER_INSTANCE(dan opsionalSPANNER_DATABASE):export GOOGLE_CLOUD_PROJECT=PROJECT_ID export SPANNER_INSTANCE=INSTANCE_ID spgc psql -d DATABASE_IDOpsional: Pastikan
psqlterhubung 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:
Mulai PGAdapter di mesin yang sama dengan perintah
psql.Untuk mengetahui informasi selengkapnya, lihat Mulai PGAdapter.
Di jendela terminal, mulai
psqldan tentukanlocalhostsebagai 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; ..."] ...Opsional: Pastikan
psqlberhasil terhubung ke database dialek PostgreSQL dengan mengirimkan kueri berikut:SELECT 1::bigint;Kueri ini tidak kompatibel dengan database dialek GoogleSQL.
Langkah berikutnya
- Pelajari PGAdapter.
- Lihat perintah
psqlyang didukung di alat command line psql.