PGAdapter 總覽

PGAdapter 會將 PostgreSQL 有線通訊協定轉譯為 Spanner gRPC 通訊協定。您可以將 PostgreSQL 應用程式和驅動程式連至 Spanner 資料庫的 Spanner PostgreSQL 介面,延遲時間負擔極低。

如要瞭解如何啟動 PGAdapter,請參閱「啟動 PGAdapter」。

您可以將 PGAdapter 做為 Sidecar Proxy,與主要應用程式一起執行,或是在應用程式 JVM 中直接執行 Java 應用程式。PGAdapter 會在 localhost 上公開支援 PostgreSQL 有線通訊協定的端點,讓 psql 等工具連線至 Spanner。

PGAdapter 最多會增加 0.2 毫秒的延遲負擔。PostgreSQL 介面的延遲時間與 GoogleSQL 相同。

下圖顯示 psql 如何透過 PGAdapter 連線至 Spanner。psql 透過 PGAdapter 連線至 Spanner。

PGAdapter 支援基本和擴充查詢模式,以及 Spanner PostgreSQL 介面支援的任何資料類型。

支援的驅動程式和 ORM

PGAdapter 支援標準 PostgreSQL 驅動程式、ORM 和用戶端工具,包括:

如需完整的相容性矩陣,請參閱「PostgreSQL 驅動程式和 ORM」。

PGAdapter 執行環境

您可以透過下列任一方法執行 PGAdapter:

  • 獨立:PGAdapter 以 JAR 檔案形式提供,並在 JVM 中獨立執行。
  • Docker。PGAdapter 也會封裝為 Docker 映像檔。
  • Cloud Run:PGAdapter 可在 Cloud Run 部署為 Sidecar Proxy。
  • Sidecar Proxy:Sidecar Proxy 的典型用途是在 Kubernetes 叢集中。
  • 程序內:Java 應用程式程式碼可以使用提供的 JAR 檔案,建立及啟動 PGAdapter 執行個體。
  • Spanner PG 連接器 (spgc):spanner-pg-connector (別名為 spgc) 是獨立的 CLI 包裝函式,用於執行 PostgreSQL 指令列工具,例如 psql 和 pg_dump。其中包含 PGAdapter 和精簡版 Java 執行階段,因此您不必在本機安裝 Java 或 Docker。執行指令時,spgc 會在背景啟動及停止 PGAdapter。

如要進一步瞭解這些方法,請參閱「啟動 PGAdapter」。

使用 PGAdapter 授權

PGAdapter 會檢查您在啟動 Proxy 時指定的憑證,判斷連線的服務帳戶或其他 Identity and Access Management (IAM) 主體。授予該主體的 IAM 權限會決定允許的資料庫作業。

使用精細的存取控管機制時,請在啟動 PGAdapter 時指定資料庫角色。PGAdapter 在傳送查詢和 DML 陳述式時,會使用精細的存取控管機制,因此需要 IAM spanner.databases.useRoleBasedAccess 權限。如果是 public 以外的資料庫角色,主體也需要 spanner.databaseRoles.use 權限。授予資料庫角色的權限,會決定連結應用程式可執行的作業。如未指定資料庫角色,則會套用授予 IAM 主體的權限。如要執行 DDL 陳述式,主體必須具備 spanner.databases.updateDdl 權限。

詳情請參閱「關於精細的存取控管」和「使用 IAM 控管存取權」。

後續步驟