本頁面說明如何將 psql 連線至 Spanner 中的 PostgreSQL 方言資料庫。psql 是 PostgreSQL 的指令列前端。
您可以透過下列兩種方式將 psql 連線至 Spanner:
- 使用 Spanner PG 連接器 (
spgc):spgc是獨立的 CLI 包裝函式,內含 PGAdapter 和最小 Java 執行階段。當您執行psql時,它會在背景啟動和停止 PGAdapter。 - 使用執行中的 PGAdapter 執行個體:分別啟動及管理 PGAdapter Proxy 程序。然後將
psql連結至localhost。
使用 Spanner PG 連接器 (spgc) 連結
spanner-pg-connector (別名為 spgc) 可讓您執行 psql,不必安裝 Java 或 Docker,也不必手動管理個別的 PGAdapter 程序。
在
PATH上安裝psql,並按照「啟動 PGAdapter」中的操作說明安裝spgc。設定應用程式預設憑證 (ADC),例如執行
gcloud auth application-default login或設定GOOGLE_APPLICATION_CREDENTIALS。指定完整的資料庫資源名稱,透過
spgc執行psql:spgc psql -d "projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID"或者,您也可以設定
GOOGLE_CLOUD_PROJECT和SPANNER_INSTANCE(以及選用的SPANNER_DATABASE):export GOOGLE_CLOUD_PROJECT=PROJECT_ID export SPANNER_INSTANCE=INSTANCE_ID spgc psql -d DATABASE_ID選用:執行下列查詢,確認
psql已連線至 PostgreSQL 方言資料庫:SELECT 1::bigint;這項查詢與 GoogleSQL 方言資料庫不相容。
連線至執行中的 PGAdapter 執行個體
如果 PGAdapter 是以獨立程序或容器的形式執行:
在與
psql指令相同的機器上啟動 PGAdapter。詳情請參閱「啟動 PGAdapter」。
在終端機視窗中啟動
psql,並將localhost指定為資料庫伺服器主機。- 如果 PGAdapter 設定為監聽預設 PostgreSQL 通訊埠 (5432) 以外的通訊埠,請視需要指定通訊埠編號。
- 您可以選擇指定一或多個指令,傳送至資料庫或驅動程式 (例如 JDBC 驅動程式)。每次使用
-c選項時,您可以指定單一指令或以分號 (;) 分隔的多個指令。詳情請參閱 psql 指令列工具。
psql -h localhost [-p PORT] [-c "COMMAND; ..."] ...選用:提交下列查詢,確認
psql已成功連線至 PostgreSQL 方言資料庫:SELECT 1::bigint;這項查詢與 GoogleSQL 方言資料庫不相容。
後續步驟
- 瞭解 PGAdapter。
- 請參閱 psql 指令列工具中支援的
psql指令。