將 psycopg3 連線至 PostgreSQL 方言資料庫

本頁說明如何將 PostgreSQL psycopg3 驅動程式連線至 Spanner 中的 PostgreSQL 方言資料庫。psycopg3 是 PostgreSQL 的 Python 驅動程式。

1. 確認 PGAdapter 與應用程式執行於同一部電腦，且應用程式使用 PostgreSQL psycopg3 驅動程式連線。

   export GOOGLE_APPLICATION_CREDENTIALS=/CREDENTIALS_FILE_PATH/credentials.json
   docker pull gcr.io/cloud-spanner-pg-adapter/pgadapter
   docker run \
     -d -p 5432:5432 \
     -v ${GOOGLE_APPLICATION_CREDENTIALS}:${GOOGLE_APPLICATION_CREDENTIALS}:ro \
     -e GOOGLE_APPLICATION_CREDENTIALS \
     gcr.io/cloud-spanner-pg-adapter/pgadapter \
     -p PROJECT_NAME -i INSTANCE_NAME \
     -x
   

   詳情請參閱「啟動 PGAdapter」。

2. 使用 TCP 連線至 PGAdapter。

   import psycopg
   
   with psycopg.connect("host=APPLICATION_HOST port=PORT dbname=DATABASE_NAME sslmode=disable") as conn:
     conn.autocommit = True
     with conn.cursor() as cur:
       cur.execute("select 'Hello world!' as hello")
       print("Greeting from Cloud Spanner PostgreSQL:", cur.fetchone()[0])
   

   更改下列內容：

   • APPLICATION_HOST：執行 PGAdapter 的電腦主機名稱或 IP 位址。如要在本機執行，請使用 localhost。
   • PORT：PGAdapter 執行的通訊埠號碼。如果 PGAdapter 在自訂連接埠上執行，請在連線字串中變更此設定。否則請使用預設通訊埠 5432。

Unix 網域通訊端

本節說明如何使用 Unix 網域通訊端連線至 PostgreSQL 方言資料庫。使用 Unix 網域通訊端，盡可能縮短延遲時間。

如要使用 Unix 網域通訊端，PGAdapter 必須與用戶端應用程式在同一部主機上執行。

確認已載入 PostgreSQL JDBC 驅動程式。

import psycopg

with psycopg.connect("host=/tmp
                      port=PORT
                      dbname=DATABASE_NAME") as conn:
conn.autocommit = True
with conn.cursor() as cur:
  cur.execute("select 'Hello world!' as hello")
  print("Greetings from Cloud Spanner PostgreSQL:", cur.fetchone()[0])

更改下列內容：

• /tmp：PGAdapter 的預設網域通訊端目錄。您可以使用 -dir 指令列引數變更這項設定。
• PORT：PGAdapter 執行的通訊埠號碼。如果 PGAdapter 在自訂連接埠上執行，請在連線字串中變更此設定。否則請使用預設通訊埠 5432。

後續步驟

• 進一步瞭解 PGAdapter。
• 如要進一步瞭解 PostgreSQL psycopg3 驅動程式連線選項，請參閱 PGAdapter GitHub 存放區中的 psycopg3 連線選項。