代管連線集區總覽

本頁說明什麼是受管理連線集區,以及如何搭配 Cloud SQL 執行個體使用。

透過「受管理連線集區」,您可以運用集區功能,為 PostgreSQL 適用的 Cloud SQL 執行個體最佳化資源用量和連線延遲,進而擴充工作負載。代管連線集區會盡可能將伺服器連線動態指派給傳入的要求。這項功能可吸收突然出現的連線尖峰,並重複使用現有的資料庫連線,因此能大幅提升效能,特別是擴充連線時。管理連線集區會連線至集區叢集,而非特定資料庫,因此可縮短連線時間,並為工作負載提供可擴充性。使用的集區數量取決於執行個體的 vCPU 核心數量。

雖然您可以將代管連線集區用於任何交易工作負載,但如果應用程式包含存留時間較短的連線,或是導致連線激增,代管連線集區就能提供最大的輸送量和延遲時間優勢。

如果是長期連線,使用代管連線集區的連線效能可能會略低於直接連線。在這種情況下,當連線數量非常高時,代管連線集區會提供連線擴充功能。不過,對於通常會建立長期連線的應用程式,您可能會改為直接連線至執行個體。

如要進一步瞭解如何啟用受管理連線集區,請參閱「設定受管理連線集區」。

需求條件

如要使用受管理連線集區,執行個體必須符合下列規定:

  • 執行個體必須是 Cloud SQL Enterprise Plus 版本執行個體。
  • 您必須使用直接連線或 Cloud SQL Auth Proxy 連線至執行個體。
  • 您必須使用有效的使用者名稱和密碼連線至執行個體。使用代管連線集區時,系統不支援 IAM 和 IAM 群組使用者。
  • 執行個體必須設定為私人服務存取權、使用公開 IP,或是啟用 Private Service Connect 的新執行個體。
  • 執行個體必須使用新的 Cloud SQL 網路架構
  • 代管連線集區的維護版本號碼至少須為 POSTGRES_$version.R20250302.00_04。詳情請參閱「自助式維護」。

Cloud SQL 執行個體受管理連線集區使用的連接埠

啟用「受管理連線集區」後,Cloud SQL 執行個體用於提供資料庫流量的通訊埠會變更。代管連線集區使用的通訊埠如下:

  • TCP 通訊埠 5432:Postgres 資料庫伺服器用於直接連線。這是使用 psql 用戶端直接連線時使用的預設通訊埠編號。
  • TCP 通訊埠 6432:PgBouncer 伺服器用於直接連線。如要使用這個通訊埠連線,請在使用 psql 用戶端直接連線時指定 psql -p 6432
  • TCP 埠 3307:僅供 PgBouncer 伺服器透過 Cloud SQL Auth Proxy 連線使用。使用 Cloud SQL 驗證 Proxy 連線至 Pgbouncer 時,這個連接埠號碼會透過 Cloud SQL 驗證 Proxy 用戶端設定,且無法變更。

可用的設定選項

代管連線集區提供下列集區選項,您可以使用 pool_mode 參數設定:

  • transaction (預設):在交易層級集區連線。
  • session:在工作階段層級集區連線。

您也可以使用下列設定參數,自訂受管理連線集區

  • max_pool_size:連線集區的大小上限。預設值為 50 個連線。
  • min_pool_size:連線集區的門檻大小。如果伺服器連線數少於 min_pool_size,請在集區中新增更多伺服器連線。預設值為 0 個連線。
  • max_client_connections:執行個體允許的連線數量上限。預設值為 5,000 個連線。
  • client_connection_idle_timeout:用戶端連線在逾時前保持閒置的時間。這個值可以介於 0 至 2,147,483 秒之間,預設值為 0 秒。
  • server_connection_idle_timeout:伺服器連線在逾時前保持閒置狀態的時間。這個值可以介於 0 到 2,147,483 秒之間,預設值為 600 秒。
  • query_wait_timeout:查詢等待逾時的時間。這個值可介於 0 到 2,147,483 秒之間,預設值為 120 秒。
  • max_prepared_statements:在交易集區模式中,通訊協定層級具名預先準備好的陳述式指令數量上限。預設值為 0。
  • ignore_startup_parameters:您要忽略的參數,這些參數預設不會在受管理連線集區的啟動封包中追蹤。
  • server_lifetime:伺服器連線閒置多久後,受管理連線集區就會關閉連線。預設值為 3600 秒。

限制

使用 Cloud SQL Enterprise Plus 版執行個體時,請注意下列使用受管理連線集區的限制:

  • 在現有執行個體上啟用代管連線集區,會導致資料庫重新啟動。
  • 使用 Cloud SQL API 啟用、停用或設定代管連線集區時,instance.update API 不得包含任何其他執行個體設定更新。
  • 只有 Cloud SQL 驗證 Proxy 2.15.2 以上版本才能使用代管連線集區。
  • 如果您使用 Cloud SQL Go 語言連接器,建議您使用 Go 1.24 以上版本。如果您使用 Go 1.23 以下版本,使用代管連線集區時可能會遇到效能限制。
  • 如果您在 transaction 集區模式中使用 Managed Connection Pooling,則不支援下列 SQL 功能:

    • SET/RESET
    • LISTEN
    • WITH HOLD CURSOR
    • PREPARE/DEALLOCATE
    • PRESERVE/DELETE ROW 個臨時資料表
    • LOAD
    • 工作階段層級諮詢鎖定
  • 如果您使用 PostgreSQL 適用的 Cloud SQL 17 版,則系統不支援 sslnegotiation=direct 選項。

後續步驟