將 psql 連線至 PostgreSQL 方言資料庫

本頁面說明如何將 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 程序。

  1. 在 PATH 上安裝 psql,並按照「啟動 PGAdapter」中的操作說明安裝 spgc。

  2. 設定應用程式預設憑證 (ADC),例如執行 gcloud auth application-default login 或設定 GOOGLE_APPLICATION_CREDENTIALS。

  3. 指定完整的資料庫資源名稱,透過 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
    
  4. 選用:執行下列查詢,確認 psql 已連線至 PostgreSQL 方言資料庫:

    SELECT 1::bigint;
    

    這項查詢與 GoogleSQL 方言資料庫不相容。

連線至執行中的 PGAdapter 執行個體

如果 PGAdapter 是以獨立程序或容器的形式執行:

  1. 在與 psql 指令相同的機器上啟動 PGAdapter。

    詳情請參閱「啟動 PGAdapter」。

  2. 在終端機視窗中啟動 psql,並將 localhost 指定為資料庫伺服器主機。

    • 如果 PGAdapter 設定為監聽預設 PostgreSQL 通訊埠 (5432) 以外的通訊埠,請視需要指定通訊埠編號。
    • 您可以選擇指定一或多個指令,傳送至資料庫或驅動程式 (例如 JDBC 驅動程式)。每次使用 -c 選項時,您可以指定單一指令或以分號 (;) 分隔的多個指令。詳情請參閱 psql 指令列工具。

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

  3. 選用:提交下列查詢,確認 psql 已成功連線至 PostgreSQL 方言資料庫:

    SELECT 1::bigint;

    這項查詢與 GoogleSQL 方言資料庫不相容。

後續步驟